DashManifestParser

Artifact: androidx.media3:media3-exoplayer-dash

View Source

---

Kotlin |Java

@UnstableApi
public class DashManifestParser extends DefaultHandler implements ParsingLoadable.Parser

java.lang.Object
↳	org.xml.sax.helpers.DefaultHandler
	↳	androidx.media3.exoplayer.dash.manifest.DashManifestParser

---

A parser of media presentation description files.

Summary

Nested types
protected final class DashManifestParser.RepresentationInfo A parsed Representation element.

Public constructors
DashManifestParser()

Public methods
static void	maybeSkipTag(XmlPullParser xpp) If the provided XmlPullParser is currently positioned at the start of a tag, skips forward to the end of that tag.
DashManifest	parse(Uri uri, InputStream inputStream) Parses an object from a response.

Protected methods
AdaptationSet	buildAdaptationSet(     long id,     @C.TrackType int contentType,     List<Representation> representations,     List<Descriptor> accessibilityDescriptors,     List<Descriptor> essentialProperties,     List<Descriptor> supplementalProperties )
EventMessage	buildEvent(     String schemeIdUri,     String value,     long id,     long durationMs,     byte[] messageData )
EventStream	buildEventStream(     String schemeIdUri,     String value,     long timescale,     long[] presentationTimesUs,     EventMessage[] events )
Format	buildFormat(     @Nullable String id,     @Nullable String containerMimeType,     int width,     int height,     float frameRate,     int audioChannels,     int audioSamplingRate,     int bitrate,     @Nullable String language,     List<Descriptor> roleDescriptors,     List<Descriptor> accessibilityDescriptors,     @Nullable String codecs,     @Nullable String supplementalCodecs,     @Nullable String supplementalProfiles,     List<Descriptor> essentialProperties,     List<Descriptor> supplementalProperties )
DashManifest	buildMediaPresentationDescription(     long availabilityStartTime,     long durationMs,     long minBufferTimeMs,     boolean dynamic,     long minUpdateTimeMs,     long timeShiftBufferDepthMs,     long suggestedPresentationDelayMs,     long publishTimeMs,     @Nullable ProgramInformation programInformation,     @Nullable UtcTimingElement utcTiming,     @Nullable ServiceDescriptionElement serviceDescription,     @Nullable Uri location,     List<Period> periods )
Period	buildPeriod(     @Nullable String id,     long startMs,     List<AdaptationSet> adaptationSets,     List<EventStream> eventStreams,     @Nullable Descriptor assetIdentifier )
RangedUri	buildRangedUri(String urlText, long rangeStart, long rangeLength)
Representation	buildRepresentation(     DashManifestParser.RepresentationInfo representationInfo,     @Nullable String label,     List<Label> labels,     @Nullable String extraDrmSchemeType,     ArrayList<DrmInitData.SchemeData> extraDrmSchemeDatas,     ArrayList<Descriptor> extraInbandEventStreams )
SegmentBase.SegmentList	buildSegmentList(     RangedUri initialization,     long timescale,     long presentationTimeOffset,     long startNumber,     long duration,     @Nullable List<SegmentBase.SegmentTimelineElement> timeline,     long availabilityTimeOffsetUs,     @Nullable List<RangedUri> segments,     long timeShiftBufferDepthMs,     long periodStartUnixTimeMs )
SegmentBase.SegmentTemplate	buildSegmentTemplate(     RangedUri initialization,     long timescale,     long presentationTimeOffset,     long startNumber,     long endNumber,     long duration,     List<SegmentBase.SegmentTimelineElement> timeline,     long availabilityTimeOffsetUs,     @Nullable UrlTemplate initializationTemplate,     @Nullable UrlTemplate mediaTemplate,     long timeShiftBufferDepthMs,     long periodStartUnixTimeMs )
SegmentBase.SegmentTimelineElement	buildSegmentTimelineElement(long startTime, long duration)
SegmentBase.SingleSegmentBase	buildSingleSegmentBase(     RangedUri initialization,     long timescale,     long presentationTimeOffset,     long indexStart,     long indexLength )
UtcTimingElement	buildUtcTimingElement(String schemeIdUri, String value)
AdaptationSet	parseAdaptationSet(     XmlPullParser xpp,     List<BaseUrl> parentBaseUrls,     @Nullable SegmentBase segmentBase,     long periodDurationMs,     long baseUrlAvailabilityTimeOffsetUs,     long segmentBaseAvailabilityTimeOffsetUs,     long periodStartUnixTimeMs,     long timeShiftBufferDepthMs,     boolean dvbProfileDeclared )
void	parseAdaptationSetChild(XmlPullParser xpp) Parses a child of an AdaptationSet element.
int	parseAudioChannelConfiguration(XmlPullParser xpp, String codecs)
long	parseAvailabilityTimeOffsetUs(     XmlPullParser xpp,     long parentAvailabilityTimeOffsetUs ) Parses the availabilityTimeOffset value and returns the parsed value or the parent value if it doesn't exist.
List<BaseUrl>	parseBaseUrl(     XmlPullParser xpp,     List<BaseUrl> parentBaseUrls,     boolean dvbProfileDeclared ) Parses a BaseURL element.
static int	parseCea608AccessibilityChannel(     List<Descriptor> accessibilityDescriptors )
static int	parseCea708AccessibilityChannel(     List<Descriptor> accessibilityDescriptors )
Pair<@NullableType String, @NullableType DrmInitData.SchemeData>	parseContentProtection(XmlPullParser xpp) Parses a ContentProtection element.
int	@C.TrackType parseContentType(XmlPullParser xpp)
static long	parseDateTime(XmlPullParser xpp, String name, long defaultValue)
static Descriptor	parseDescriptor(XmlPullParser xpp, String tag) Parses a Descriptor from an element.
static int	parseDolbyAC4ChannelConfiguration(XmlPullParser xpp, String codecs) Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dolby.com,2015:dash:audio_channel_configuration:2015" as defined by table A.27 in ETSI TS 103 190-2 v1.2.1.
static int	parseDolbyChannelConfiguration(XmlPullParser xpp) Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dolby.com,2014:dash:audio_channel_configuration:2011" as defined by table E.5 in ETSI TS 102 366, or by the legacy schemeIdUri "urn:dolby:dash:audio_channel_configuration:2011".
static int	parseDtsChannelConfiguration(XmlPullParser xpp) Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dts.com,2014:dash:audio_channel_configuration:2012" as defined by Annex G (3.2) in ETSI TS 102 114 V1.6.1, or by the legacy schemeIdUri "urn:dts:dash:audio_channel_configuration:2012".
static int	parseDtsxChannelConfiguration(XmlPullParser xpp) Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dts.com,2018:uhd:audio_channel_configuration" as defined by table B-5 in ETSI TS 103 491 v1.2.1.
static long	parseDuration(XmlPullParser xpp, String name, long defaultValue)
static String	parseEac3SupplementalProperties(     List<Descriptor> supplementalProperties )
Pair<Long, EventMessage>	parseEvent(     XmlPullParser xpp,     String schemeIdUri,     String value,     long timescale,     long presentationTimeOffset,     ByteArrayOutputStream scratchOutputStream ) Parses a single Event node in the manifest.
byte[]	parseEventObject(     XmlPullParser xpp,     ByteArrayOutputStream scratchOutputStream ) Parses an event object.
EventStream	parseEventStream(XmlPullParser xpp) Parses a single EventStream node in the manifest.
static float	parseFloat(XmlPullParser xpp, String name, float defaultValue)
static float	parseFrameRate(XmlPullParser xpp, float defaultValue)
RangedUri	parseInitialization(XmlPullParser xpp)
static int	parseInt(XmlPullParser xpp, String name, int defaultValue)
Label	parseLabel(XmlPullParser xpp) Parses a Label element.
static long	parseLastSegmentNumberSupplementalProperty(     List<Descriptor> supplementalProperties )
static long	parseLong(XmlPullParser xpp, String name, long defaultValue)
DashManifest	parseMediaPresentationDescription(     XmlPullParser xpp,     Uri documentBaseUri )
static int	parseMpegChannelConfiguration(XmlPullParser xpp) Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "urn:mpeg:mpegB:cicp:ChannelConfiguration", as defined by ISO 23091-3:2018 clause 6.2.
Pair<Period, Long>	parsePeriod(     XmlPullParser xpp,     List<BaseUrl> parentBaseUrls,     long defaultStartMs,     long baseUrlAvailabilityTimeOffsetUs,     long availabilityStartTimeMs,     long timeShiftBufferDepthMs,     boolean dvbProfileDeclared )
String[]	parseProfiles(     XmlPullParser xpp,     String attributeName,     String[] defaultValue )
ProgramInformation	parseProgramInformation(XmlPullParser xpp)
RangedUri	parseRangedUrl(     XmlPullParser xpp,     String urlAttribute,     String rangeAttribute )
DashManifestParser.RepresentationInfo	parseRepresentation(     XmlPullParser xpp,     List<BaseUrl> parentBaseUrls,     @Nullable String adaptationSetMimeType,     @Nullable String adaptationSetCodecs,     @Nullable String adaptationSetSupplementalCodecs,     @Nullable String adaptationSetSupplementalProfiles,     int adaptationSetWidth,     int adaptationSetHeight,     float adaptationSetFrameRate,     int adaptationSetAudioChannels,     int adaptationSetAudioSamplingRate,     @Nullable String adaptationSetLanguage,     List<Descriptor> adaptationSetRoleDescriptors,     List<Descriptor> adaptationSetAccessibilityDescriptors,     List<Descriptor> adaptationSetEssentialProperties,     List<Descriptor> adaptationSetSupplementalProperties,     @Nullable SegmentBase segmentBase,     long periodStartUnixTimeMs,     long periodDurationMs,     long baseUrlAvailabilityTimeOffsetUs,     long segmentBaseAvailabilityTimeOffsetUs,     long timeShiftBufferDepthMs,     boolean dvbProfileDeclared )
int	@C.RoleFlags parseRoleFlagsFromAccessibilityDescriptors(     List<Descriptor> accessibilityDescriptors )
int	@C.RoleFlags parseRoleFlagsFromDashRoleScheme(@Nullable String value)
int	@C.RoleFlags parseRoleFlagsFromProperties(     List<Descriptor> accessibilityDescriptors )
int	@C.RoleFlags parseRoleFlagsFromRoleDescriptors(List<Descriptor> roleDescriptors)
SegmentBase.SingleSegmentBase	parseSegmentBase(     XmlPullParser xpp,     @Nullable SegmentBase.SingleSegmentBase parent )
SegmentBase.SegmentList	parseSegmentList(     XmlPullParser xpp,     @Nullable SegmentBase.SegmentList parent,     long periodStartUnixTimeMs,     long periodDurationMs,     long baseUrlAvailabilityTimeOffsetUs,     long segmentBaseAvailabilityTimeOffsetUs,     long timeShiftBufferDepthMs )
SegmentBase.SegmentTemplate	parseSegmentTemplate(     XmlPullParser xpp,     @Nullable SegmentBase.SegmentTemplate parent,     List<Descriptor> adaptationSetSupplementalProperties,     long periodStartUnixTimeMs,     long periodDurationMs,     long baseUrlAvailabilityTimeOffsetUs,     long segmentBaseAvailabilityTimeOffsetUs,     long timeShiftBufferDepthMs )
List<SegmentBase.SegmentTimelineElement>	parseSegmentTimeline(     XmlPullParser xpp,     long timescale,     long periodDurationMs )
RangedUri	parseSegmentUrl(XmlPullParser xpp)
int	@C.SelectionFlags parseSelectionFlagsFromDashRoleScheme(@Nullable String value)
int	@C.SelectionFlags parseSelectionFlagsFromRoleDescriptors(     List<Descriptor> roleDescriptors )
ServiceDescriptionElement	parseServiceDescription(XmlPullParser xpp)
static String	parseString(XmlPullParser xpp, String name, String defaultValue)
static String	parseText(XmlPullParser xpp, String label)
@Nullable Pair<Integer, Integer>	parseTileCountFromProperties(List<Descriptor> essentialProperties) Parses given descriptors for thumbnail tile information.
int	@C.RoleFlags parseTvaAudioPurposeCsValue(@Nullable String value)
@Nullable UrlTemplate	parseUrlTemplate(     XmlPullParser xpp,     String name,     @Nullable UrlTemplate defaultValue )
UtcTimingElement	parseUtcTiming(XmlPullParser xpp)

Inherited methods

From org.xml.sax.helpers.DefaultHandler void characters(char[] ch, int start, int length) void endDocument() void endElement(String uri, String localName, String qName) void endPrefixMapping(String prefix) void error(SAXParseException e) void fatalError(SAXParseException e) void ignorableWhitespace(char[] ch, int start, int length) void notationDecl(String name, String publicId, String systemId) void processingInstruction(String target, String data) InputSource resolveEntity(String publicId, String systemId) void setDocumentLocator(Locator locator) void skippedEntity(String name) void startDocument() void startElement(     String uri,     String localName,     String qName,     Attributes attributes ) void startPrefixMapping(String prefix, String uri) void unparsedEntityDecl(     String name,     String publicId,     String systemId,     String notationName ) void warning(SAXParseException e)

Public constructors

DashManifestParser

public DashManifestParser()

Public methods

maybeSkipTag

public static void maybeSkipTag(XmlPullParser xpp)

If the provided XmlPullParser is currently positioned at the start of a tag, skips forward to the end of that tag.

Parameters
XmlPullParser xpp	The XmlPullParser.

Throws
org.xmlpull.v1.XmlPullParserException	If an error occurs parsing the stream.
java.io.IOException	If an error occurs reading the stream.

parse

public DashManifest parse(Uri uri, InputStream inputStream)

Parses an object from a response.

Parameters
Uri uri	The source Uri of the response, after any redirection.
InputStream inputStream	An InputStream from which the response data can be read.

Returns
DashManifest	The parsed object.

Throws
androidx.media3.common.ParserException	If an error occurs parsing the data.
java.io.IOException	If an error occurs reading data from the stream.

Protected methods

buildAdaptationSet

protected AdaptationSet buildAdaptationSet(
    long id,
    @C.TrackType int contentType,
    List<Representation> representations,
    List<Descriptor> accessibilityDescriptors,
    List<Descriptor> essentialProperties,
    List<Descriptor> supplementalProperties
)

buildEvent

protected EventMessage buildEvent(
    String schemeIdUri,
    String value,
    long id,
    long durationMs,
    byte[] messageData
)

buildEventStream

protected EventStream buildEventStream(
    String schemeIdUri,
    String value,
    long timescale,
    long[] presentationTimesUs,
    EventMessage[] events
)

buildFormat

protected Format buildFormat(
    @Nullable String id,
    @Nullable String containerMimeType,
    int width,
    int height,
    float frameRate,
    int audioChannels,
    int audioSamplingRate,
    int bitrate,
    @Nullable String language,
    List<Descriptor> roleDescriptors,
    List<Descriptor> accessibilityDescriptors,
    @Nullable String codecs,
    @Nullable String supplementalCodecs,
    @Nullable String supplementalProfiles,
    List<Descriptor> essentialProperties,
    List<Descriptor> supplementalProperties
)

buildMediaPresentationDescription

protected DashManifest buildMediaPresentationDescription(
    long availabilityStartTime,
    long durationMs,
    long minBufferTimeMs,
    boolean dynamic,
    long minUpdateTimeMs,
    long timeShiftBufferDepthMs,
    long suggestedPresentationDelayMs,
    long publishTimeMs,
    @Nullable ProgramInformation programInformation,
    @Nullable UtcTimingElement utcTiming,
    @Nullable ServiceDescriptionElement serviceDescription,
    @Nullable Uri location,
    List<Period> periods
)

buildPeriod

protected Period buildPeriod(
    @Nullable String id,
    long startMs,
    List<AdaptationSet> adaptationSets,
    List<EventStream> eventStreams,
    @Nullable Descriptor assetIdentifier
)

buildRangedUri

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

buildRepresentation

protected Representation buildRepresentation(
    DashManifestParser.RepresentationInfo representationInfo,
    @Nullable String label,
    List<Label> labels,
    @Nullable String extraDrmSchemeType,
    ArrayList<DrmInitData.SchemeData> extraDrmSchemeDatas,
    ArrayList<Descriptor> extraInbandEventStreams
)

buildSegmentList

protected SegmentBase.SegmentList buildSegmentList(
    RangedUri initialization,
    long timescale,
    long presentationTimeOffset,
    long startNumber,
    long duration,
    @Nullable List<SegmentBase.SegmentTimelineElement> timeline,
    long availabilityTimeOffsetUs,
    @Nullable List<RangedUri> segments,
    long timeShiftBufferDepthMs,
    long periodStartUnixTimeMs
)

buildSegmentTemplate

protected SegmentBase.SegmentTemplate buildSegmentTemplate(
    RangedUri initialization,
    long timescale,
    long presentationTimeOffset,
    long startNumber,
    long endNumber,
    long duration,
    List<SegmentBase.SegmentTimelineElement> timeline,
    long availabilityTimeOffsetUs,
    @Nullable UrlTemplate initializationTemplate,
    @Nullable UrlTemplate mediaTemplate,
    long timeShiftBufferDepthMs,
    long periodStartUnixTimeMs
)

buildSegmentTimelineElement

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

buildSingleSegmentBase

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

buildUtcTimingElement

protected UtcTimingElement buildUtcTimingElement(String schemeIdUri, String value)

parseAdaptationSet

protected AdaptationSet parseAdaptationSet(
    XmlPullParser xpp,
    List<BaseUrl> parentBaseUrls,
    @Nullable SegmentBase segmentBase,
    long periodDurationMs,
    long baseUrlAvailabilityTimeOffsetUs,
    long segmentBaseAvailabilityTimeOffsetUs,
    long periodStartUnixTimeMs,
    long timeShiftBufferDepthMs,
    boolean dvbProfileDeclared
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseAdaptationSetChild

protected void parseAdaptationSetChild(XmlPullParser xpp)

Parses a child of an AdaptationSet element.

Called for child elements that are not specifically parsed elsewhere.

Parameters
XmlPullParser xpp	The XmlPullParser from which the child should be parsed.

Throws
org.xmlpull.v1.XmlPullParserException	If an error occurs parsing the element.
java.io.IOException	If an error occurs reading the element.

parseAudioChannelConfiguration

protected int parseAudioChannelConfiguration(XmlPullParser xpp, String codecs)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseAvailabilityTimeOffsetUs

protected long parseAvailabilityTimeOffsetUs(
    XmlPullParser xpp,
    long parentAvailabilityTimeOffsetUs
)

Parses the availabilityTimeOffset value and returns the parsed value or the parent value if it doesn't exist.

Parameters
XmlPullParser xpp	The parser from which to read.
long parentAvailabilityTimeOffsetUs	The availability time offset of a parent element in microseconds.

Returns
long	The parsed availabilityTimeOffset in microseconds.

parseBaseUrl

protected List<BaseUrl> parseBaseUrl(
    XmlPullParser xpp,
    List<BaseUrl> parentBaseUrls,
    boolean dvbProfileDeclared
)

Parses a BaseURL element.

Parameters
XmlPullParser xpp	The parser from which to read.
List<BaseUrl> parentBaseUrls	The parent base URLs for resolving the parsed URLs.
boolean dvbProfileDeclared	Whether the dvb profile is declared.

Returns
List<BaseUrl>	The list of parsed and resolved URLs.

Throws
org.xmlpull.v1.XmlPullParserException	If an error occurs parsing the element.
java.io.IOException	If an error occurs reading the element.

parseCea608AccessibilityChannel

protected static int parseCea608AccessibilityChannel(
    List<Descriptor> accessibilityDescriptors
)

parseCea708AccessibilityChannel

protected static int parseCea708AccessibilityChannel(
    List<Descriptor> accessibilityDescriptors
)

parseContentProtection

protected Pair<@NullableType String, @NullableType DrmInitData.SchemeData> parseContentProtection(XmlPullParser xpp)

Parses a ContentProtection element.

Parameters
XmlPullParser xpp	The parser from which to read.

Returns
Pair<@NullableType String, @NullableType DrmInitData.SchemeData>	The scheme type and/or SchemeData parsed from the ContentProtection element. Either or both may be null, depending on the ContentProtection element being parsed.

Throws
org.xmlpull.v1.XmlPullParserException	If an error occurs parsing the element.
java.io.IOException	If an error occurs reading the element.

parseContentType

@C.TrackType
protected int parseContentType(XmlPullParser xpp)

parseDateTime

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

Throws
androidx.media3.common.ParserException

parseDescriptor

protected static Descriptor parseDescriptor(XmlPullParser xpp, String tag)

Parses a Descriptor from an element.

Parameters
XmlPullParser xpp	The parser from which to read.
String tag	The tag of the element being parsed.

Returns
Descriptor	The parsed Descriptor.

Throws
org.xmlpull.v1.XmlPullParserException	If an error occurs parsing the element.
java.io.IOException	If an error occurs reading the element.

parseDolbyAC4ChannelConfiguration

protected static int parseDolbyAC4ChannelConfiguration(XmlPullParser xpp, String codecs)

Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dolby.com,2015:dash:audio_channel_configuration:2015" as defined by table A.27 in ETSI TS 103 190-2 v1.2.1.

Parameters
XmlPullParser xpp	The parser from which to read.
String codecs	The codecs string from the current element being parsed.

Returns
int	The parsed number of channels, or NO_VALUE if the channel count could not be parsed.

parseDolbyChannelConfiguration

protected static int parseDolbyChannelConfiguration(XmlPullParser xpp)

Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dolby.com,2014:dash:audio_channel_configuration:2011" as defined by table E.5 in ETSI TS 102 366, or by the legacy schemeIdUri "urn:dolby:dash:audio_channel_configuration:2011".

Parameters
XmlPullParser xpp	The parser from which to read.

Returns
int	The parsed number of channels, or NO_VALUE if the channel count could not be parsed.

parseDtsChannelConfiguration

protected static int parseDtsChannelConfiguration(XmlPullParser xpp)

Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dts.com,2014:dash:audio_channel_configuration:2012" as defined by Annex G (3.2) in ETSI TS 102 114 V1.6.1, or by the legacy schemeIdUri "urn:dts:dash:audio_channel_configuration:2012".

Parameters
XmlPullParser xpp	The parser from which to read.

Returns
int	The parsed number of channels, or NO_VALUE if the channel count could not be parsed.

parseDtsxChannelConfiguration

protected static int parseDtsxChannelConfiguration(XmlPullParser xpp)

Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "tag:dts.com,2018:uhd:audio_channel_configuration" as defined by table B-5 in ETSI TS 103 491 v1.2.1.

Parameters
XmlPullParser xpp	The parser from which to read.

Returns
int	The parsed number of channels, or NO_VALUE if the channel count could not be parsed.

parseDuration

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

parseEac3SupplementalProperties

protected static String parseEac3SupplementalProperties(
    List<Descriptor> supplementalProperties
)

parseEvent

protected Pair<Long, EventMessage> parseEvent(
    XmlPullParser xpp,
    String schemeIdUri,
    String value,
    long timescale,
    long presentationTimeOffset,
    ByteArrayOutputStream scratchOutputStream
)

Parses a single Event node in the manifest.

Parameters
XmlPullParser xpp	The current xml parser.
String schemeIdUri	The schemeIdUri of the parent EventStream.
String value	The schemeIdUri of the parent EventStream.
long timescale	The timescale of the parent EventStream.
long presentationTimeOffset	The unscaled presentation time offset of the parent EventStream.
ByteArrayOutputStream scratchOutputStream	A ByteArrayOutputStream that is used when parsing event objects.

Returns
Pair<Long, EventMessage>	A pair containing the node's presentation timestamp in microseconds and the parsed EventMessage.

Throws
org.xmlpull.v1.XmlPullParserException	If there is any error parsing this node.
java.io.IOException	If there is any error reading from the underlying input stream.

parseEventObject

protected byte[] parseEventObject(
    XmlPullParser xpp,
    ByteArrayOutputStream scratchOutputStream
)

Parses an event object.

Parameters
XmlPullParser xpp	The current xml parser.
ByteArrayOutputStream scratchOutputStream	A ByteArrayOutputStream that's used when parsing the object.

Returns
byte[]	The serialized byte array.

Throws
org.xmlpull.v1.XmlPullParserException	If there is any error parsing this node.
java.io.IOException	If there is any error reading from the underlying input stream.

parseEventStream

protected EventStream parseEventStream(XmlPullParser xpp)

Parses a single EventStream node in the manifest.

Parameters
XmlPullParser xpp	The current xml parser.

Returns
EventStream	The EventStream parsed from this EventStream node.

Throws
org.xmlpull.v1.XmlPullParserException	If there is any error parsing this node.
java.io.IOException	If there is any error reading from the underlying input stream.

parseFloat

protected static float parseFloat(XmlPullParser xpp, String name, float defaultValue)

parseFrameRate

protected static float parseFrameRate(XmlPullParser xpp, float defaultValue)

parseInitialization

protected RangedUri parseInitialization(XmlPullParser xpp)

parseInt

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

parseLabel

protected Label parseLabel(XmlPullParser xpp)

Parses a Label element.

Parameters
XmlPullParser xpp	The parser from which to read.

Returns
Label	The parsed label.

Throws
org.xmlpull.v1.XmlPullParserException	If an error occurs parsing the element.
java.io.IOException	If an error occurs reading the element.

parseLastSegmentNumberSupplementalProperty

protected static long parseLastSegmentNumberSupplementalProperty(
    List<Descriptor> supplementalProperties
)

parseLong

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

parseMediaPresentationDescription

protected DashManifest parseMediaPresentationDescription(
    XmlPullParser xpp,
    Uri documentBaseUri
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseMpegChannelConfiguration

protected static int parseMpegChannelConfiguration(XmlPullParser xpp)

Parses the number of channels from the value attribute of an AudioChannelConfiguration with schemeIdUri "urn:mpeg:mpegB:cicp:ChannelConfiguration", as defined by ISO 23091-3:2018 clause 6.2.

Parameters
XmlPullParser xpp	The parser from which to read.

Returns
int	The parsed number of channels, or NO_VALUE if the channel count could not be parsed.

parsePeriod

protected Pair<Period, Long> parsePeriod(
    XmlPullParser xpp,
    List<BaseUrl> parentBaseUrls,
    long defaultStartMs,
    long baseUrlAvailabilityTimeOffsetUs,
    long availabilityStartTimeMs,
    long timeShiftBufferDepthMs,
    boolean dvbProfileDeclared
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseProfiles

protected String[] parseProfiles(
    XmlPullParser xpp,
    String attributeName,
    String[] defaultValue
)

parseProgramInformation

protected ProgramInformation parseProgramInformation(XmlPullParser xpp)

Throws
java.io.IOException
org.xmlpull.v1.XmlPullParserException

parseRangedUrl

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

parseRepresentation

protected DashManifestParser.RepresentationInfo parseRepresentation(
    XmlPullParser xpp,
    List<BaseUrl> parentBaseUrls,
    @Nullable String adaptationSetMimeType,
    @Nullable String adaptationSetCodecs,
    @Nullable String adaptationSetSupplementalCodecs,
    @Nullable String adaptationSetSupplementalProfiles,
    int adaptationSetWidth,
    int adaptationSetHeight,
    float adaptationSetFrameRate,
    int adaptationSetAudioChannels,
    int adaptationSetAudioSamplingRate,
    @Nullable String adaptationSetLanguage,
    List<Descriptor> adaptationSetRoleDescriptors,
    List<Descriptor> adaptationSetAccessibilityDescriptors,
    List<Descriptor> adaptationSetEssentialProperties,
    List<Descriptor> adaptationSetSupplementalProperties,
    @Nullable SegmentBase segmentBase,
    long periodStartUnixTimeMs,
    long periodDurationMs,
    long baseUrlAvailabilityTimeOffsetUs,
    long segmentBaseAvailabilityTimeOffsetUs,
    long timeShiftBufferDepthMs,
    boolean dvbProfileDeclared
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseRoleFlagsFromAccessibilityDescriptors

@C.RoleFlags
protected int parseRoleFlagsFromAccessibilityDescriptors(
    List<Descriptor> accessibilityDescriptors
)

parseRoleFlagsFromDashRoleScheme

@C.RoleFlags
protected int parseRoleFlagsFromDashRoleScheme(@Nullable String value)

parseRoleFlagsFromProperties

@C.RoleFlags
protected int parseRoleFlagsFromProperties(
    List<Descriptor> accessibilityDescriptors
)

parseRoleFlagsFromRoleDescriptors

@C.RoleFlags
protected int parseRoleFlagsFromRoleDescriptors(List<Descriptor> roleDescriptors)

parseSegmentBase

protected SegmentBase.SingleSegmentBase parseSegmentBase(
    XmlPullParser xpp,
    @Nullable SegmentBase.SingleSegmentBase parent
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseSegmentList

protected SegmentBase.SegmentList parseSegmentList(
    XmlPullParser xpp,
    @Nullable SegmentBase.SegmentList parent,
    long periodStartUnixTimeMs,
    long periodDurationMs,
    long baseUrlAvailabilityTimeOffsetUs,
    long segmentBaseAvailabilityTimeOffsetUs,
    long timeShiftBufferDepthMs
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseSegmentTemplate

protected SegmentBase.SegmentTemplate parseSegmentTemplate(
    XmlPullParser xpp,
    @Nullable SegmentBase.SegmentTemplate parent,
    List<Descriptor> adaptationSetSupplementalProperties,
    long periodStartUnixTimeMs,
    long periodDurationMs,
    long baseUrlAvailabilityTimeOffsetUs,
    long segmentBaseAvailabilityTimeOffsetUs,
    long timeShiftBufferDepthMs
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseSegmentTimeline

protected List<SegmentBase.SegmentTimelineElement> parseSegmentTimeline(
    XmlPullParser xpp,
    long timescale,
    long periodDurationMs
)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseSegmentUrl

protected RangedUri parseSegmentUrl(XmlPullParser xpp)

parseSelectionFlagsFromDashRoleScheme

@C.SelectionFlags
protected int parseSelectionFlagsFromDashRoleScheme(@Nullable String value)

parseSelectionFlagsFromRoleDescriptors

@C.SelectionFlags
protected int parseSelectionFlagsFromRoleDescriptors(
    List<Descriptor> roleDescriptors
)

parseServiceDescription

protected ServiceDescriptionElement parseServiceDescription(XmlPullParser xpp)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseString

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

parseText

protected static String parseText(XmlPullParser xpp, String label)

Throws
org.xmlpull.v1.XmlPullParserException
java.io.IOException

parseTileCountFromProperties

protected @Nullable Pair<Integer, Integer> parseTileCountFromProperties(List<Descriptor> essentialProperties)

Parses given descriptors for thumbnail tile information.

Parameters
List<Descriptor> essentialProperties	List of descriptors that contain thumbnail tile information.

Returns
@Nullable Pair<Integer, Integer>	A pair of Integer values, where the first is the count of horizontal tiles and the second is the count of vertical tiles, or null if no thumbnail tile information is found.

parseTvaAudioPurposeCsValue

@C.RoleFlags
protected int parseTvaAudioPurposeCsValue(@Nullable String value)

parseUrlTemplate

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

parseUtcTiming

protected UtcTimingElement parseUtcTiming(XmlPullParser xpp)