com.google.android.exoplayer2.source.dash.manifest

Class DashManifestParser

java.lang.Object

org.xml.sax.helpers.DefaultHandler

com.google.android.exoplayer2.source.dash.manifest.DashManifestParser

All Implemented Interfaces:

ParsingLoadable.Parser<DashManifest>, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public class DashManifestParser
extends DefaultHandler
implements ParsingLoadable.Parser<DashManifest>

A parser of media presentation description files.

Constructor Summary

Constructors

Constructor and Description
DashManifestParser() Equivalent to calling new DashManifestParser(null).
DashManifestParser(String contentId)

Method Summary

Modifier and Type	Method and Description
protected AdaptationSet	buildAdaptationSet(int id, int contentType, List<Representation> representations, List<Descriptor> accessibilityDescriptors, List<Descriptor> supplementalProperties)
protected Format	buildFormat(String id, String containerMimeType, int width, int height, float frameRate, int audioChannels, int audioSamplingRate, int bitrate, String language, int selectionFlags, List<Descriptor> accessibilityDescriptors, String codecs)
protected DashManifest	buildMediaPresentationDescription(long availabilityStartTime, long durationMs, long minBufferTimeMs, boolean dynamic, long minUpdateTimeMs, long timeShiftBufferDepthMs, long suggestedPresentationDelayMs, UtcTimingElement utcTiming, Uri location, List<Period> periods)
protected Period	buildPeriod(String id, long startMs, List<AdaptationSet> adaptationSets)
protected RangedUri	buildRangedUri(String urlText, long rangeStart, long rangeLength)
protected Representation	buildRepresentation(com.google.android.exoplayer2.source.dash.manifest.DashManifestParser.RepresentationInfo representationInfo, String contentId, ArrayList<DrmInitData.SchemeData> extraDrmSchemeDatas, ArrayList<Descriptor> extraInbandEventStreams)
protected SegmentBase.SegmentList	buildSegmentList(RangedUri initialization, long timescale, long presentationTimeOffset, int startNumber, long duration, List<SegmentBase.SegmentTimelineElement> timeline, List<RangedUri> segments)
protected SegmentBase.SegmentTemplate	buildSegmentTemplate(RangedUri initialization, long timescale, long presentationTimeOffset, int startNumber, long duration, List<SegmentBase.SegmentTimelineElement> timeline, UrlTemplate initializationTemplate, UrlTemplate mediaTemplate)
protected SegmentBase.SegmentTimelineElement	buildSegmentTimelineElement(long elapsedTime, long duration)
protected SegmentBase.SingleSegmentBase	buildSingleSegmentBase(RangedUri initialization, long timescale, long presentationTimeOffset, long indexStart, long indexLength)
protected UtcTimingElement	buildUtcTimingElement(String schemeIdUri, String value)
protected int	getContentType(Format format)
DashManifest	parse(Uri uri, InputStream inputStream) Parses an object from a response.
protected AdaptationSet	parseAdaptationSet(XmlPullParser xpp, String baseUrl, SegmentBase segmentBase)
protected void	parseAdaptationSetChild(XmlPullParser xpp) Parses children of AdaptationSet elements not specifically parsed elsewhere.
protected int	parseAudioChannelConfiguration(XmlPullParser xpp)
protected static String	parseBaseUrl(XmlPullParser xpp, String parentBaseUrl)
protected static int	parseCea608AccessibilityChannel(List<Descriptor> accessibilityDescriptors)
protected static int	parseCea708AccessibilityChannel(List<Descriptor> accessibilityDescriptors)
protected DrmInitData.SchemeData	parseContentProtection(XmlPullParser xpp) Parses a ContentProtection element.
protected int	parseContentType(XmlPullParser xpp)
protected static long	parseDateTime(XmlPullParser xpp, String name, long defaultValue)
protected static Descriptor	parseDescriptor(XmlPullParser xpp, String tag) Parses a Descriptor from an element.
protected static long	parseDuration(XmlPullParser xpp, String name, long defaultValue)
protected static float	parseFrameRate(XmlPullParser xpp, float defaultValue)
protected RangedUri	parseInitialization(XmlPullParser xpp)
protected static int	parseInt(XmlPullParser xpp, String name, int defaultValue)
protected static long	parseLong(XmlPullParser xpp, String name, long defaultValue)
protected DashManifest	parseMediaPresentationDescription(XmlPullParser xpp, String baseUrl)
protected Pair<Period,Long>	parsePeriod(XmlPullParser xpp, String baseUrl, long defaultStartMs)
protected RangedUri	parseRangedUrl(XmlPullParser xpp, String urlAttribute, String rangeAttribute)
protected com.google.android.exoplayer2.source.dash.manifest.DashManifestParser.RepresentationInfo	parseRepresentation(XmlPullParser xpp, String baseUrl, String adaptationSetMimeType, String adaptationSetCodecs, int adaptationSetWidth, int adaptationSetHeight, float adaptationSetFrameRate, int adaptationSetAudioChannels, int adaptationSetAudioSamplingRate, String adaptationSetLanguage, int adaptationSetSelectionFlags, List<Descriptor> adaptationSetAccessibilityDescriptors, SegmentBase segmentBase)
protected int	parseRole(XmlPullParser xpp) Parses a Role element.
protected SegmentBase.SingleSegmentBase	parseSegmentBase(XmlPullParser xpp, SegmentBase.SingleSegmentBase parent)
protected SegmentBase.SegmentList	parseSegmentList(XmlPullParser xpp, SegmentBase.SegmentList parent)
protected SegmentBase.SegmentTemplate	parseSegmentTemplate(XmlPullParser xpp, SegmentBase.SegmentTemplate parent)
protected List<SegmentBase.SegmentTimelineElement>	parseSegmentTimeline(XmlPullParser xpp)
protected RangedUri	parseSegmentUrl(XmlPullParser xpp)
protected static String	parseString(XmlPullParser xpp, String name, String defaultValue)
protected UrlTemplate	parseUrlTemplate(XmlPullParser xpp, String name, UrlTemplate defaultValue)
protected UtcTimingElement	parseUtcTiming(XmlPullParser xpp)

Methods inherited from class org.xml.sax.helpers.DefaultHandler

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DashManifestParser

public DashManifestParser()

Equivalent to calling new DashManifestParser(null).

DashManifestParser

public DashManifestParser(String contentId)

Parameters:

contentId - An optional content identifier to include in the parsed manifest.

Method Detail

parse

public DashManifest parse(Uri uri,
                          InputStream inputStream)
                   throws IOException

Description copied from interface: ParsingLoadable.Parser

Parses an object from a response.

Specified by:

parse in interface ParsingLoadable.Parser<DashManifest>

Parameters:

uri - The source Uri of the response, after any redirection.

inputStream - An InputStream from which the response data can be read.

Returns:

The parsed object.

Throws:

ParserException - If an error occurs parsing the data.

IOException - If an error occurs reading data from the stream.

parseMediaPresentationDescription

protected DashManifest parseMediaPresentationDescription(XmlPullParser xpp,
                                                         String baseUrl)
                                                  throws XmlPullParserException,
                                                         IOException

Throws:

XmlPullParserException

IOException

buildMediaPresentationDescription

protected DashManifest buildMediaPresentationDescription(long availabilityStartTime,
                                                         long durationMs,
                                                         long minBufferTimeMs,
                                                         boolean dynamic,
                                                         long minUpdateTimeMs,
                                                         long timeShiftBufferDepthMs,
                                                         long suggestedPresentationDelayMs,
                                                         UtcTimingElement utcTiming,
                                                         Uri location,
                                                         List<Period> periods)

parseUtcTiming

protected UtcTimingElement parseUtcTiming(XmlPullParser xpp)

buildUtcTimingElement

protected UtcTimingElement buildUtcTimingElement(String schemeIdUri,
                                                 String value)

parsePeriod

protected Pair<Period,Long> parsePeriod(XmlPullParser xpp,
                                        String baseUrl,
                                        long defaultStartMs)
                                 throws XmlPullParserException,
                                        IOException

Throws:

XmlPullParserException

IOException

buildPeriod

protected Period buildPeriod(String id,
                             long startMs,
                             List<AdaptationSet> adaptationSets)

parseAdaptationSet

protected AdaptationSet parseAdaptationSet(XmlPullParser xpp,
                                           String baseUrl,
                                           SegmentBase segmentBase)
                                    throws XmlPullParserException,
                                           IOException

Throws:

XmlPullParserException

IOException

buildAdaptationSet

protected AdaptationSet buildAdaptationSet(int id,
                                           int contentType,
                                           List<Representation> representations,
                                           List<Descriptor> accessibilityDescriptors,
                                           List<Descriptor> supplementalProperties)

parseContentType

protected int parseContentType(XmlPullParser xpp)

getContentType

protected int getContentType(Format format)

parseContentProtection

protected DrmInitData.SchemeData parseContentProtection(XmlPullParser xpp)
                                                 throws XmlPullParserException,
                                                        IOException

Parses a ContentProtection element.

Parameters:

xpp - The parser from which to read.

Returns:

DrmInitData.SchemeData parsed from the ContentProtection element, or null if the element is unsupported.

Throws:

XmlPullParserException - If an error occurs parsing the element.

IOException - If an error occurs reading the element.

parseRole

protected int parseRole(XmlPullParser xpp)
                 throws XmlPullParserException,
                        IOException

Parses a Role element.

Parameters:

xpp - The parser from which to read.

Returns:

C.SelectionFlags parsed from the element.

Throws:

XmlPullParserException - If an error occurs parsing the element.

IOException - If an error occurs reading the element.

parseAdaptationSetChild

protected void parseAdaptationSetChild(XmlPullParser xpp)
                                throws XmlPullParserException,
                                       IOException

Parses children of AdaptationSet elements not specifically parsed elsewhere.

Parameters:

xpp - The XmpPullParser from which the AdaptationSet child should be parsed.

Throws:

XmlPullParserException - If an error occurs parsing the element.

IOException - If an error occurs reading the element.

parseRepresentation

protected com.google.android.exoplayer2.source.dash.manifest.DashManifestParser.RepresentationInfo parseRepresentation(XmlPullParser xpp,
                                                                                                                       String baseUrl,
                                                                                                                       String adaptationSetMimeType,
                                                                                                                       String adaptationSetCodecs,
                                                                                                                       int adaptationSetWidth,
                                                                                                                       int adaptationSetHeight,
                                                                                                                       float adaptationSetFrameRate,
                                                                                                                       int adaptationSetAudioChannels,
                                                                                                                       int adaptationSetAudioSamplingRate,
                                                                                                                       String adaptationSetLanguage,
                                                                                                                       int adaptationSetSelectionFlags,
                                                                                                                       List<Descriptor> adaptationSetAccessibilityDescriptors,
                                                                                                                       SegmentBase segmentBase)
                                                                                                                throws XmlPullParserException,
                                                                                                                       IOException

Throws:

XmlPullParserException

IOException

buildFormat

protected Format buildFormat(String id,
                             String containerMimeType,
                             int width,
                             int height,
                             float frameRate,
                             int audioChannels,
                             int audioSamplingRate,
                             int bitrate,
                             String language,
                             int selectionFlags,
                             List<Descriptor> accessibilityDescriptors,
                             String codecs)

buildRepresentation

protected Representation buildRepresentation(com.google.android.exoplayer2.source.dash.manifest.DashManifestParser.RepresentationInfo representationInfo,
                                             String contentId,
                                             ArrayList<DrmInitData.SchemeData> extraDrmSchemeDatas,
                                             ArrayList<Descriptor> extraInbandEventStreams)

parseSegmentBase

protected SegmentBase.SingleSegmentBase parseSegmentBase(XmlPullParser xpp,
                                                         SegmentBase.SingleSegmentBase parent)
                                                  throws XmlPullParserException,
                                                         IOException

Throws:

XmlPullParserException

IOException

buildSingleSegmentBase

protected SegmentBase.SingleSegmentBase buildSingleSegmentBase(RangedUri initialization,
                                                               long timescale,
                                                               long presentationTimeOffset,
                                                               long indexStart,
                                                               long indexLength)

parseSegmentList

protected SegmentBase.SegmentList parseSegmentList(XmlPullParser xpp,
                                                   SegmentBase.SegmentList parent)
                                            throws XmlPullParserException,
                                                   IOException

Throws:

XmlPullParserException

IOException

buildSegmentList

protected SegmentBase.SegmentList buildSegmentList(RangedUri initialization,
                                                   long timescale,
                                                   long presentationTimeOffset,
                                                   int startNumber,
                                                   long duration,
                                                   List<SegmentBase.SegmentTimelineElement> timeline,
                                                   List<RangedUri> segments)

parseSegmentTemplate

protected SegmentBase.SegmentTemplate parseSegmentTemplate(XmlPullParser xpp,
                                                           SegmentBase.SegmentTemplate parent)
                                                    throws XmlPullParserException,
                                                           IOException

Throws:

XmlPullParserException

IOException

buildSegmentTemplate

protected SegmentBase.SegmentTemplate buildSegmentTemplate(RangedUri initialization,
                                                           long timescale,
                                                           long presentationTimeOffset,
                                                           int startNumber,
                                                           long duration,
                                                           List<SegmentBase.SegmentTimelineElement> timeline,
                                                           UrlTemplate initializationTemplate,
                                                           UrlTemplate mediaTemplate)

parseSegmentTimeline

protected List<SegmentBase.SegmentTimelineElement> parseSegmentTimeline(XmlPullParser xpp)
                                                                 throws XmlPullParserException,
                                                                        IOException

Throws:

XmlPullParserException

IOException

buildSegmentTimelineElement

protected SegmentBase.SegmentTimelineElement buildSegmentTimelineElement(long elapsedTime,
                                                                         long duration)

parseUrlTemplate

protected UrlTemplate parseUrlTemplate(XmlPullParser xpp,
                                       String name,
                                       UrlTemplate defaultValue)

parseInitialization

protected RangedUri parseInitialization(XmlPullParser xpp)

parseSegmentUrl

protected RangedUri parseSegmentUrl(XmlPullParser xpp)

parseRangedUrl

protected RangedUri parseRangedUrl(XmlPullParser xpp,
                                   String urlAttribute,
                                   String rangeAttribute)

buildRangedUri

protected RangedUri buildRangedUri(String urlText,
                                   long rangeStart,
                                   long rangeLength)

parseAudioChannelConfiguration

protected int parseAudioChannelConfiguration(XmlPullParser xpp)
                                      throws XmlPullParserException,
                                             IOException

Throws:

XmlPullParserException

IOException

parseDescriptor

protected static Descriptor parseDescriptor(XmlPullParser xpp,
                                            String tag)
                                     throws XmlPullParserException,
                                            IOException

Parses a Descriptor from an element.

Parameters:

xpp - The parser from which to read.

tag - The tag of the element being parsed.

Returns:

The parsed Descriptor.

Throws:

XmlPullParserException - If an error occurs parsing the element.

IOException - If an error occurs reading the element.

parseCea608AccessibilityChannel

protected static int parseCea608AccessibilityChannel(List<Descriptor> accessibilityDescriptors)

parseCea708AccessibilityChannel

protected static int parseCea708AccessibilityChannel(List<Descriptor> accessibilityDescriptors)

parseFrameRate

protected static float parseFrameRate(XmlPullParser xpp,
                                      float defaultValue)

parseDuration

protected static long parseDuration(XmlPullParser xpp,
                                    String name,
                                    long defaultValue)

parseDateTime

protected static long parseDateTime(XmlPullParser xpp,
                                    String name,
                                    long defaultValue)
                             throws ParserException

Throws:

ParserException

parseBaseUrl

protected static String parseBaseUrl(XmlPullParser xpp,
                                     String parentBaseUrl)
                              throws XmlPullParserException,
                                     IOException

Throws:

XmlPullParserException

IOException

parseInt

protected static int parseInt(XmlPullParser xpp,
                              String name,
                              int defaultValue)

parseLong

protected static long parseLong(XmlPullParser xpp,
                                String name,
                                long defaultValue)

parseString

protected static String parseString(XmlPullParser xpp,
                                    String name,
                                    String defaultValue)