shaka-player
Version:
DASH/EME video player library
1,117 lines (953 loc) • 43.4 kB
JavaScript
/*! @license
* Shaka Player
* Copyright 2016 Google LLC
* SPDX-License-Identifier: Apache-2.0
*/
describe('HlsParser live', () => {
const ManifestParser = shaka.test.ManifestParser;
const master = [
'#EXTM3U\n',
'#EXT-X-STREAM-INF:BANDWIDTH=200,CODECS="avc1",',
'RESOLUTION=960x540,FRAME-RATE=60\n',
'video\n',
].join('');
/** @type {!shaka.test.FakeNetworkingEngine} */
let fakeNetEngine;
/** @type {!shaka.hls.HlsParser} */
let parser;
/** @type {shaka.extern.ManifestParser.PlayerInterface} */
let playerInterface;
/** @type {shaka.extern.ManifestConfiguration} */
let config;
/** @type {!Uint8Array} */
let initSegmentData;
/** @type {!Uint8Array} */
let segmentData;
/** @type {!Uint8Array} */
let selfInitializingSegmentData;
/** @type {!Uint8Array} */
let tsSegmentData;
/** @type {!Uint8Array} */
let pastRolloverSegmentData;
/** @type {number} */
let rolloverOffset;
/** @type {number} */
let segmentDataStartTime;
beforeEach(() => {
// TODO: use StreamGenerator?
initSegmentData = new Uint8Array([
0x00, 0x00, 0x00, 0x30, // size (48)
0x6D, 0x6F, 0x6F, 0x76, // type (moov)
0x00, 0x00, 0x00, 0x28, // trak size (40)
0x74, 0x72, 0x61, 0x6B, // type (trak)
0x00, 0x00, 0x00, 0x20, // mdia size (32)
0x6D, 0x64, 0x69, 0x61, // type (mdia)
0x00, 0x00, 0x00, 0x18, // mdhd size (24)
0x6D, 0x64, 0x68, 0x64, // type (mdhd)
0x00, 0x00, 0x00, 0x00, // version and flags
0x00, 0x00, 0x00, 0x00, // creation time (0)
0x00, 0x00, 0x00, 0x00, // modification time (0)
0x00, 0x00, 0x03, 0xe8, // timescale (1000)
]);
segmentData = new Uint8Array([
0x00, 0x00, 0x00, 0x24, // size (36)
0x6D, 0x6F, 0x6F, 0x66, // type (moof)
0x00, 0x00, 0x00, 0x1C, // traf size (28)
0x74, 0x72, 0x61, 0x66, // type (traf)
0x00, 0x00, 0x00, 0x14, // tfdt size (20)
0x74, 0x66, 0x64, 0x74, // type (tfdt)
0x01, 0x00, 0x00, 0x00, // version and flags
0x00, 0x00, 0x00, 0x00, // baseMediaDecodeTime first 4 bytes
0x00, 0x00, 0x07, 0xd0, // baseMediaDecodeTime last 4 bytes (2000)
]);
tsSegmentData = new Uint8Array([
0x47, // TS sync byte (fixed value)
0x41, 0x01, // not corrupt, payload follows, packet ID 257
0x10, // not scrambled, no adaptation field, payload only, seq #0
0x00, 0x00, 0x01, // PES start code (fixed value)
0xe0, // stream ID (video stream 0)
0x00, 0x00, // PES packet length (doesn't matter)
0x80, // marker bits (fixed value), not scrambled, not priority
0x80, // PTS only, no DTS, other flags 0 (don't matter)
0x05, // remaining PES header length == 5 (one timestamp)
0x21, 0x00, 0x0b, 0x7e, 0x41, // PTS = 180000, encoded into 5 bytes
]);
// 180000 divided by TS timescale (90000) = segment starts at 2s.
segmentDataStartTime = 2;
pastRolloverSegmentData = new Uint8Array([
0x00, 0x00, 0x00, 0x24, // size (36)
0x6D, 0x6F, 0x6F, 0x66, // type (moof)
0x00, 0x00, 0x00, 0x1C, // traf size (28)
0x74, 0x72, 0x61, 0x66, // type (traf)
0x00, 0x00, 0x00, 0x14, // tfdt size (20)
0x74, 0x66, 0x64, 0x74, // type (tfdt)
0x01, 0x00, 0x00, 0x00, // version and flags
0x00, 0x00, 0x00, 0x00, // baseMediaDecodeTime first 4 bytes
0x0b, 0x60, 0xbc, 0x28, // baseMediaDecodeTime last 4 bytes (190889000)
]);
// The timestamp above would roll over twice, so this rollover offset should
// be applied.
rolloverOffset = (0x200000000 * 2) / 90000;
selfInitializingSegmentData =
shaka.util.Uint8ArrayUtils.concat(initSegmentData, segmentData);
fakeNetEngine = new shaka.test.FakeNetworkingEngine();
config = shaka.util.PlayerConfiguration.createDefault().manifest;
playerInterface = {
filter: () => Promise.resolve(),
makeTextStreamsForClosedCaptions: (manifest) => {},
networkingEngine: fakeNetEngine,
onError: fail,
onEvent: fail,
onTimelineRegionAdded: fail,
isLowLatencyMode: () => false,
isAutoLowLatencyMode: () => false,
enableLowLatencyMode: () => {},
};
parser = new shaka.hls.HlsParser();
parser.configure(config);
});
afterEach(() => {
// HLS parser stop is synchronous.
parser.stop();
});
/**
* Trigger a manifest update.
* @suppress {accessControls}
*/
async function delayForUpdatePeriod() {
parser.updatePlaylistTimer_.tickNow();
await shaka.test.Util.shortDelay(); // Allow update to finish.
}
/**
* @param {string} master
* @param {string} initialMedia
* @param {!Array} initialReferences
* @param {string} updatedMedia
* @param {!Array} updatedReferences
*/
async function testUpdate(
master, initialMedia, initialReferences, updatedMedia,
updatedReferences) {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', initialMedia)
.setResponseText('test:/redirected/video', initialMedia)
.setResponseText('test:/video2', initialMedia)
.setResponseText('test:/audio', initialMedia)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/main2.mp4', segmentData)
.setResponseValue('test:/main3.mp4', segmentData)
.setResponseValue('test:/main4.mp4', segmentData)
.setResponseValue('test:/selfInit.mp4', selfInitializingSegmentData);
const manifest = await parser.start('test:/master', playerInterface);
await Promise.all(manifest.variants.map(async (variant) => {
await variant.video.createSegmentIndex();
ManifestParser.verifySegmentIndex(variant.video, initialReferences);
if (variant.audio) {
await variant.audio.createSegmentIndex();
ManifestParser.verifySegmentIndex(variant.audio, initialReferences);
}
}));
// Replace the entries with the updated values.
fakeNetEngine
.setResponseText('test:/video', updatedMedia)
.setResponseText('test:/redirected/video', updatedMedia)
.setResponseText('test:/video2', updatedMedia)
.setResponseText('test:/audio', updatedMedia)
.setResponseText('test:/video?_HLS_skip=YES', updatedMedia);
await delayForUpdatePeriod();
for (const variant of manifest.variants) {
ManifestParser.verifySegmentIndex(variant.video, updatedReferences);
if (variant.audio) {
ManifestParser.verifySegmentIndex(variant.audio, updatedReferences);
}
}
}
describe('playlist type EVENT', () => {
const media = [
'#EXTM3U\n',
'#EXT-X-PLAYLIST-TYPE:EVENT\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXTINF:2,\n',
'main.mp4\n',
].join('');
const mediaWithAdditionalSegment = [
'#EXTM3U\n',
'#EXT-X-PLAYLIST-TYPE:EVENT\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXTINF:2,\n',
'main.mp4\n',
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
it('treats already ended presentation like VOD', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media + '#EXT-X-ENDLIST')
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.isLive()).toBe(false);
expect(manifest.presentationTimeline.isInProgress()).toBe(false);
});
describe('update', () => {
it('adds new segments when they appear', async () => {
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
await testUpdate(
master, media, [ref1], mediaWithAdditionalSegment, [ref1, ref2]);
});
it('updates all variants', async () => {
const secondVariant = [
'#EXT-X-STREAM-INF:BANDWIDTH=300,CODECS="avc1",',
'RESOLUTION=1200x940,FRAME-RATE=60\n',
'video2',
].join('');
const masterWithTwoVariants = master + secondVariant;
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
await testUpdate(
masterWithTwoVariants, media, [ref1], mediaWithAdditionalSegment,
[ref1, ref2]);
});
it('updates all streams', async () => {
const masterlist = [
'#EXTM3U\n',
'#EXT-X-STREAM-INF:BANDWIDTH=200,CODECS="avc1",AUDIO="aud1",',
'RESOLUTION=960x540,FRAME-RATE=60\n',
'video\n',
].join('');
const audio = [
'#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud1",LANGUAGE="eng",',
'URI="audio"\n',
].join('');
const masterWithAudio = masterlist + audio;
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
await testUpdate(
masterWithAudio, media, [ref1], mediaWithAdditionalSegment,
[ref1, ref2]);
});
it('handles multiple updates', async () => {
const newSegment1 = [
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
const newSegment2 = [
'#EXTINF:2,\n',
'main3.mp4\n',
].join('');
const updatedMedia1 = media + newSegment1;
const updatedMedia2 = updatedMedia1 + newSegment2;
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
const ref3 = ManifestParser.makeReference('test:/main3.mp4', 6, 8);
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [ref1]);
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', updatedMedia1);
await delayForUpdatePeriod();
ManifestParser.verifySegmentIndex(video, [ref1, ref2]);
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', updatedMedia2);
await delayForUpdatePeriod();
ManifestParser.verifySegmentIndex(video, [ref1, ref2, ref3]);
});
it('converts presentation to VOD when it is finished', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.isLive()).toBe(true);
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video',
mediaWithAdditionalSegment + '#EXT-X-ENDLIST\n');
await delayForUpdatePeriod();
expect(manifest.presentationTimeline.isLive()).toBe(false);
});
it('starts presentation as VOD when ENDLIST is present', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media + '#EXT-X-ENDLIST')
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.isLive()).toBe(false);
});
it('does not throw when interrupted by stop', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.isLive()).toBe(true);
// Block the next request so that update() is still happening when we
// call stop().
/** @type {!shaka.util.PublicPromise} */
const delay = fakeNetEngine.delayNextRequest();
// Trigger an update.
await delayForUpdatePeriod();
// Stop the parser mid-update, but don't wait for stop to complete.
const stopPromise = parser.stop();
// Unblock the request.
delay.resolve();
// Allow update to finish.
await shaka.test.Util.shortDelay();
// Wait for stop to complete.
await stopPromise;
});
}); // describe('update')
}); // describe('playlist type EVENT')
describe('playlist type LIVE', () => {
const media = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXTINF:2,\n',
'main.mp4\n',
].join('');
const mediaWithoutSequenceNumber = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXTINF:2,\n',
'main.mp4\n',
].join('');
const mediaWithByteRange = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXT-X-BYTERANGE:121090@616\n',
'#EXTINF:2,\n',
'main.mp4\n',
].join('');
const expectedStartByte = 616;
const expectedEndByte = 121705;
const mediaWithAdditionalSegment = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXTINF:2,\n',
'main.mp4\n',
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
const mediaWithRemovedSegment = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:1\n',
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
let mediaWithManySegments = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
].join('');
for (let i = 0; i < 1000; i++) {
mediaWithManySegments += '#EXTINF:2,\n';
mediaWithManySegments += 'main.mp4\n';
}
const mediaWithDiscontinuity = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXT-X-DISCONTINUITY-SEQUENCE:30\n',
'#EXTINF:2,\n',
'main.mp4\n',
'#EXT-X-DISCONTINUITY\n',
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
const mediaWithUpdatedDiscontinuitySegment = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:1\n',
'#EXT-X-DISCONTINUITY-SEQUENCE:31\n',
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
it('starts presentation as VOD when ENDLIST is present', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media + '#EXT-X-ENDLIST')
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.isLive()).toBe(false);
});
it('does not fail on a missing sequence number', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithoutSequenceNumber)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
await parser.start('test:/master', playerInterface);
});
it('sets presentation delay as configured', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
config.defaultPresentationDelay = 10;
parser.configure(config);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.getDelay()).toBe(
config.defaultPresentationDelay);
});
it('sets 3 times target duration as presentation delay if not configured',
async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest.presentationTimeline.getDelay()).toBe(15);
});
it('sets presentation delay for low latency mode', async () => {
const mediaWithLowLatency = [
'#EXTM3U\n',
'#EXT-X-SERVER-CONTROL:CAN-BLOCK-RELOAD=YES,PART-HOLD-BACK=1.8\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-PART-INF:PART-TARGET=0.5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXTINF:2,\n',
'main.mp4\n',
].join('');
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithLowLatency)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
playerInterface.isLowLatencyMode = () => true;
const manifest = await parser.start('test:/master', playerInterface);
// Presentation delay should be the value of 'PART-HOLD-BACK' if not
// configured.
expect(manifest.presentationTimeline.getDelay()).toBe(1.8);
});
describe('availabilityWindowOverride', () => {
async function testWindowOverride(expectedWindow) {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithManySegments)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const manifest = await parser.start('test:/master', playerInterface);
expect(manifest).toBeTruthy();
const timeline = manifest.presentationTimeline;
expect(timeline).toBeTruthy();
const start = timeline.getSegmentAvailabilityStart();
const end = timeline.getSegmentAvailabilityEnd();
expect(end - start).toBeCloseTo(expectedWindow, 1);
}
it('does not affect seek range if unset', async () => {
// 15 seconds is three segment durations.
await testWindowOverride(15);
});
it('overrides default seek range if set', async () => {
config.availabilityWindowOverride = 240;
parser.configure(config);
await testWindowOverride(240);
});
});
it('sets timestamp offset for segments with discontinuity', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithDiscontinuity)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/main2.mp4', segmentData);
const ref1 = ManifestParser.makeReference(
'test:/main.mp4', segmentDataStartTime, segmentDataStartTime + 2,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ null,
/* timestampOffset= */ 0);
// Expect the timestamp offset to be set for the segment after the
// EXT-X-DISCONTINUITY tag.
const ref2 = ManifestParser.makeReference(
'test:/main2.mp4', segmentDataStartTime + 2, segmentDataStartTime + 4,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ null,
/* timestampOffset= */ 2);
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [ref1, ref2]);
});
it('offsets VTT text with rolled over TS timestamps', async () => {
const masterWithVtt = [
'#EXTM3U\n',
'#EXT-X-MEDIA:TYPE=SUBTITLES,LANGUAGE="fra",URI="text",',
'GROUP-ID="sub1"\n',
'#EXT-X-STREAM-INF:BANDWIDTH=200,CODECS="avc1",',
'RESOLUTION=960x540,FRAME-RATE=60,SUBTITLES="sub1"\n',
'video\n',
].join('');
const textPlaylist = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXTINF:2,\n',
'main.vtt\n',
].join('');
const vtt = [
'WEBVTT\n',
'\n',
'00:00.000 --> 00:01.000\n',
'Hello, world!\n',
].join('');
fakeNetEngine
.setResponseText('test:/master', masterWithVtt)
.setResponseText('test:/video', media)
.setResponseText('test:/text', textPlaylist)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', pastRolloverSegmentData)
.setResponseText('test:/main.vtt', vtt);
const manifest = await parser.start('test:/master', playerInterface);
const textStream = manifest.textStreams[0];
await textStream.createSegmentIndex();
goog.asserts.assert(textStream.segmentIndex, 'Null segmentIndex!');
let ref = Array.from(textStream.segmentIndex)[0];
expect(ref).not.toBe(null);
expect(ref.startTime).not.toBeLessThan(rolloverOffset);
const videoStream = manifest.variants[0].video;
await videoStream.createSegmentIndex();
goog.asserts.assert(videoStream.segmentIndex, 'Null segmentIndex!');
ref = Array.from(videoStream.segmentIndex)[0];
expect(ref).not.toBe(null);
expect(ref.startTime).not.toBeLessThan(rolloverOffset);
});
// Test for https://github.com/shaka-project/shaka-player/issues/4223
it('parses streams with partial and preload hinted segments', async () => {
playerInterface.isLowLatencyMode = () => true;
const mediaWithPartialSegments = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-PART-INF:PART-TARGET=1.5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
// ref includes partialRef, partialRef2
// partialRef
'#EXT-X-PART:DURATION=2,URI="partial.mp4",BYTERANGE=200@0\n',
// partialRef2
'#EXT-X-PART:DURATION=2,URI="partial2.mp4",BYTERANGE=230@200\n',
'#EXTINF:4,\n',
'main.mp4\n',
// ref2 includes partialRef3, preloadRef
// partialRef3
'#EXT-X-PART:DURATION=2,URI="partial.mp4",BYTERANGE=210@0\n',
// preloadRef
'#EXT-X-PRELOAD-HINT:TYPE=PART,URI="partial.mp4",BYTERANGE-START=210\n',
].join('');
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithPartialSegments)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/partial.mp4', segmentData)
.setResponseValue('test:/partial2.mp4', segmentData);
const partialRef = ManifestParser.makeReference(
'test:/partial.mp4', segmentDataStartTime, segmentDataStartTime + 2,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ 199);
const partialRef2 = ManifestParser.makeReference(
'test:/partial2.mp4', segmentDataStartTime + 2,
segmentDataStartTime + 4, /* baseUri= */ '', /* startByte= */ 200,
/* endByte= */ 429);
const ref = ManifestParser.makeReference(
'test:/main.mp4', segmentDataStartTime, segmentDataStartTime + 4,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ 429,
/* timestampOffset= */ 0, [partialRef, partialRef2]);
const partialRef3 = ManifestParser.makeReference(
'test:/partial.mp4', segmentDataStartTime + 4,
segmentDataStartTime + 6,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ 209);
// A preload hinted partial segment doesn't have duration information,
// so its startTime and endTime are the same.
const preloadRef = ManifestParser.makeReference(
'test:/partial.mp4', segmentDataStartTime + 6,
segmentDataStartTime + 7.5,
/* baseUri= */ '', /* startByte= */ 210, /* endByte= */ null);
// ref2 is not fully published yet, so it doesn't have a segment uri.
const ref2 = ManifestParser.makeReference(
'', segmentDataStartTime + 4, segmentDataStartTime + 7.5,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ null,
/* timestampOffset= */ 0, [partialRef3, preloadRef]);
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [ref, ref2]);
});
// Test for https://github.com/shaka-project/shaka-player/issues/4223
it('ignores preload hinted segments without target duration', async () => {
playerInterface.isLowLatencyMode = () => true;
// Missing PART-TARGET, so preload hints are skipped.
const mediaWithPartialSegments = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXTINF:4,\n',
// ref1
'main.mp4\n',
// ref2 includes partialRef, but not preloadRef
// partialRef
'#EXT-X-PART:DURATION=2,URI="partial.mp4",BYTERANGE=210@0\n',
// preloadRef
'#EXT-X-PRELOAD-HINT:TYPE=PART,URI="partial.mp4",BYTERANGE-START=210\n',
].join('');
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithPartialSegments)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/partial.mp4', segmentData)
.setResponseValue('test:/partial2.mp4', segmentData);
const ref1 = ManifestParser.makeReference(
'test:/main.mp4', segmentDataStartTime, segmentDataStartTime + 4,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ null,
/* timestampOffset= */ 0, []);
const partialRef = ManifestParser.makeReference(
'test:/partial.mp4', segmentDataStartTime + 4,
segmentDataStartTime + 6,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ 209);
// ref2 is not fully published yet, so it doesn't have a segment uri.
const ref2 = ManifestParser.makeReference(
'', segmentDataStartTime + 4, segmentDataStartTime + 6,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ 209,
/* timestampOffset= */ 0, [partialRef]);
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [ref1, ref2]);
});
// Test for https://github.com/shaka-project/shaka-player/issues/4185
it('does not fail on preload hints with LL mode off', async () => {
// LL mode must be off for this test!
playerInterface.isLowLatencyMode = () => false;
const mediaWithPartialSegments = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-PART-INF:PART-TARGET=1.5\n',
'#EXTINF:4,\n',
'main.mp4\n',
'#EXT-X-PART:DURATION=2,URI="partial.mp4",BYTERANGE=210@0\n',
'#EXT-X-PRELOAD-HINT:TYPE=PART,URI="partial.mp4",BYTERANGE-START=210\n',
].join('');
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithPartialSegments)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/partial.mp4', segmentData);
// If this throws, the test fails. Otherwise, it passes.
await parser.start('test:/master', playerInterface);
});
describe('update', () => {
it('adds new segments when they appear', async () => {
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
await testUpdate(
master, media, [ref1], mediaWithAdditionalSegment, [ref1, ref2]);
});
it('evicts removed segments', async () => {
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
await testUpdate(
master, mediaWithAdditionalSegment, [ref1, ref2],
mediaWithRemovedSegment, [ref2]);
});
it('handles updates with redirects', async () => {
const oldRef1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const newRef1 =
ManifestParser.makeReference('test:/redirected/main.mp4', 2, 4);
const newRef2 =
ManifestParser.makeReference('test:/redirected/main2.mp4', 4, 6);
let playlistFetchCount = 0;
fakeNetEngine.setResponseFilter((type, response) => {
// Simulate a redirect on the updated playlist by changing the
// response URI on the second playlist fetch.
if (response.uri == 'test:/video') {
playlistFetchCount++;
if (playlistFetchCount == 2) {
response.uri = 'test:/redirected/video';
}
}
});
await testUpdate(
master, media, [oldRef1], mediaWithAdditionalSegment,
[newRef1, newRef2]);
});
it('parses start time from mp4 segments', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', media)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const expectedRef = ManifestParser.makeReference(
'test:/main.mp4', segmentDataStartTime, segmentDataStartTime + 2);
// In live content, we do not set timestampOffset.
expectedRef.timestampOffset = 0;
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [expectedRef]);
});
it('gets start time on update without segment request', async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithAdditionalSegment)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const ref1 = ManifestParser.makeReference(
'test:/main.mp4', segmentDataStartTime, segmentDataStartTime + 2);
const ref2 = ManifestParser.makeReference(
'test:/main2.mp4', segmentDataStartTime + 2,
segmentDataStartTime + 4);
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [ref1, ref2]);
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithRemovedSegment)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/main2.mp4', segmentData);
fakeNetEngine.request.calls.reset();
await delayForUpdatePeriod();
ManifestParser.verifySegmentIndex(video, [ref2]);
// Only one request was made, and it was for the playlist.
// No segment requests were needed to get the start time.
expect(fakeNetEngine.request).toHaveBeenCalledTimes(1);
fakeNetEngine.expectRequest(
'test:/video',
shaka.net.NetworkingEngine.RequestType.MANIFEST);
});
it('reuses cached timestamp offset for segments with discontinuity',
async () => {
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithDiscontinuity)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/main2.mp4', segmentData);
const ref1 = ManifestParser.makeReference('test:/main.mp4',
segmentDataStartTime, segmentDataStartTime + 2);
const ref2 = ManifestParser.makeReference('test:/main2.mp4',
segmentDataStartTime + 2, segmentDataStartTime + 4);
const manifest =
await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [ref1, ref2]);
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video',
mediaWithUpdatedDiscontinuitySegment)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main2.mp4', segmentData);
fakeNetEngine.request.calls.reset();
await delayForUpdatePeriod();
ManifestParser.verifySegmentIndex(video, [ref2]);
// Only one request should be made, and it's for the playlist.
// Expect to use the cached timestamp offset for the main2.mp4
// segment, without fetching the start time again.
expect(fakeNetEngine.request).toHaveBeenCalledTimes(1);
fakeNetEngine.expectRequest(
'test:/video',
shaka.net.NetworkingEngine.RequestType.MANIFEST);
fakeNetEngine.expectNoRequest(
'test:/main.mp4',
shaka.net.NetworkingEngine.RequestType.SEGMENT);
});
it('parses start time from ts segments', async () => {
const tsMediaPlaylist =
mediaWithRemovedSegment.replace(/\.mp4/g, '.ts');
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', tsMediaPlaylist)
.setResponseValue('test:/main2.ts', tsSegmentData);
const expectedRef = ManifestParser.makeReference(
'test:/main2.ts', segmentDataStartTime, segmentDataStartTime + 2);
// In live content, we do not set timestampOffset.
expectedRef.timestampOffset = 0;
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [expectedRef]);
});
it('gets start time of segments with byte range', async () => {
// Nit: this value is an implementation detail of the fix for #1106
const partialEndByte = expectedStartByte + 2048 - 1;
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithByteRange)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData);
const expectedRef = ManifestParser.makeReference(
/* uri= */ 'test:/main.mp4',
/* start= */ segmentDataStartTime,
/* end= */ segmentDataStartTime + 2,
/* baseUri= */ '',
expectedStartByte,
expectedEndByte); // Complete segment reference
const manifest = await parser.start('test:/master', playerInterface);
const video = manifest.variants[0].video;
await video.createSegmentIndex();
ManifestParser.verifySegmentIndex(video, [expectedRef]);
// There should have been a range request for this segment to get the
// start time.
fakeNetEngine.expectRangeRequest(
'test:/main.mp4',
expectedStartByte,
partialEndByte); // partial segment request
});
it('request playlist delta updates to skip segments', async () => {
const mediaWithDeltaUpdates = [
'#EXTM3U\n',
'#EXT-X-PLAYLIST-TYPE:LIVE\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-SERVER-CONTROL:CAN-SKIP-UNTIL=60.0\n',
'#EXTINF:2,\n',
'main.mp4\n',
'#EXTINF:2,\n',
'main2.mp4\n',
].join('');
const mediaWithSkippedSegments = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXT-X-SERVER-CONTROL:CAN-SKIP-UNTIL=60.0\n',
'#EXT-X-SKIP:SKIPPED-SEGMENTS=1\n',
'#EXTINF:2,\n',
'main2.mp4\n',
'#EXTINF:2,\n',
'main3.mp4\n',
].join('');
fakeNetEngine
.setResponseText('test:/master', master)
.setResponseText('test:/video', mediaWithDeltaUpdates)
.setResponseText('test:/video?_HLS_skip=YES',
mediaWithSkippedSegments)
.setResponseValue('test:/init.mp4', initSegmentData)
.setResponseValue('test:/main.mp4', segmentData)
.setResponseValue('test:/main2.mp4', segmentData)
.setResponseValue('test:/main3.mp4', segmentData);
playerInterface.isLowLatencyMode = () => true;
await parser.start('test:/master', playerInterface);
// Replace the entries with the updated values.
fakeNetEngine.request.calls.reset();
await delayForUpdatePeriod();
fakeNetEngine.expectRequest(
'test:/video?_HLS_skip=YES',
shaka.net.NetworkingEngine.RequestType.MANIFEST);
});
it('skips older segments', async () => {
const mediaWithSkippedSegments = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXT-X-SKIP:SKIPPED-SEGMENTS=1\n',
'#EXTINF:2,\n',
'main2.mp4\n',
'#EXTINF:2,\n',
'main3.mp4\n',
].join('');
playerInterface.isLowLatencyMode = () => true;
const ref1 = ManifestParser.makeReference('test:/main.mp4', 2, 4);
const ref2 = ManifestParser.makeReference('test:/main2.mp4', 4, 6);
const ref3 = ManifestParser.makeReference('test:/main3.mp4', 6, 8);
// With 'SKIPPED-SEGMENTS', ref1 is skipped from the playlist,
// and ref1 should be in the SegmentReferences list.
// ref3 should be appended to the SegmentReferences list.
await testUpdate(
master, mediaWithAdditionalSegment, [ref1, ref2],
mediaWithSkippedSegments, [ref1, ref2, ref3]);
});
it('skips older segments with discontinuity', async () => {
const mediaWithDiscontinuity2 = [
'#EXTM3U\n',
'#EXT-X-PLAYLIST-TYPE:LIVE\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-DISCONTINUITY-SEQUENCE:30\n',
'#EXTINF:2,\n',
'main.mp4\n',
'#EXT-X-DISCONTINUITY\n',
'#EXTINF:2,\n',
'main2.mp4\n',
'#EXTINF:2,\n',
'main3.mp4\n',
].join('');
const mediaWithSkippedSegments2 = [
'#EXTM3U\n',
'#EXT-X-TARGETDURATION:5\n',
'#EXT-X-MAP:URI="init.mp4",BYTERANGE="616@0"\n',
'#EXT-X-MEDIA-SEQUENCE:0\n',
'#EXT-X-DISCONTINUITY-SEQUENCE:30\n',
'#EXT-X-SKIP:SKIPPED-SEGMENTS=2\n',
'#EXTINF:2,\n',
'main3.mp4\n',
'#EXTINF:2,\n',
'main4.mp4\n',
].join('');
playerInterface.isLowLatencyMode = () => true;
const ref1 = ManifestParser.makeReference(
'test:/main.mp4', segmentDataStartTime, segmentDataStartTime + 2,
/* baseUri= */ '', /* startByte= */ 0, /* endByte= */ null,
/* timestampOffset= */ 0);
// Expect the timestamp offset to be set for the segment after the
// EXT-X-DISCONTINUITY tag.
const ref2 = ManifestParser.makeReference(
'test:/main2.mp4', segmentDataStartTime + 2,
segmentDataStartTime + 4, /* baseUri= */ '', /* startByte= */ 0,
/* endByte= */ null, /* timestampOffset= */ 2);
// Expect the timestamp offset to be set for the segment, with the
// EXT-X-DISCONTINUITY tag skipped in the playlist.
const ref3 = ManifestParser.makeReference(
'test:/main3.mp4', segmentDataStartTime + 4,
segmentDataStartTime + 6, /* baseUri= */ '', /* startByte= */ 0,
/* endByte= */ null, /* timestampOffset= */ 2);
const ref4 = ManifestParser.makeReference(
'test:/main4.mp4', segmentDataStartTime + 6,
segmentDataStartTime + 8, /* baseUri= */ '', /* startByte= */ 0,
/* endByte= */ null, /* timestampOffset= */ 2);
// With 'SKIPPED-SEGMENTS', ref1, ref2 are skipped from the playlist,
// and ref1,ref2 should be in the SegmentReferences list.
// ref3,ref4 should be appended to the SegmentReferences list.
await testUpdate(
master, mediaWithDiscontinuity2, [ref1, ref2, ref3],
mediaWithSkippedSegments2, [ref1, ref2, ref3, ref4]);
});
}); // describe('update')
}); // describe('playlist type LIVE')
}); // describe('HlsParser live')