MediaPresentationDescriptionParser (ExoPlayer library)

java.lang.Object
- org.xml.sax.helpers.DefaultHandler
- - com.google.android.exoplayer.dash.mpd.MediaPresentationDescriptionParser

All Implemented Interfaces:

UriLoadable.Parser<MediaPresentationDescription>, ContentHandler, DTDHandler, EntityResolver, ErrorHandler
```
public class MediaPresentationDescriptionParser
extends DefaultHandler
implements UriLoadable.Parser<MediaPresentationDescription>
```
A parser of media presentation description files.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`MediaPresentationDescriptionParser.ContentProtectionsBuilder` Builds a list of `ContentProtection` elements for an `AdaptationSet`.

Constructor Summary

Constructors
Constructor and Description
`MediaPresentationDescriptionParser()` Equivalent to calling `new MediaPresentationDescriptionParser(null)`.
`MediaPresentationDescriptionParser(String contentId)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected AdaptationSet`	`buildAdaptationSet(int id, int contentType, List<Representation> representations, List<ContentProtection> contentProtections)`
`protected ContentProtection`	`buildContentProtection(String schemeIdUri, UUID uuid, DrmInitData.SchemeInitData data)`
`protected Format`	`buildFormat(String id, String mimeType, int width, int height, float frameRate, int audioChannels, int audioSamplingRate, int bandwidth, String language, String codecs)`
`protected MediaPresentationDescription`	`buildMediaPresentationDescription(long availabilityStartTime, long durationMs, long minBufferTimeMs, boolean dynamic, long minUpdateTimeMs, long timeShiftBufferDepthMs, UtcTimingElement utcTiming, String 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(String contentId, int revisionId, Format format, SegmentBase segmentBase, String baseUrl)`
`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(Representation representation)`
`MediaPresentationDescription`	`parse(String connectionUrl, 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 ContentProtection`	`parseContentProtection(XmlPullParser xpp)` Parses a `ContentProtection` element.
`protected int`	`parseContentType(XmlPullParser xpp)`
`protected static long`	`parseDateTime(XmlPullParser xpp, String name, long defaultValue)`
`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)`
`protected static int`	`parseInt(XmlPullParser xpp, String name, int defaultValue)`
`protected static long`	`parseLong(XmlPullParser xpp, String name)`
`protected static long`	`parseLong(XmlPullParser xpp, String name, long defaultValue)`
`protected MediaPresentationDescription`	`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 Representation`	`parseRepresentation(XmlPullParser xpp, String baseUrl, String adaptationSetMimeType, String adaptationSetCodecs, int adaptationSetWidth, int adaptationSetHeight, float adaptationSetFrameRate, int adaptationSetAudioChannels, int adaptationSetAudioSamplingRate, String adaptationSetLanguage, SegmentBase segmentBase, MediaPresentationDescriptionParser.ContentProtectionsBuilder contentProtectionsBuilder)`
`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
- MediaPresentationDescriptionParser
```
public MediaPresentationDescriptionParser()
```
  Equivalent to calling new MediaPresentationDescriptionParser(null).
- MediaPresentationDescriptionParser
```
public MediaPresentationDescriptionParser(String contentId)
```
  Parameters:
  
  contentId - An optional content identifier to include in the parsed manifest.

Method Detail

parse
```
public MediaPresentationDescription parse(String connectionUrl,
                                          InputStream inputStream)
                                   throws IOException,
                                          ParserException
```
Description copied from interface: UriLoadable.Parser

Parses an object from a response.

Specified by:

parse in interface UriLoadable.Parser<MediaPresentationDescription>

Parameters:

connectionUrl - The source 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 MediaPresentationDescription parseMediaPresentationDescription(XmlPullParser xpp,
                                                                         String baseUrl)
                                                                  throws XmlPullParserException,
                                                                         IOException,
                                                                         ParseException

Throws:: XmlPullParserException; IOException; ParseException

buildMediaPresentationDescription

protected MediaPresentationDescription buildMediaPresentationDescription(long availabilityStartTime,
                                                                         long durationMs,
                                                                         long minBufferTimeMs,
                                                                         boolean dynamic,
                                                                         long minUpdateTimeMs,
                                                                         long timeShiftBufferDepthMs,
                                                                         UtcTimingElement utcTiming,
                                                                         String 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<ContentProtection> contentProtections)

parseContentType

protected int parseContentType(XmlPullParser xpp)

getContentType

protected int getContentType(Representation representation)

parseContentProtection

protected ContentProtection parseContentProtection(XmlPullParser xpp)
                                            throws XmlPullParserException,
                                                   IOException

Parses a ContentProtection element.

Returns:: The parsed 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.

buildContentProtection

protected ContentProtection buildContentProtection(String schemeIdUri,
                                                   UUID uuid,
                                                   DrmInitData.SchemeInitData data)

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 Representation parseRepresentation(XmlPullParser xpp,
                                             String baseUrl,
                                             String adaptationSetMimeType,
                                             String adaptationSetCodecs,
                                             int adaptationSetWidth,
                                             int adaptationSetHeight,
                                             float adaptationSetFrameRate,
                                             int adaptationSetAudioChannels,
                                             int adaptationSetAudioSamplingRate,
                                             String adaptationSetLanguage,
                                             SegmentBase segmentBase,
                                             MediaPresentationDescriptionParser.ContentProtectionsBuilder contentProtectionsBuilder)
                                      throws XmlPullParserException,
                                             IOException

Throws:: XmlPullParserException; IOException

buildFormat

protected Format buildFormat(String id,
                             String mimeType,
                             int width,
                             int height,
                             float frameRate,
                             int audioChannels,
                             int audioSamplingRate,
                             int bandwidth,
                             String language,
                             String codecs)

buildRepresentation

protected Representation buildRepresentation(String contentId,
                                             int revisionId,
                                             Format format,
                                             SegmentBase segmentBase,
                                             String baseUrl)

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

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 ParseException

Throws:: ParseException

parseBaseUrl

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

Throws:: XmlPullParserException; IOException

parseInt

protected static int parseInt(XmlPullParser xpp,
                              String name)

parseInt

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

parseLong

protected static long parseLong(XmlPullParser xpp,
                                String name)

parseLong

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

parseString

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

Class MediaPresentationDescriptionParser

Nested Class Summary

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Constructor Detail

MediaPresentationDescriptionParser

MediaPresentationDescriptionParser

Method Detail

parse

parseMediaPresentationDescription

buildMediaPresentationDescription

parseUtcTiming

buildUtcTimingElement

parsePeriod

buildPeriod

parseAdaptationSet

buildAdaptationSet

parseContentType

getContentType

parseContentProtection

buildContentProtection

parseAdaptationSetChild

parseRepresentation

buildFormat

buildRepresentation

parseSegmentBase

buildSingleSegmentBase

parseSegmentList

buildSegmentList

parseSegmentTemplate

buildSegmentTemplate

parseSegmentTimeline

buildSegmentTimelineElement

parseUrlTemplate

parseInitialization

parseSegmentUrl

parseRangedUrl

buildRangedUri

parseAudioChannelConfiguration

parseFrameRate

parseDuration

parseDateTime

parseBaseUrl

parseInt

parseInt

parseLong

parseLong

parseString