Skip to content

SDK / exoplayer

Go to a project
Commit 1bc99c2f by tonihei Committed by Oliver Woodman
Options

Parse availabilityTimeOffset from DASH manifest. 

This value is needed to figure out the last available segment for
low-latency live streaming. It may be present in each BaseURL tag
and each SegmentList or SegmentTemplate, with the latter one taking
precedence.

The value is saved as part of MultiSegmentBase where it will be used
to retrieve the last available segment index in future changes.

PiperOrigin-RevId: 331809871
parent fa2a7710
Expand all
Inline Side-by-side
Showing with 264 additions and 5 deletions
library/dash/src/main/java/com/google/android/exoplayer2/source/dash/manifest/Representation.java
...@@ -17,6 +17,7 @@ package com.google.android.exoplayer2.source.dash.manifest; ...@@ -17,6 +17,7 @@ package com.google.android.exoplayer2.source.dash.manifest;
import android.net.Uri; import android.net.Uri;
import androidx.annotation.Nullable; import androidx.annotation.Nullable;
import androidx.annotation.VisibleForTesting;
import com.google.android.exoplayer2.C; import com.google.android.exoplayer2.C;
import com.google.android.exoplayer2.Format; import com.google.android.exoplayer2.Format;
import com.google.android.exoplayer2.source.dash.DashSegmentIndex; import com.google.android.exoplayer2.source.dash.DashSegmentIndex;
...@@ -275,7 +276,7 @@ public abstract class Representation { ...@@ -275,7 +276,7 @@ public abstract class Representation {
public static class MultiSegmentRepresentation extends Representation public static class MultiSegmentRepresentation extends Representation
implements DashSegmentIndex { implements DashSegmentIndex {
private final MultiSegmentBase segmentBase; @VisibleForTesting /* package */ final MultiSegmentBase segmentBase;
/** /**
* @param revisionId Identifies the revision of the content. * @param revisionId Identifies the revision of the content.
......
library/dash/src/main/java/com/google/android/exoplayer2/source/dash/manifest/SegmentBase.java
...@@ -121,6 +121,15 @@ public abstract class SegmentBase { ...@@ -121,6 +121,15 @@ public abstract class SegmentBase {
@Nullable /* package */ final List<SegmentTimelineElement> segmentTimeline; @Nullable /* package */ final List<SegmentTimelineElement> segmentTimeline;
/** /**
* Offset to the current realtime at which segments become available, in microseconds, or {@link
* C#TIME_UNSET} if all segments are available immediately.
*
* <p>Segments will be available once their end time &le; currentRealTime +
* availabilityTimeOffset.
*/
/* package */ final long availabilityTimeOffsetUs;
/**
* @param initialization A {@link RangedUri} corresponding to initialization data, if such data * @param initialization A {@link RangedUri} corresponding to initialization data, if such data
* exists. * exists.
* @param timescale The timescale in units per second. * @param timescale The timescale in units per second.
...@@ -133,6 +142,8 @@ public abstract class SegmentBase { ...@@ -133,6 +142,8 @@ public abstract class SegmentBase {
* @param segmentTimeline A segment timeline corresponding to the segments. If null, then * @param segmentTimeline A segment timeline corresponding to the segments. If null, then
* segments are assumed to be of fixed duration as specified by the {@code duration} * segments are assumed to be of fixed duration as specified by the {@code duration}
* parameter. * parameter.
* @param availabilityTimeOffsetUs The offset to the current realtime at which segments become
* available in microseconds, or {@link C#TIME_UNSET} if not applicable.
*/ */
public MultiSegmentBase( public MultiSegmentBase(
@Nullable RangedUri initialization, @Nullable RangedUri initialization,
...@@ -140,11 +151,13 @@ public abstract class SegmentBase { ...@@ -140,11 +151,13 @@ public abstract class SegmentBase {
long presentationTimeOffset, long presentationTimeOffset,
long startNumber, long startNumber,
long duration, long duration,
@Nullable List<SegmentTimelineElement> segmentTimeline) { @Nullable List<SegmentTimelineElement> segmentTimeline,
long availabilityTimeOffsetUs) {
super(initialization, timescale, presentationTimeOffset); super(initialization, timescale, presentationTimeOffset);
this.startNumber = startNumber; this.startNumber = startNumber;
this.duration = duration; this.duration = duration;
this.segmentTimeline = segmentTimeline; this.segmentTimeline = segmentTimeline;
this.availabilityTimeOffsetUs = availabilityTimeOffsetUs;
} }
/** @see DashSegmentIndex#getSegmentNum(long, long) */ /** @see DashSegmentIndex#getSegmentNum(long, long) */
...@@ -255,6 +268,8 @@ public abstract class SegmentBase { ...@@ -255,6 +268,8 @@ public abstract class SegmentBase {
* @param segmentTimeline A segment timeline corresponding to the segments. If null, then * @param segmentTimeline A segment timeline corresponding to the segments. If null, then
* segments are assumed to be of fixed duration as specified by the {@code duration} * segments are assumed to be of fixed duration as specified by the {@code duration}
* parameter. * parameter.
* @param availabilityTimeOffsetUs The offset to the current realtime at which segments become
* available in microseconds, or {@link C#TIME_UNSET} if not applicable.
* @param mediaSegments A list of {@link RangedUri}s indicating the locations of the segments. * @param mediaSegments A list of {@link RangedUri}s indicating the locations of the segments.
*/ */
public SegmentList( public SegmentList(
...@@ -264,9 +279,16 @@ public abstract class SegmentBase { ...@@ -264,9 +279,16 @@ public abstract class SegmentBase {
long startNumber, long startNumber,
long duration, long duration,
@Nullable List<SegmentTimelineElement> segmentTimeline, @Nullable List<SegmentTimelineElement> segmentTimeline,
long availabilityTimeOffsetUs,
@Nullable List<RangedUri> mediaSegments) { @Nullable List<RangedUri> mediaSegments) {
super(initialization, timescale, presentationTimeOffset, startNumber, duration, super(
segmentTimeline); initialization,
timescale,
presentationTimeOffset,
startNumber,
duration,
segmentTimeline,
availabilityTimeOffsetUs);
this.mediaSegments = mediaSegments; this.mediaSegments = mediaSegments;
} }
...@@ -311,6 +333,8 @@ public abstract class SegmentBase { ...@@ -311,6 +333,8 @@ public abstract class SegmentBase {
* @param segmentTimeline A segment timeline corresponding to the segments. If null, then * @param segmentTimeline A segment timeline corresponding to the segments. If null, then
* segments are assumed to be of fixed duration as specified by the {@code duration} * segments are assumed to be of fixed duration as specified by the {@code duration}
* parameter. * parameter.
* @param availabilityTimeOffsetUs The offset to the current realtime at which segments become
* available in microseconds, or {@link C#TIME_UNSET} if not applicable.
* @param initializationTemplate A template defining the location of initialization data, if * @param initializationTemplate A template defining the location of initialization data, if
* such data exists. If non-null then the {@code initialization} parameter is ignored. If * such data exists. If non-null then the {@code initialization} parameter is ignored. If
* null then {@code initialization} will be used. * null then {@code initialization} will be used.
...@@ -324,6 +348,7 @@ public abstract class SegmentBase { ...@@ -324,6 +348,7 @@ public abstract class SegmentBase {
long endNumber, long endNumber,
long duration, long duration,
@Nullable List<SegmentTimelineElement> segmentTimeline, @Nullable List<SegmentTimelineElement> segmentTimeline,
long availabilityTimeOffsetUs,
@Nullable UrlTemplate initializationTemplate, @Nullable UrlTemplate initializationTemplate,
@Nullable UrlTemplate mediaTemplate) { @Nullable UrlTemplate mediaTemplate) {
super( super(
...@@ -332,7 +357,8 @@ public abstract class SegmentBase { ...@@ -332,7 +357,8 @@ public abstract class SegmentBase {
presentationTimeOffset, presentationTimeOffset,
startNumber, startNumber,
duration, duration,
segmentTimeline); segmentTimeline,
availabilityTimeOffsetUs);
this.initializationTemplate = initializationTemplate; this.initializationTemplate = initializationTemplate;
this.mediaTemplate = mediaTemplate; this.mediaTemplate = mediaTemplate;
this.endNumber = endNumber; this.endNumber = endNumber;
......
library/dash/src/test/java/com/google/android/exoplayer2/source/dash/manifest/DashManifestParserTest.java
...@@ -51,6 +51,12 @@ public class DashManifestParserTest { ...@@ -51,6 +51,12 @@ public class DashManifestParserTest {
private static final String SAMPLE_MPD_ASSET_IDENTIFIER = "media/mpd/sample_mpd_asset_identifier"; private static final String SAMPLE_MPD_ASSET_IDENTIFIER = "media/mpd/sample_mpd_asset_identifier";
private static final String SAMPLE_MPD_TEXT = "media/mpd/sample_mpd_text"; private static final String SAMPLE_MPD_TEXT = "media/mpd/sample_mpd_text";
private static final String SAMPLE_MPD_TRICK_PLAY = "media/mpd/sample_mpd_trick_play"; private static final String SAMPLE_MPD_TRICK_PLAY = "media/mpd/sample_mpd_trick_play";
private static final String SAMPLE_MPD_AVAILABILITY_TIME_OFFSET_BASE_URL =
"media/mpd/sample_mpd_availabilityTimeOffset_baseUrl";
private static final String SAMPLE_MPD_AVAILABILITY_TIME_OFFSET_SEGMENT_TEMPLATE =
"media/mpd/sample_mpd_availabilityTimeOffset_segmentTemplate";
private static final String SAMPLE_MPD_AVAILABILITY_TIME_OFFSET_SEGMENT_LIST =
"media/mpd/sample_mpd_availabilityTimeOffset_segmentList";
private static final String NEXT_TAG_NAME = "Next"; private static final String NEXT_TAG_NAME = "Next";
private static final String NEXT_TAG = "<" + NEXT_TAG_NAME + "/>"; private static final String NEXT_TAG = "<" + NEXT_TAG_NAME + "/>";
...@@ -469,6 +475,91 @@ public class DashManifestParserTest { ...@@ -469,6 +475,91 @@ public class DashManifestParserTest {
assertThat(assetIdentifier.id).isEqualTo("uniqueId"); assertThat(assetIdentifier.id).isEqualTo("uniqueId");
} }
@Test
public void availabilityTimeOffset_staticManifest_setToTimeUnset() throws IOException {
DashManifestParser parser = new DashManifestParser();
DashManifest manifest =
parser.parse(
Uri.parse("https://example.com/test.mpd"),
TestUtil.getInputStream(ApplicationProvider.getApplicationContext(), SAMPLE_MPD_TEXT));
assertThat(manifest.getPeriodCount()).isEqualTo(1);
List<AdaptationSet> adaptationSets = manifest.getPeriod(0).adaptationSets;
assertThat(adaptationSets).hasSize(3);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets.get(0))).isEqualTo(C.TIME_UNSET);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets.get(1))).isEqualTo(C.TIME_UNSET);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets.get(2))).isEqualTo(C.TIME_UNSET);
}
@Test
public void availabilityTimeOffset_dynamicManifest_valuesInBaseUrl_setsCorrectValues()
throws IOException {
DashManifestParser parser = new DashManifestParser();
DashManifest manifest =
parser.parse(
Uri.parse("https://example.com/test.mpd"),
TestUtil.getInputStream(
ApplicationProvider.getApplicationContext(),
SAMPLE_MPD_AVAILABILITY_TIME_OFFSET_BASE_URL));
assertThat(manifest.getPeriodCount()).isEqualTo(2);
List<AdaptationSet> adaptationSets0 = manifest.getPeriod(0).adaptationSets;
List<AdaptationSet> adaptationSets1 = manifest.getPeriod(1).adaptationSets;
assertThat(adaptationSets0).hasSize(4);
assertThat(adaptationSets1).hasSize(1);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(0))).isEqualTo(5_000_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(1))).isEqualTo(4_321_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(2))).isEqualTo(9_876_543);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(3))).isEqualTo(C.TIME_UNSET);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets1.get(0))).isEqualTo(0);
}
@Test
public void availabilityTimeOffset_dynamicManifest_valuesInSegmentTemplate_setsCorrectValues()
throws IOException {
DashManifestParser parser = new DashManifestParser();
DashManifest manifest =
parser.parse(
Uri.parse("https://example.com/test.mpd"),
TestUtil.getInputStream(
ApplicationProvider.getApplicationContext(),
SAMPLE_MPD_AVAILABILITY_TIME_OFFSET_SEGMENT_TEMPLATE));
assertThat(manifest.getPeriodCount()).isEqualTo(2);
List<AdaptationSet> adaptationSets0 = manifest.getPeriod(0).adaptationSets;
List<AdaptationSet> adaptationSets1 = manifest.getPeriod(1).adaptationSets;
assertThat(adaptationSets0).hasSize(4);
assertThat(adaptationSets1).hasSize(1);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(0))).isEqualTo(2_000_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(1))).isEqualTo(3_210_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(2))).isEqualTo(1_230_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(3))).isEqualTo(100_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets1.get(0))).isEqualTo(9_999_000);
}
@Test
public void availabilityTimeOffset_dynamicManifest_valuesInSegmentList_setsCorrectValues()
throws IOException {
DashManifestParser parser = new DashManifestParser();
DashManifest manifest =
parser.parse(
Uri.parse("https://example.com/test.mpd"),
TestUtil.getInputStream(
ApplicationProvider.getApplicationContext(),
SAMPLE_MPD_AVAILABILITY_TIME_OFFSET_SEGMENT_LIST));
assertThat(manifest.getPeriodCount()).isEqualTo(2);
List<AdaptationSet> adaptationSets0 = manifest.getPeriod(0).adaptationSets;
List<AdaptationSet> adaptationSets1 = manifest.getPeriod(1).adaptationSets;
assertThat(adaptationSets0).hasSize(4);
assertThat(adaptationSets1).hasSize(1);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(0))).isEqualTo(2_000_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(1))).isEqualTo(3_210_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(2))).isEqualTo(1_230_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets0.get(3))).isEqualTo(100_000);
assertThat(getAvailabilityTimeOffsetUs(adaptationSets1.get(0))).isEqualTo(9_999_000);
}
private static List<Descriptor> buildCea608AccessibilityDescriptors(String value) { private static List<Descriptor> buildCea608AccessibilityDescriptors(String value) {
return Collections.singletonList(new Descriptor("urn:scte:dash:cc:cea-608:2015", value, null)); return Collections.singletonList(new Descriptor("urn:scte:dash:cc:cea-608:2015", value, null));
} }
...@@ -482,4 +573,13 @@ public class DashManifestParserTest { ...@@ -482,4 +573,13 @@ public class DashManifestParserTest {
assertThat(xpp.getEventType()).isEqualTo(XmlPullParser.START_TAG); assertThat(xpp.getEventType()).isEqualTo(XmlPullParser.START_TAG);
assertThat(xpp.getName()).isEqualTo(NEXT_TAG_NAME); assertThat(xpp.getName()).isEqualTo(NEXT_TAG_NAME);
} }
private static long getAvailabilityTimeOffsetUs(AdaptationSet adaptationSet) {
assertThat(adaptationSet.representations).isNotEmpty();
Representation representation = adaptationSet.representations.get(0);
assertThat(representation).isInstanceOf(Representation.MultiSegmentRepresentation.class);
SegmentBase.MultiSegmentBase segmentBase =
((Representation.MultiSegmentRepresentation) representation).segmentBase;
return segmentBase.availabilityTimeOffsetUs;
}
} }
testdata/src/test/assets/media/mpd/sample_mpd_availabilityTimeOffset_baseUrl 0 → 100644
<?xml version="1.0" encoding="UTF-8"?>
<MPD xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="urn:mpeg:DASH:schema:MPD:2011"
xsi:schemaLocation="urn:mpeg:DASH:schema:MPD:2011 DASH-MPD.xsd"
profiles="urn:mpeg:dash:profile:isoff-main:2011"
type="dynamic"
availabilityStartTime="2016-10-14T17:00:17">
<Period start="PT0.000S">
<BaseURL availabilityTimeOffset="5">http://video.com/baseUrl</BaseURL>
<SegmentTemplate/>
<AdaptationSet>
<Representation/>
</AdaptationSet>
<AdaptationSet>
<BaseURL availabilityTimeOffset="4.321">http://video.com/baseUrl</BaseURL>
<SegmentTemplate/>
<Representation/>
</AdaptationSet>
<AdaptationSet>
<SegmentTemplate/>
<Representation>
<BaseURL availabilityTimeOffset="9.876543210">http://video.com/baseUrl</BaseURL>
<SegmentTemplate/>
</Representation>
</AdaptationSet>
<AdaptationSet>
<BaseURL availabilityTimeOffset="0.5">http://video.com/baseUrl</BaseURL>
<Representation>
<BaseURL availabilityTimeOffset="INF">http://video.com/baseUrl</BaseURL>
<SegmentTemplate/>
</Representation>
</AdaptationSet>
</Period>
<Period start="PT100.000S">
<SegmentTemplate/>
<AdaptationSet>
<Representation/>
</AdaptationSet>
</Period>
</MPD>
testdata/src/test/assets/media/mpd/sample_mpd_availabilityTimeOffset_segmentList 0 → 100644
<?xml version="1.0" encoding="UTF-8"?>
<MPD xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="urn:mpeg:DASH:schema:MPD:2011"
xsi:schemaLocation="urn:mpeg:DASH:schema:MPD:2011 DASH-MPD.xsd"
profiles="urn:mpeg:dash:profile:isoff-main:2011"
type="dynamic"
availabilityStartTime="2016-10-14T17:00:17">
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<Period start="PT0.000S">
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentList availabilityTimeOffset="2"/>
<AdaptationSet>
<Representation>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentList/>
</Representation>
</AdaptationSet>
<AdaptationSet>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentList availabilityTimeOffset="3.21"/>
<Representation/>
</AdaptationSet>
<AdaptationSet>
<SegmentList/>
<Representation>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentList availabilityTimeOffset="1.23"/>
</Representation>
</AdaptationSet>
<AdaptationSet>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentList availabilityTimeOffset="123"/>
<Representation>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentList availabilityTimeOffset="0.1"/>
</Representation>
</AdaptationSet>
</Period>
<Period start="PT200.000S">
<AdaptationSet>
<Representation>
<SegmentList/>
</Representation>
</AdaptationSet>
</Period>
</MPD>
testdata/src/test/assets/media/mpd/sample_mpd_availabilityTimeOffset_segmentTemplate 0 → 100644
<?xml version="1.0" encoding="UTF-8"?>
<MPD xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="urn:mpeg:DASH:schema:MPD:2011"
xsi:schemaLocation="urn:mpeg:DASH:schema:MPD:2011 DASH-MPD.xsd"
profiles="urn:mpeg:dash:profile:isoff-main:2011"
type="dynamic"
availabilityStartTime="2016-10-14T17:00:17">
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<Period start="PT0.000S">
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentTemplate availabilityTimeOffset="2"/>
<AdaptationSet>
<Representation>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentTemplate/>
</Representation>
</AdaptationSet>
<AdaptationSet>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentTemplate availabilityTimeOffset="3.21"/>
<Representation/>
</AdaptationSet>
<AdaptationSet>
<SegmentTemplate/>
<Representation>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentTemplate availabilityTimeOffset="1.23"/>
</Representation>
</AdaptationSet>
<AdaptationSet>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentTemplate availabilityTimeOffset="123"/>
<Representation>
<BaseURL availabilityTimeOffset="9.999">http://video.com/baseUrl</BaseURL>
<SegmentTemplate availabilityTimeOffset="0.1"/>
</Representation>
</AdaptationSet>
</Period>
<Period start="PT200.000S">
<AdaptationSet>
<Representation>
<SegmentTemplate/>
</Representation>
</AdaptationSet>
</Period>
</MPD>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment