p2p-media-loader-dashjs 5.0.0-alpha.1 → 5.0.0-alpha.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/p2p-media-loader-dashjs.es.js +13 -28
- package/dist/p2p-media-loader-dashjs.es.js.map +1 -1
- package/dist/p2p-media-loader-dashjs.es.min.js +16 -34
- package/dist/p2p-media-loader-dashjs.es.min.js.map +1 -1
- package/dist/p2p-media-loader-dashjs.iife.js +392 -162
- package/dist/p2p-media-loader-dashjs.iife.js.map +1 -1
- package/dist/p2p-media-loader-dashjs.iife.min.js +1 -1
- package/dist/p2p-media-loader-dashjs.iife.min.js.map +1 -1
- package/lib/engine.d.ts +1 -3
- package/lib/engine.js +7 -42
- package/lib/engine.js.map +1 -1
- package/lib/loader.js +15 -4
- package/lib/loader.js.map +1 -1
- package/package.json +2 -2
- package/src/engine.ts +7 -37
- package/src/loader.ts +11 -0
package/README.md
CHANGED
|
@@ -35,7 +35,7 @@ This library makes it possible to build large-scale P2P mesh networks — often
|
|
|
35
35
|
|
|
36
36
|
- Guides [for HTML pages and web apps](https://novage.com.ua/blog/setting-up-p2p-video-on-a-web-page-in-5-minutes-for-free) and [for native mobile apps](https://novage.com.ua/blog/integrate-p2p-video-streaming-into-mobile-application)
|
|
37
37
|
- [API documentation](https://novage.github.io/p2p-media-loader/docs/v5.0/)
|
|
38
|
-
- [
|
|
38
|
+
- [v4 → v5 migration guide](https://github.com/Novage/p2p-media-loader/blob/main/MIGRATION.md)
|
|
39
39
|
- [P2P development, support & consulting](https://novage.com.ua/)
|
|
40
40
|
- [Demo](http://novage.com.ua/p2p-media-loader/demo.html)
|
|
41
41
|
- [Contributing to our project](https://github.com/Novage/p2p-media-loader/blob/main/CONTRIBUTING.md)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { dashManifestParser } from "p2p-media-loader-core/dash";
|
|
2
|
-
import { Core, Core as Core$1, CoreRequestError, byteRangeFromRangeHeader, debug,
|
|
2
|
+
import { Core, Core as Core$1, CoreRequestError, byteRangeFromRangeHeader, debug, liveDelayFor, trackMediaElementPlayback } from "p2p-media-loader-core";
|
|
3
3
|
//#region src/types.ts
|
|
4
4
|
/**
|
|
5
5
|
* The slice of dash.js's request plumbing the adapter touches, typed
|
|
@@ -65,6 +65,7 @@ var RequestRouter = class {
|
|
|
65
65
|
const responseUrl = response.url;
|
|
66
66
|
const processed = this.core.processManifest({
|
|
67
67
|
url: responseUrl !== void 0 && responseUrl !== "" ? responseUrl : url,
|
|
68
|
+
requestedUrl: url,
|
|
68
69
|
data
|
|
69
70
|
});
|
|
70
71
|
if (processed) this.hooks.onManifestProcessed?.(processed);
|
|
@@ -108,13 +109,20 @@ var RequestRouter = class {
|
|
|
108
109
|
request.customData ??= {};
|
|
109
110
|
const { customData } = request;
|
|
110
111
|
let settled = false;
|
|
112
|
+
let aborted = false;
|
|
111
113
|
const abort = () => {
|
|
112
114
|
if (settled) return;
|
|
115
|
+
aborted = true;
|
|
113
116
|
this.core.abortSegmentLoading(url, byteRange);
|
|
114
117
|
};
|
|
115
118
|
customData.abort = abort;
|
|
116
119
|
this.abortCurrent = abort;
|
|
117
120
|
this.core.loadSegment(url, { byteRange }).then(({ data, bandwidth }) => {
|
|
121
|
+
if (aborted) {
|
|
122
|
+
settled = true;
|
|
123
|
+
customData.onabort?.();
|
|
124
|
+
return;
|
|
125
|
+
}
|
|
118
126
|
settled = true;
|
|
119
127
|
response.url = url;
|
|
120
128
|
response.status = 200;
|
|
@@ -172,16 +180,6 @@ var MIN_BUFFER_SEGMENTS = 2;
|
|
|
172
180
|
var LIVE_EDGE_MARGIN_SEGMENTS = 1;
|
|
173
181
|
var STREAM_INITIALIZED = "streamInitialized";
|
|
174
182
|
var STREAM_TEARDOWN_COMPLETE = "streamTeardownComplete";
|
|
175
|
-
var PLAYBACK_EVENTS = [
|
|
176
|
-
"timeupdate",
|
|
177
|
-
"progress",
|
|
178
|
-
"seeking",
|
|
179
|
-
"seeked",
|
|
180
|
-
"ratechange",
|
|
181
|
-
"play",
|
|
182
|
-
"pause",
|
|
183
|
-
"waiting"
|
|
184
|
-
];
|
|
185
183
|
/**
|
|
186
184
|
* Represents a Peer-to-Peer (P2P) engine designed to enhance media streaming efficiency.
|
|
187
185
|
* This class integrates P2P technologies into dash.js, enabling the distribution of media segments via a peer network
|
|
@@ -206,7 +204,7 @@ var PLAYBACK_EVENTS = [
|
|
|
206
204
|
*/
|
|
207
205
|
var DashJsP2PEngine = class {
|
|
208
206
|
player;
|
|
209
|
-
|
|
207
|
+
playback = trackMediaElementPlayback((state) => this.core.updatePlayback(state));
|
|
210
208
|
core;
|
|
211
209
|
/** False when the integrator configured a live delay themselves. */
|
|
212
210
|
managesLiveDelay = false;
|
|
@@ -336,7 +334,7 @@ var DashJsP2PEngine = class {
|
|
|
336
334
|
};
|
|
337
335
|
handleStreamTeardown = () => {
|
|
338
336
|
this.core.destroy();
|
|
339
|
-
this.
|
|
337
|
+
this.playback.stop();
|
|
340
338
|
};
|
|
341
339
|
registerMediaElement() {
|
|
342
340
|
let media;
|
|
@@ -345,25 +343,12 @@ var DashJsP2PEngine = class {
|
|
|
345
343
|
} catch {
|
|
346
344
|
return;
|
|
347
345
|
}
|
|
348
|
-
if (
|
|
349
|
-
this.unregisterMediaElement();
|
|
350
|
-
this.media = media;
|
|
351
|
-
for (const event of PLAYBACK_EVENTS) media.addEventListener(event, this.handlePlaybackUpdate);
|
|
346
|
+
if (media) this.playback.watch(media);
|
|
352
347
|
}
|
|
353
|
-
unregisterMediaElement() {
|
|
354
|
-
const { media } = this;
|
|
355
|
-
if (!media) return;
|
|
356
|
-
for (const event of PLAYBACK_EVENTS) media.removeEventListener(event, this.handlePlaybackUpdate);
|
|
357
|
-
this.media = void 0;
|
|
358
|
-
}
|
|
359
|
-
handlePlaybackUpdate = (event) => {
|
|
360
|
-
const media = event.target;
|
|
361
|
-
this.core.updatePlayback(getPlaybackStateFromMediaElement(media));
|
|
362
|
-
};
|
|
363
348
|
/** Cleans up and releases all resources, and unregisters all event handlers. */
|
|
364
349
|
destroy() {
|
|
365
350
|
this.core.destroy();
|
|
366
|
-
this.
|
|
351
|
+
this.playback.stop();
|
|
367
352
|
if (this.player) {
|
|
368
353
|
this.player.off(STREAM_INITIALIZED, this.handleStreamInitialized);
|
|
369
354
|
this.player.off(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"p2p-media-loader-dashjs.es.js","names":[],"sources":["../src/types.ts","../src/loader.ts","../src/engine.ts"],"sourcesContent":["/**\n * The slice of dash.js's request plumbing the adapter touches, typed\n * structurally. dash.js's own declarations for these live in\n * `@svta/cml-request`, a transitive dependency this package cannot import\n * directly, and the adapter needs only a handful of fields.\n */\n\n/** `HTTPRequest.*_TYPE` values a request carries in `customData.request.type`. */\nexport const REQUEST_TYPE = {\n MPD: \"MPD\",\n INIT_SEGMENT: \"InitializationSegment\",\n MEDIA_SEGMENT: \"MediaSegment\",\n INDEX_SEGMENT: \"IndexSegment\",\n} as const;\n\n/** What `_onprogress` in dash.js's HTTPLoader reads off a progress event. */\nexport type ProgressEventLike = {\n lengthComputable: boolean;\n loaded: number;\n total: number;\n /** Trace duration in ms; dash.js uses it instead of the wall clock when set. */\n time?: number;\n};\n\n/** The dash.js `FragmentRequest` (or `TextRequest`) behind a network request. */\ntype FragmentRequestLike = {\n type?: string | null;\n url?: string | null;\n range?: string | null;\n mediaType?: string | null;\n};\n\n/** Callbacks and state dash.js's HTTPLoader hangs on a request. */\ntype RequestCustomData = {\n request?: FragmentRequestLike;\n onloadend?: () => void;\n onprogress?: (event: ProgressEventLike) => void;\n onabort?: () => void;\n ontimeout?: (event: unknown) => void;\n abort?: () => void;\n};\n\n/** `CommonMediaRequest` as HTTPLoader builds it. */\nexport type CommonMediaRequestLike = {\n url: string;\n method?: string;\n responseType?: string;\n headers?: Record<string, string | undefined>;\n customData?: RequestCustomData;\n};\n\n/** `CommonMediaResponse` as HTTPLoader expects the loader to fill it. */\nexport type CommonMediaResponseLike = {\n url?: string;\n status: number;\n statusText?: string;\n headers?: Record<string, string> | null;\n data?: unknown;\n};\n\n/** The instance dash.js's own `XHRLoader` factory produces. */\nexport type XhrLoaderLike = {\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean;\n abort(): void;\n};\n\n/**\n * What `FactoryMaker` binds as `this` when it applies an `override`\n * extension: the real instance is `parent`.\n */\nexport type FactoryMakerThis = {\n context: object;\n factory: unknown;\n parent: XhrLoaderLike;\n};\n","import {\n Core,\n CoreRequestError,\n ProcessedManifest,\n byteRangeFromRangeHeader,\n debug,\n} from \"p2p-media-loader-core\";\nimport {\n CommonMediaRequestLike,\n CommonMediaResponseLike,\n FactoryMakerThis,\n REQUEST_TYPE,\n XhrLoaderLike,\n} from \"./types.js\";\n\nexport type LoaderHooks = {\n /** Called with what the core read from each MPD, before dash.js parses it. */\n onManifestProcessed?: (manifest: ProcessedManifest) => void;\n};\n\nconst SEGMENT_TYPES: ReadonlySet<string> = new Set([\n REQUEST_TYPE.INIT_SEGMENT,\n REQUEST_TYPE.MEDIA_SEGMENT,\n REQUEST_TYPE.INDEX_SEGMENT,\n]);\n\n/**\n * The `XHRLoader` replacement, in the shape dash.js's `FactoryMaker` applies\n * it: a plain function it calls with `this.parent` set to the real loader,\n * whose `load` and `abort` the returned object overrides. Registered per\n * player through `player.extend(\"XHRLoader\", extension, true)`.\n *\n * Every request dash.js makes over HTTP passes through here — MPD, init,\n * media and index segments, licences — and is told apart by the type of the\n * `FragmentRequest` behind it. See specs/player-adapters.md, \"dash.js\".\n */\nexport function createXhrLoaderExtension(core: Core, hooks: LoaderHooks = {}) {\n return function xhrLoaderExtension(this: FactoryMakerThis): XhrLoaderLike {\n // FactoryMaker copies the returned `load` and `abort` onto the parent\n // instance itself, so `this.parent.load` would point back here once the\n // override is applied. Keep dash.js's own methods before that happens.\n const { parent } = this;\n const original: XhrLoaderLike = {\n load: parent.load.bind(parent),\n abort: parent.abort.bind(parent),\n };\n const router = new RequestRouter(core, original, hooks);\n return {\n load: (request, response) => router.load(request, response),\n abort: () => router.abort(),\n };\n };\n}\n\nclass RequestRouter {\n private readonly logger = debug(\"p2pml-dashjs:loader\");\n /** Aborts the request served by the core most recently, if still in flight. */\n private abortCurrent?: () => void;\n\n constructor(\n private readonly core: Core,\n private readonly parent: XhrLoaderLike,\n private readonly hooks: LoaderHooks,\n ) {}\n\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean {\n const type = request.customData?.request?.type ?? undefined;\n const { url } = request;\n const byteRange = byteRangeFromRangeHeader(\n request.headers?.Range ?? request.headers?.range,\n );\n\n // Every MPD dash.js fetches — first load and each refresh — reaches the\n // core before dash.js parses the same bytes.\n if (type === REQUEST_TYPE.MPD) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (typeof data !== \"string\" && !isBinary(data)) return;\n // The response URL, when the loader filled it in, follows redirects.\n const responseUrl = response.url;\n const processed = this.core.processManifest({\n url:\n responseUrl !== undefined && responseUrl !== \"\" ? responseUrl : url,\n data,\n });\n if (processed) this.hooks.onManifestProcessed?.(processed);\n });\n }\n\n if (type !== undefined && SEGMENT_TYPES.has(type)) {\n // A SegmentBase stream's index: dash.js loads it, the core reads the\n // segment list from the same bytes. Recognition, not lookup.\n if (this.core.isSegmentIndex(url, byteRange)) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (!isBinary(data)) return;\n this.core.processSegmentIndex({ url, byteRange, data });\n });\n }\n\n // Whitelist by lookup: a segment the registry knows on a stream with\n // P2P enabled is served by the core; initialization segments and\n // anything the registry does not know load through dash.js itself.\n if (\n type === REQUEST_TYPE.MEDIA_SEGMENT &&\n this.core.isSegmentLoadable(url, byteRange)\n ) {\n this.serve(request, response, byteRange);\n return true;\n }\n }\n\n // Licences, certificates, steering, XLink, init segments: untouched.\n return this.parent.load(request, response);\n }\n\n abort() {\n this.abortCurrent?.();\n this.parent.abort();\n }\n\n private passThroughAndObserve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n observe: (data: unknown) => void,\n ): boolean {\n request.customData ??= {};\n const { customData } = request;\n const original = customData.onloadend;\n // dash.js's XHRLoader copies `onloadend` onto the XHR at `load`, so the\n // wrap has to be in place before the parent runs.\n customData.onloadend = () => {\n try {\n if (response.status >= 200 && response.status <= 299) {\n observe(response.data);\n }\n } catch (error) {\n this.logger(\"failed to process %s: %O\", request.url, error);\n }\n original?.();\n };\n return this.parent.load(request, response);\n }\n\n private serve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n byteRange: ReturnType<typeof byteRangeFromRangeHeader>,\n ) {\n const { url } = request;\n request.customData ??= {};\n const { customData } = request;\n let settled = false;\n\n const abort = () => {\n if (settled) return;\n this.core.abortSegmentLoading(url, byteRange);\n };\n customData.abort = abort;\n this.abortCurrent = abort;\n\n this.core\n .loadSegment(url, { byteRange })\n .then(({ data, bandwidth }) => {\n settled = true;\n response.url = url;\n response.status = 200;\n response.statusText = \"OK\";\n response.headers = {};\n response.data = data;\n\n // dash.js measures throughput from progress traces, dropping the\n // first (it carries the latency) and summing the rest. Two events\n // give it one download trace whose duration is the core's bandwidth\n // hint — wall-clock time says nothing about the network for a segment\n // that came from a peer or from storage. Never 0 ms.\n const total = data.byteLength;\n customData.onprogress?.({\n lengthComputable: true,\n loaded: 0,\n total,\n time: 1,\n });\n customData.onprogress?.({\n lengthComputable: true,\n loaded: total,\n total,\n time: loadingTimeMs(bandwidth, total),\n });\n customData.onloadend?.();\n })\n .catch((error: unknown) => {\n settled = true;\n if (error instanceof CoreRequestError && error.type === \"aborted\") {\n customData.onabort?.();\n return;\n }\n // A non-2xx status is what dash.js's HTTPLoader retries on; the\n // failure is reported as one rather than thrown into dash.js.\n response.url = url;\n response.status = 0;\n response.statusText =\n error instanceof Error ? error.message : String(error);\n response.data = undefined;\n this.logger(\"core failed to load %s: %O\", url, error);\n customData.onloadend?.();\n });\n }\n}\n\nfunction isBinary(data: unknown): data is ArrayBuffer | ArrayBufferView {\n return data instanceof ArrayBuffer || ArrayBuffer.isView(data);\n}\n\n/** Download time in ms for the core's bandwidth hint; see the Shaka adapter. */\nfunction loadingTimeMs(bandwidth: number, bytes: number): number {\n if (bandwidth <= 0) return 1;\n return Math.max(1, Math.round((bytes * 8 * 1000) / bandwidth));\n}\n","import type { MediaPlayerClass, MediaPlayerEvents } from \"dashjs\";\nimport { dashManifestParser } from \"p2p-media-loader-core/dash\";\nimport {\n Core,\n CoreConfig,\n CoreEventMap,\n DefinedCoreConfig,\n DynamicCoreConfig,\n ProcessedManifest,\n debug,\n getPlaybackStateFromMediaElement,\n liveDelayFor,\n type LiveDelay,\n} from \"p2p-media-loader-core\";\nimport { createXhrLoaderExtension } from \"./loader.js\";\n\n/** A type for specifying dynamic configuration options that can be changed at runtime for the P2P engine's core. */\nexport type DynamicDashJsP2PEngineConfig = {\n /** Dynamic core config */\n core?: DynamicCoreConfig;\n};\n\n/** Represents the complete configuration for the `DashJsP2PEngine`. */\nexport type DashJsP2PEngineConfig = {\n /** Complete core configuration settings. */\n core: DefinedCoreConfig;\n};\n\n/** Allows for partial configuration settings for the `DashJsP2PEngine`. */\nexport type PartialDashJsP2PEngineConfig = {\n /** Partial core config */\n core?: Partial<CoreConfig>;\n};\n\n/**\n * Live delay until the first live manifest says how wide the window is; from\n * then on the delay follows the window (see the core's liveDelayFor). Only\n * applied when the integrator left dash.js's own default in place.\n */\nconst INITIAL_LIVE_EDGE_DELAY = 25;\n\n/** Least forward buffer to leave the player, whatever the windows work out to. */\nconst MIN_BUFFER_SEGMENTS = 2;\n/** Segments left between the player's forward buffer and the live edge. */\nconst LIVE_EDGE_MARGIN_SEGMENTS = 1;\n\nconst STREAM_INITIALIZED: MediaPlayerEvents[\"STREAM_INITIALIZED\"] =\n \"streamInitialized\";\nconst STREAM_TEARDOWN_COMPLETE: MediaPlayerEvents[\"STREAM_TEARDOWN_COMPLETE\"] =\n \"streamTeardownComplete\";\n\n// Every event after which the buffer ahead of the playhead or the rate may\n// have changed. `progress` covers buffer growth without playhead movement.\nconst PLAYBACK_EVENTS = [\n \"timeupdate\",\n \"progress\",\n \"seeking\",\n \"seeked\",\n \"ratechange\",\n \"play\",\n \"pause\",\n \"waiting\",\n] as const;\n\n/**\n * Represents a Peer-to-Peer (P2P) engine designed to enhance media streaming efficiency.\n * This class integrates P2P technologies into dash.js, enabling the distribution of media segments via a peer network\n * alongside traditional HTTP fetching. This reduces server bandwidth costs and improves scalability by sharing the load\n * across multiple clients.\n *\n * The engine has three responsibilities (see specs/player-adapters.md): it\n * hands every MPD dash.js fetches to the core, routes segment requests\n * through the core, and reports playback state from the media element. dash.js's\n * own manifest parsing runs untouched; the core parses the same bytes itself.\n *\n * @example\n * const player = dashjs.MediaPlayer().create();\n * const engine = new DashJsP2PEngine({\n * core: {\n * swarmId: \"example-swarm-id\",\n * announceTrackers: [\"wss://personal.tracker.com\"],\n * },\n * });\n * engine.bindPlayer(player); // before initialize()\n * player.initialize(videoElement, manifestUrl, true);\n */\nexport class DashJsP2PEngine {\n private player?: MediaPlayerClass;\n private media?: HTMLMediaElement;\n private readonly core: Core;\n /** False when the integrator configured a live delay themselves. */\n private managesLiveDelay = false;\n private readonly debug = debug(\"p2pml-dashjs:engine\");\n\n /**\n * Constructs an instance of `DashJsP2PEngine`.\n *\n * @param config An optional configuration for customizing the P2P engine's behavior.\n */\n constructor(config?: PartialDashJsP2PEngineConfig) {\n this.core = new Core({\n ...config?.core,\n // dash.js plays DASH only, so its bundle carries the DASH parser only.\n manifestParsers: config?.core?.manifestParsers ?? [dashManifestParser],\n });\n }\n\n /**\n * Hooks the engine into a dash.js player. Call before `player.initialize()`:\n * the engine replaces the player's `XHRLoader` through `player.extend`,\n * which dash.js resolves when it first loads.\n *\n * @param player The dash.js `MediaPlayer` instance.\n */\n bindPlayer(player: MediaPlayerClass) {\n if (this.player === player) return;\n if (this.player) this.destroy();\n this.player = player;\n\n const liveDelay = player.getSettings().streaming?.delay?.liveDelay;\n this.managesLiveDelay = liveDelay === undefined || Number.isNaN(liveDelay);\n if (this.managesLiveDelay) {\n player.updateSettings({\n streaming: {\n delay: {\n liveDelay: INITIAL_LIVE_EDGE_DELAY,\n // A server's suggestion places the player near the edge, where\n // there is nothing to share.\n useSuggestedPresentationDelay: false,\n },\n },\n });\n }\n\n player.extend(\n \"XHRLoader\",\n createXhrLoaderExtension(this.core, {\n onManifestProcessed: this.applyLivePlacement,\n }),\n true,\n );\n\n player.on(STREAM_INITIALIZED, this.handleStreamInitialized);\n player.on(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n this.registerMediaElement();\n }\n\n /**\n * Applies dynamic configuration updates to the P2P engine.\n *\n * @param dynamicConfig The configuration changes to apply.\n */\n applyDynamicConfig(dynamicConfig: DynamicDashJsP2PEngineConfig) {\n if (dynamicConfig.core) this.core.applyDynamicConfig(dynamicConfig.core);\n }\n\n /**\n * Retrieves the current configuration of the `DashJsP2PEngine`.\n *\n * @returns The configuration as a readonly object.\n */\n getConfig(): DashJsP2PEngineConfig {\n return { core: this.core.getConfig() };\n }\n\n /**\n * Adds an event listener for the specified event.\n * @param eventName The name of the event to listen for.\n * @param listener The callback function to be invoked when the event is triggered.\n *\n * @example\n * engine.addEventListener('onSegmentLoaded', (details) => {\n * console.log('Segment Loaded:', details);\n * });\n */\n addEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.addEventListener(eventName, listener);\n }\n\n /**\n * Removes an event listener for the specified event.\n * @param eventName The name of the event.\n * @param listener The callback function that was previously added.\n */\n removeEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.removeEventListener(eventName, listener);\n }\n\n /**\n * Places the player in the live window from the window the core just\n * parsed: how far behind the edge it plays, and how far ahead of the\n * playhead it may fetch. The MPD reaches the core before dash.js parses the\n * same bytes, so both are in place when dash.js computes its live position.\n * Re-applied only when the window changes by at least half a segment.\n */\n private applyLivePlacement = (manifest: ProcessedManifest) => {\n if (!this.player || !this.managesLiveDelay) return;\n const target = liveDelayFor(manifest);\n if (!target) return;\n\n const current = this.player.getSettings().streaming?.delay?.liveDelay;\n if (\n current !== undefined &&\n !Number.isNaN(current) &&\n Math.abs(current - target.delay) < target.segment / 2\n ) {\n return;\n }\n\n const buffer = this.forwardBufferSettings(target);\n this.debug(\n `Setting liveDelay to ${target.delay}, forward buffer to ${buffer.bufferTimeDefault}`,\n );\n this.player.updateSettings({\n streaming: { delay: { liveDelay: target.delay }, buffer },\n });\n };\n\n /**\n * How far ahead of the playhead dash.js may fetch: the high-demand window,\n * never closer to the live edge than a segment, never less than a couple of\n * segments. The segments beyond it are the core's to prefetch, and they are\n * the ones peers exchange.\n *\n * Left alone, dash.js buffers `bufferTimeAtTopQualityLongForm` — a minute,\n * since a dynamic stream is long-form by its duration — which on a live\n * stream is the whole window. Its playhead then sits a live delay behind the\n * edge while its *fetch* position rides the edge itself, where the registry\n * cannot yet know the segment: core learns of one only when dash.js refreshes\n * the MPD, and dash.js derives availability from its own synced clock. Every\n * such request misses the registry and falls through to dash.js's own loader,\n * so the stream plays perfectly with no P2P at all.\n *\n * Settings the integrator already holds below this are left alone; the value\n * is a ceiling, not a target.\n */\n private forwardBufferSettings(target: LiveDelay) {\n const { mainStream, secondaryStream } = this.core.getConfig();\n const highDemandTimeWindow = Math.max(\n mainStream.highDemandTimeWindow,\n secondaryStream.highDemandTimeWindow,\n );\n const bufferTime = Math.max(\n target.segment * MIN_BUFFER_SEGMENTS,\n Math.min(\n highDemandTimeWindow,\n target.delay - target.segment * LIVE_EDGE_MARGIN_SEGMENTS,\n ),\n );\n\n const current = this.player?.getSettings().streaming?.buffer;\n const lower = (setting: number | undefined) =>\n setting === undefined || Number.isNaN(setting) || setting > bufferTime\n ? bufferTime\n : setting;\n\n return {\n bufferTimeDefault: lower(current?.bufferTimeDefault),\n bufferTimeAtTopQuality: lower(current?.bufferTimeAtTopQuality),\n bufferTimeAtTopQualityLongForm: lower(\n current?.bufferTimeAtTopQualityLongForm,\n ),\n };\n }\n\n private handleStreamInitialized = () => {\n this.registerMediaElement();\n };\n\n private handleStreamTeardown = () => {\n this.core.destroy();\n this.unregisterMediaElement();\n };\n\n private registerMediaElement() {\n let media: HTMLMediaElement | undefined;\n try {\n // Throws until a view is attached.\n media = this.player?.getVideoElement();\n } catch {\n return;\n }\n if (!media || media === this.media) return;\n this.unregisterMediaElement();\n this.media = media;\n for (const event of PLAYBACK_EVENTS) {\n media.addEventListener(event, this.handlePlaybackUpdate);\n }\n }\n\n private unregisterMediaElement() {\n const { media } = this;\n if (!media) return;\n for (const event of PLAYBACK_EVENTS) {\n media.removeEventListener(event, this.handlePlaybackUpdate);\n }\n this.media = undefined;\n }\n\n private handlePlaybackUpdate = (event: Event) => {\n const media = event.target as HTMLMediaElement;\n this.core.updatePlayback(getPlaybackStateFromMediaElement(media));\n };\n\n /** Cleans up and releases all resources, and unregisters all event handlers. */\n destroy() {\n this.core.destroy();\n this.unregisterMediaElement();\n if (this.player) {\n this.player.off(STREAM_INITIALIZED, this.handleStreamInitialized);\n this.player.off(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n }\n this.player = undefined;\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"p2p-media-loader-dashjs.es.js","names":[],"sources":["../src/types.ts","../src/loader.ts","../src/engine.ts"],"sourcesContent":["/**\n * The slice of dash.js's request plumbing the adapter touches, typed\n * structurally. dash.js's own declarations for these live in\n * `@svta/cml-request`, a transitive dependency this package cannot import\n * directly, and the adapter needs only a handful of fields.\n */\n\n/** `HTTPRequest.*_TYPE` values a request carries in `customData.request.type`. */\nexport const REQUEST_TYPE = {\n MPD: \"MPD\",\n INIT_SEGMENT: \"InitializationSegment\",\n MEDIA_SEGMENT: \"MediaSegment\",\n INDEX_SEGMENT: \"IndexSegment\",\n} as const;\n\n/** What `_onprogress` in dash.js's HTTPLoader reads off a progress event. */\nexport type ProgressEventLike = {\n lengthComputable: boolean;\n loaded: number;\n total: number;\n /** Trace duration in ms; dash.js uses it instead of the wall clock when set. */\n time?: number;\n};\n\n/** The dash.js `FragmentRequest` (or `TextRequest`) behind a network request. */\ntype FragmentRequestLike = {\n type?: string | null;\n url?: string | null;\n range?: string | null;\n mediaType?: string | null;\n};\n\n/** Callbacks and state dash.js's HTTPLoader hangs on a request. */\ntype RequestCustomData = {\n request?: FragmentRequestLike;\n onloadend?: () => void;\n onprogress?: (event: ProgressEventLike) => void;\n onabort?: () => void;\n ontimeout?: (event: unknown) => void;\n abort?: () => void;\n};\n\n/** `CommonMediaRequest` as HTTPLoader builds it. */\nexport type CommonMediaRequestLike = {\n url: string;\n method?: string;\n responseType?: string;\n headers?: Record<string, string | undefined>;\n customData?: RequestCustomData;\n};\n\n/** `CommonMediaResponse` as HTTPLoader expects the loader to fill it. */\nexport type CommonMediaResponseLike = {\n url?: string;\n status: number;\n statusText?: string;\n headers?: Record<string, string> | null;\n data?: unknown;\n};\n\n/** The instance dash.js's own `XHRLoader` factory produces. */\nexport type XhrLoaderLike = {\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean;\n abort(): void;\n};\n\n/**\n * What `FactoryMaker` binds as `this` when it applies an `override`\n * extension: the real instance is `parent`.\n */\nexport type FactoryMakerThis = {\n context: object;\n factory: unknown;\n parent: XhrLoaderLike;\n};\n","import {\n Core,\n CoreRequestError,\n ProcessedManifest,\n byteRangeFromRangeHeader,\n debug,\n} from \"p2p-media-loader-core\";\nimport {\n CommonMediaRequestLike,\n CommonMediaResponseLike,\n FactoryMakerThis,\n REQUEST_TYPE,\n XhrLoaderLike,\n} from \"./types.js\";\n\nexport type LoaderHooks = {\n /** Called with what the core read from each MPD, before dash.js parses it. */\n onManifestProcessed?: (manifest: ProcessedManifest) => void;\n};\n\nconst SEGMENT_TYPES: ReadonlySet<string> = new Set([\n REQUEST_TYPE.INIT_SEGMENT,\n REQUEST_TYPE.MEDIA_SEGMENT,\n REQUEST_TYPE.INDEX_SEGMENT,\n]);\n\n/**\n * The `XHRLoader` replacement, in the shape dash.js's `FactoryMaker` applies\n * it: a plain function it calls with `this.parent` set to the real loader,\n * whose `load` and `abort` the returned object overrides. Registered per\n * player through `player.extend(\"XHRLoader\", extension, true)`.\n *\n * Every request dash.js makes over HTTP passes through here — MPD, init,\n * media and index segments, licences — and is told apart by the type of the\n * `FragmentRequest` behind it. See specs/player-adapters.md, \"dash.js\".\n */\nexport function createXhrLoaderExtension(core: Core, hooks: LoaderHooks = {}) {\n return function xhrLoaderExtension(this: FactoryMakerThis): XhrLoaderLike {\n // FactoryMaker copies the returned `load` and `abort` onto the parent\n // instance itself, so `this.parent.load` would point back here once the\n // override is applied. Keep dash.js's own methods before that happens.\n const { parent } = this;\n const original: XhrLoaderLike = {\n load: parent.load.bind(parent),\n abort: parent.abort.bind(parent),\n };\n const router = new RequestRouter(core, original, hooks);\n return {\n load: (request, response) => router.load(request, response),\n abort: () => router.abort(),\n };\n };\n}\n\nclass RequestRouter {\n private readonly logger = debug(\"p2pml-dashjs:loader\");\n /** Aborts the request served by the core most recently, if still in flight. */\n private abortCurrent?: () => void;\n\n constructor(\n private readonly core: Core,\n private readonly parent: XhrLoaderLike,\n private readonly hooks: LoaderHooks,\n ) {}\n\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean {\n const type = request.customData?.request?.type ?? undefined;\n const { url } = request;\n const byteRange = byteRangeFromRangeHeader(\n request.headers?.Range ?? request.headers?.range,\n );\n\n // Every MPD dash.js fetches — first load and each refresh — reaches the\n // core before dash.js parses the same bytes.\n if (type === REQUEST_TYPE.MPD) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (typeof data !== \"string\" && !isBinary(data)) return;\n // The response URL, when the loader filled it in, follows redirects.\n const responseUrl = response.url;\n const processed = this.core.processManifest({\n url:\n responseUrl !== undefined && responseUrl !== \"\" ? responseUrl : url,\n requestedUrl: url,\n data,\n });\n if (processed) this.hooks.onManifestProcessed?.(processed);\n });\n }\n\n if (type !== undefined && SEGMENT_TYPES.has(type)) {\n // A SegmentBase stream's index: dash.js loads it, the core reads the\n // segment list from the same bytes. Recognition, not lookup.\n if (this.core.isSegmentIndex(url, byteRange)) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (!isBinary(data)) return;\n this.core.processSegmentIndex({ url, byteRange, data });\n });\n }\n\n // Whitelist by lookup: a segment the registry knows on a stream with\n // P2P enabled is served by the core; initialization segments and\n // anything the registry does not know load through dash.js itself.\n if (\n type === REQUEST_TYPE.MEDIA_SEGMENT &&\n this.core.isSegmentLoadable(url, byteRange)\n ) {\n this.serve(request, response, byteRange);\n return true;\n }\n }\n\n // Licences, certificates, steering, XLink, init segments: untouched.\n return this.parent.load(request, response);\n }\n\n abort() {\n this.abortCurrent?.();\n this.parent.abort();\n }\n\n private passThroughAndObserve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n observe: (data: unknown) => void,\n ): boolean {\n request.customData ??= {};\n const { customData } = request;\n const original = customData.onloadend;\n // dash.js's XHRLoader copies `onloadend` onto the XHR at `load`, so the\n // wrap has to be in place before the parent runs.\n customData.onloadend = () => {\n try {\n if (response.status >= 200 && response.status <= 299) {\n observe(response.data);\n }\n } catch (error) {\n this.logger(\"failed to process %s: %O\", request.url, error);\n }\n original?.();\n };\n return this.parent.load(request, response);\n }\n\n private serve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n byteRange: ReturnType<typeof byteRangeFromRangeHeader>,\n ) {\n const { url } = request;\n request.customData ??= {};\n const { customData } = request;\n let settled = false;\n let aborted = false;\n\n const abort = () => {\n if (settled) return;\n aborted = true;\n this.core.abortSegmentLoading(url, byteRange);\n };\n customData.abort = abort;\n this.abortCurrent = abort;\n\n this.core\n .loadSegment(url, { byteRange })\n .then(({ data, bandwidth }) => {\n // The core cannot always cancel in time — a request waiting for the\n // segment storage has no loader yet — so what dash.js has abandoned\n // is dropped here rather than reported as a download.\n if (aborted) {\n settled = true;\n customData.onabort?.();\n return;\n }\n settled = true;\n response.url = url;\n response.status = 200;\n response.statusText = \"OK\";\n response.headers = {};\n response.data = data;\n\n // dash.js measures throughput from progress traces, dropping the\n // first (it carries the latency) and summing the rest. Two events\n // give it one download trace whose duration is the core's bandwidth\n // hint — wall-clock time says nothing about the network for a segment\n // that came from a peer or from storage. Never 0 ms.\n const total = data.byteLength;\n customData.onprogress?.({\n lengthComputable: true,\n loaded: 0,\n total,\n time: 1,\n });\n customData.onprogress?.({\n lengthComputable: true,\n loaded: total,\n total,\n time: loadingTimeMs(bandwidth, total),\n });\n customData.onloadend?.();\n })\n .catch((error: unknown) => {\n settled = true;\n if (error instanceof CoreRequestError && error.type === \"aborted\") {\n customData.onabort?.();\n return;\n }\n // A non-2xx status is what dash.js's HTTPLoader retries on; the\n // failure is reported as one rather than thrown into dash.js.\n response.url = url;\n response.status = 0;\n response.statusText =\n error instanceof Error ? error.message : String(error);\n response.data = undefined;\n this.logger(\"core failed to load %s: %O\", url, error);\n customData.onloadend?.();\n });\n }\n}\n\nfunction isBinary(data: unknown): data is ArrayBuffer | ArrayBufferView {\n return data instanceof ArrayBuffer || ArrayBuffer.isView(data);\n}\n\n/** Download time in ms for the core's bandwidth hint; see the Shaka adapter. */\nfunction loadingTimeMs(bandwidth: number, bytes: number): number {\n if (bandwidth <= 0) return 1;\n return Math.max(1, Math.round((bytes * 8 * 1000) / bandwidth));\n}\n","import type { MediaPlayerClass, MediaPlayerEvents } from \"dashjs\";\nimport { dashManifestParser } from \"p2p-media-loader-core/dash\";\nimport {\n Core,\n CoreConfig,\n CoreEventMap,\n DefinedCoreConfig,\n DynamicCoreConfig,\n ProcessedManifest,\n debug,\n trackMediaElementPlayback,\n liveDelayFor,\n type LiveDelay,\n} from \"p2p-media-loader-core\";\nimport { createXhrLoaderExtension } from \"./loader.js\";\n\n/** A type for specifying dynamic configuration options that can be changed at runtime for the P2P engine's core. */\nexport type DynamicDashJsP2PEngineConfig = {\n /** Dynamic core config */\n core?: DynamicCoreConfig;\n};\n\n/** Represents the complete configuration for the `DashJsP2PEngine`. */\nexport type DashJsP2PEngineConfig = {\n /** Complete core configuration settings. */\n core: DefinedCoreConfig;\n};\n\n/** Allows for partial configuration settings for the `DashJsP2PEngine`. */\nexport type PartialDashJsP2PEngineConfig = {\n /** Partial core config */\n core?: Partial<CoreConfig>;\n};\n\n/**\n * Live delay until the first live manifest says how wide the window is; from\n * then on the delay follows the window (see the core's liveDelayFor). Only\n * applied when the integrator left dash.js's own default in place.\n */\nconst INITIAL_LIVE_EDGE_DELAY = 25;\n\n/** Least forward buffer to leave the player, whatever the windows work out to. */\nconst MIN_BUFFER_SEGMENTS = 2;\n/** Segments left between the player's forward buffer and the live edge. */\nconst LIVE_EDGE_MARGIN_SEGMENTS = 1;\n\nconst STREAM_INITIALIZED: MediaPlayerEvents[\"STREAM_INITIALIZED\"] =\n \"streamInitialized\";\nconst STREAM_TEARDOWN_COMPLETE: MediaPlayerEvents[\"STREAM_TEARDOWN_COMPLETE\"] =\n \"streamTeardownComplete\";\n\n/**\n * Represents a Peer-to-Peer (P2P) engine designed to enhance media streaming efficiency.\n * This class integrates P2P technologies into dash.js, enabling the distribution of media segments via a peer network\n * alongside traditional HTTP fetching. This reduces server bandwidth costs and improves scalability by sharing the load\n * across multiple clients.\n *\n * The engine has three responsibilities (see specs/player-adapters.md): it\n * hands every MPD dash.js fetches to the core, routes segment requests\n * through the core, and reports playback state from the media element. dash.js's\n * own manifest parsing runs untouched; the core parses the same bytes itself.\n *\n * @example\n * const player = dashjs.MediaPlayer().create();\n * const engine = new DashJsP2PEngine({\n * core: {\n * swarmId: \"example-swarm-id\",\n * announceTrackers: [\"wss://personal.tracker.com\"],\n * },\n * });\n * engine.bindPlayer(player); // before initialize()\n * player.initialize(videoElement, manifestUrl, true);\n */\nexport class DashJsP2PEngine {\n private player?: MediaPlayerClass;\n private readonly playback = trackMediaElementPlayback((state) =>\n this.core.updatePlayback(state),\n );\n private readonly core: Core;\n /** False when the integrator configured a live delay themselves. */\n private managesLiveDelay = false;\n private readonly debug = debug(\"p2pml-dashjs:engine\");\n\n /**\n * Constructs an instance of `DashJsP2PEngine`.\n *\n * @param config An optional configuration for customizing the P2P engine's behavior.\n */\n constructor(config?: PartialDashJsP2PEngineConfig) {\n this.core = new Core({\n ...config?.core,\n // dash.js plays DASH only, so its bundle carries the DASH parser only.\n manifestParsers: config?.core?.manifestParsers ?? [dashManifestParser],\n });\n }\n\n /**\n * Hooks the engine into a dash.js player. Call before `player.initialize()`:\n * the engine replaces the player's `XHRLoader` through `player.extend`,\n * which dash.js resolves when it first loads.\n *\n * @param player The dash.js `MediaPlayer` instance.\n */\n bindPlayer(player: MediaPlayerClass) {\n if (this.player === player) return;\n if (this.player) this.destroy();\n this.player = player;\n\n const liveDelay = player.getSettings().streaming?.delay?.liveDelay;\n this.managesLiveDelay = liveDelay === undefined || Number.isNaN(liveDelay);\n if (this.managesLiveDelay) {\n player.updateSettings({\n streaming: {\n delay: {\n liveDelay: INITIAL_LIVE_EDGE_DELAY,\n // A server's suggestion places the player near the edge, where\n // there is nothing to share.\n useSuggestedPresentationDelay: false,\n },\n },\n });\n }\n\n player.extend(\n \"XHRLoader\",\n createXhrLoaderExtension(this.core, {\n onManifestProcessed: this.applyLivePlacement,\n }),\n true,\n );\n\n player.on(STREAM_INITIALIZED, this.handleStreamInitialized);\n player.on(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n this.registerMediaElement();\n }\n\n /**\n * Applies dynamic configuration updates to the P2P engine.\n *\n * @param dynamicConfig The configuration changes to apply.\n */\n applyDynamicConfig(dynamicConfig: DynamicDashJsP2PEngineConfig) {\n if (dynamicConfig.core) this.core.applyDynamicConfig(dynamicConfig.core);\n }\n\n /**\n * Retrieves the current configuration of the `DashJsP2PEngine`.\n *\n * @returns The configuration as a readonly object.\n */\n getConfig(): DashJsP2PEngineConfig {\n return { core: this.core.getConfig() };\n }\n\n /**\n * Adds an event listener for the specified event.\n * @param eventName The name of the event to listen for.\n * @param listener The callback function to be invoked when the event is triggered.\n *\n * @example\n * engine.addEventListener('onSegmentLoaded', (details) => {\n * console.log('Segment Loaded:', details);\n * });\n */\n addEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.addEventListener(eventName, listener);\n }\n\n /**\n * Removes an event listener for the specified event.\n * @param eventName The name of the event.\n * @param listener The callback function that was previously added.\n */\n removeEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.removeEventListener(eventName, listener);\n }\n\n /**\n * Places the player in the live window from the window the core just\n * parsed: how far behind the edge it plays, and how far ahead of the\n * playhead it may fetch. The MPD reaches the core before dash.js parses the\n * same bytes, so both are in place when dash.js computes its live position.\n * Re-applied only when the window changes by at least half a segment.\n */\n private applyLivePlacement = (manifest: ProcessedManifest) => {\n if (!this.player || !this.managesLiveDelay) return;\n const target = liveDelayFor(manifest);\n if (!target) return;\n\n const current = this.player.getSettings().streaming?.delay?.liveDelay;\n if (\n current !== undefined &&\n !Number.isNaN(current) &&\n Math.abs(current - target.delay) < target.segment / 2\n ) {\n return;\n }\n\n const buffer = this.forwardBufferSettings(target);\n this.debug(\n `Setting liveDelay to ${target.delay}, forward buffer to ${buffer.bufferTimeDefault}`,\n );\n this.player.updateSettings({\n streaming: { delay: { liveDelay: target.delay }, buffer },\n });\n };\n\n /**\n * How far ahead of the playhead dash.js may fetch: the high-demand window,\n * never closer to the live edge than a segment, never less than a couple of\n * segments. The segments beyond it are the core's to prefetch, and they are\n * the ones peers exchange.\n *\n * Left alone, dash.js buffers `bufferTimeAtTopQualityLongForm` — a minute,\n * since a dynamic stream is long-form by its duration — which on a live\n * stream is the whole window. Its playhead then sits a live delay behind the\n * edge while its *fetch* position rides the edge itself, where the registry\n * cannot yet know the segment: core learns of one only when dash.js refreshes\n * the MPD, and dash.js derives availability from its own synced clock. Every\n * such request misses the registry and falls through to dash.js's own loader,\n * so the stream plays perfectly with no P2P at all.\n *\n * Settings the integrator already holds below this are left alone; the value\n * is a ceiling, not a target.\n */\n private forwardBufferSettings(target: LiveDelay) {\n const { mainStream, secondaryStream } = this.core.getConfig();\n const highDemandTimeWindow = Math.max(\n mainStream.highDemandTimeWindow,\n secondaryStream.highDemandTimeWindow,\n );\n const bufferTime = Math.max(\n target.segment * MIN_BUFFER_SEGMENTS,\n Math.min(\n highDemandTimeWindow,\n target.delay - target.segment * LIVE_EDGE_MARGIN_SEGMENTS,\n ),\n );\n\n const current = this.player?.getSettings().streaming?.buffer;\n const lower = (setting: number | undefined) =>\n setting === undefined || Number.isNaN(setting) || setting > bufferTime\n ? bufferTime\n : setting;\n\n return {\n bufferTimeDefault: lower(current?.bufferTimeDefault),\n bufferTimeAtTopQuality: lower(current?.bufferTimeAtTopQuality),\n bufferTimeAtTopQualityLongForm: lower(\n current?.bufferTimeAtTopQualityLongForm,\n ),\n };\n }\n\n private handleStreamInitialized = () => {\n this.registerMediaElement();\n };\n\n private handleStreamTeardown = () => {\n this.core.destroy();\n this.playback.stop();\n };\n\n private registerMediaElement() {\n let media: HTMLMediaElement | undefined;\n try {\n // Throws until a view is attached.\n media = this.player?.getVideoElement();\n } catch {\n return;\n }\n if (media) this.playback.watch(media);\n }\n\n /** Cleans up and releases all resources, and unregisters all event handlers. */\n destroy() {\n this.core.destroy();\n this.playback.stop();\n if (this.player) {\n this.player.off(STREAM_INITIALIZED, this.handleStreamInitialized);\n this.player.off(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n }\n this.player = undefined;\n }\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { dashManifestParser as e } from "p2p-media-loader-core/dash";
|
|
2
|
-
import { Core as t, Core as n, CoreRequestError as r, byteRangeFromRangeHeader as i, debug as a,
|
|
2
|
+
import { Core as t, Core as n, CoreRequestError as r, byteRangeFromRangeHeader as i, debug as a, liveDelayFor as o, trackMediaElementPlayback as s } from "p2p-media-loader-core";
|
|
3
3
|
//#region src/types.ts
|
|
4
4
|
var c = {
|
|
5
5
|
MPD: "MPD",
|
|
@@ -38,6 +38,7 @@ var d = class {
|
|
|
38
38
|
if (typeof e != "string" && !f(e)) return;
|
|
39
39
|
let n = t.url, i = this.core.processManifest({
|
|
40
40
|
url: n !== void 0 && n !== "" ? n : r,
|
|
41
|
+
requestedUrl: r,
|
|
41
42
|
data: e
|
|
42
43
|
});
|
|
43
44
|
i && this.hooks.onManifestProcessed?.(i);
|
|
@@ -72,10 +73,14 @@ var d = class {
|
|
|
72
73
|
serve(e, t, n) {
|
|
73
74
|
let { url: i } = e;
|
|
74
75
|
e.customData ??= {};
|
|
75
|
-
let { customData: a } = e, o = !1, s = () => {
|
|
76
|
-
o || this.core.abortSegmentLoading(i, n);
|
|
76
|
+
let { customData: a } = e, o = !1, s = !1, c = () => {
|
|
77
|
+
o || (s = !0, this.core.abortSegmentLoading(i, n));
|
|
77
78
|
};
|
|
78
|
-
a.abort =
|
|
79
|
+
a.abort = c, this.abortCurrent = c, this.core.loadSegment(i, { byteRange: n }).then(({ data: e, bandwidth: n }) => {
|
|
80
|
+
if (s) {
|
|
81
|
+
o = !0, a.onabort?.();
|
|
82
|
+
return;
|
|
83
|
+
}
|
|
79
84
|
o = !0, t.url = i, t.status = 200, t.statusText = "OK", t.headers = {}, t.data = e;
|
|
80
85
|
let r = e.byteLength;
|
|
81
86
|
a.onprogress?.({
|
|
@@ -106,18 +111,9 @@ function p(e, t) {
|
|
|
106
111
|
}
|
|
107
112
|
//#endregion
|
|
108
113
|
//#region src/engine.ts
|
|
109
|
-
var m = 25, h = 2, g = 1, _ = "streamInitialized", v = "streamTeardownComplete", y =
|
|
110
|
-
"timeupdate",
|
|
111
|
-
"progress",
|
|
112
|
-
"seeking",
|
|
113
|
-
"seeked",
|
|
114
|
-
"ratechange",
|
|
115
|
-
"play",
|
|
116
|
-
"pause",
|
|
117
|
-
"waiting"
|
|
118
|
-
], b = class {
|
|
114
|
+
var m = 25, h = 2, g = 1, _ = "streamInitialized", v = "streamTeardownComplete", y = class {
|
|
119
115
|
player;
|
|
120
|
-
|
|
116
|
+
playback = s((e) => this.core.updatePlayback(e));
|
|
121
117
|
core;
|
|
122
118
|
managesLiveDelay = !1;
|
|
123
119
|
debug = a("p2pml-dashjs:engine");
|
|
@@ -150,7 +146,7 @@ var m = 25, h = 2, g = 1, _ = "streamInitialized", v = "streamTeardownComplete",
|
|
|
150
146
|
}
|
|
151
147
|
applyLivePlacement = (e) => {
|
|
152
148
|
if (!this.player || !this.managesLiveDelay) return;
|
|
153
|
-
let t =
|
|
149
|
+
let t = o(e);
|
|
154
150
|
if (!t) return;
|
|
155
151
|
let n = this.player.getSettings().streaming?.delay?.liveDelay;
|
|
156
152
|
if (n !== void 0 && !Number.isNaN(n) && Math.abs(n - t.delay) < t.segment / 2) return;
|
|
@@ -172,7 +168,7 @@ var m = 25, h = 2, g = 1, _ = "streamInitialized", v = "streamTeardownComplete",
|
|
|
172
168
|
this.registerMediaElement();
|
|
173
169
|
};
|
|
174
170
|
handleStreamTeardown = () => {
|
|
175
|
-
this.core.destroy(), this.
|
|
171
|
+
this.core.destroy(), this.playback.stop();
|
|
176
172
|
};
|
|
177
173
|
registerMediaElement() {
|
|
178
174
|
let e;
|
|
@@ -181,27 +177,13 @@ var m = 25, h = 2, g = 1, _ = "streamInitialized", v = "streamTeardownComplete",
|
|
|
181
177
|
} catch {
|
|
182
178
|
return;
|
|
183
179
|
}
|
|
184
|
-
|
|
185
|
-
this.unregisterMediaElement(), this.media = e;
|
|
186
|
-
for (let t of y) e.addEventListener(t, this.handlePlaybackUpdate);
|
|
187
|
-
}
|
|
180
|
+
e && this.playback.watch(e);
|
|
188
181
|
}
|
|
189
|
-
unregisterMediaElement() {
|
|
190
|
-
let { media: e } = this;
|
|
191
|
-
if (e) {
|
|
192
|
-
for (let t of y) e.removeEventListener(t, this.handlePlaybackUpdate);
|
|
193
|
-
this.media = void 0;
|
|
194
|
-
}
|
|
195
|
-
}
|
|
196
|
-
handlePlaybackUpdate = (e) => {
|
|
197
|
-
let t = e.target;
|
|
198
|
-
this.core.updatePlayback(o(t));
|
|
199
|
-
};
|
|
200
182
|
destroy() {
|
|
201
|
-
this.core.destroy(), this.
|
|
183
|
+
this.core.destroy(), this.playback.stop(), this.player && (this.player.off(_, this.handleStreamInitialized), this.player.off(v, this.handleStreamTeardown)), this.player = void 0;
|
|
202
184
|
}
|
|
203
185
|
};
|
|
204
186
|
//#endregion
|
|
205
|
-
export { t as Core,
|
|
187
|
+
export { t as Core, y as DashJsP2PEngine };
|
|
206
188
|
|
|
207
189
|
//# sourceMappingURL=p2p-media-loader-dashjs.es.min.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"p2p-media-loader-dashjs.es.min.js","names":[],"sources":["../src/types.ts","../src/loader.ts","../src/engine.ts"],"sourcesContent":["/**\n * The slice of dash.js's request plumbing the adapter touches, typed\n * structurally. dash.js's own declarations for these live in\n * `@svta/cml-request`, a transitive dependency this package cannot import\n * directly, and the adapter needs only a handful of fields.\n */\n\n/** `HTTPRequest.*_TYPE` values a request carries in `customData.request.type`. */\nexport const REQUEST_TYPE = {\n MPD: \"MPD\",\n INIT_SEGMENT: \"InitializationSegment\",\n MEDIA_SEGMENT: \"MediaSegment\",\n INDEX_SEGMENT: \"IndexSegment\",\n} as const;\n\n/** What `_onprogress` in dash.js's HTTPLoader reads off a progress event. */\nexport type ProgressEventLike = {\n lengthComputable: boolean;\n loaded: number;\n total: number;\n /** Trace duration in ms; dash.js uses it instead of the wall clock when set. */\n time?: number;\n};\n\n/** The dash.js `FragmentRequest` (or `TextRequest`) behind a network request. */\ntype FragmentRequestLike = {\n type?: string | null;\n url?: string | null;\n range?: string | null;\n mediaType?: string | null;\n};\n\n/** Callbacks and state dash.js's HTTPLoader hangs on a request. */\ntype RequestCustomData = {\n request?: FragmentRequestLike;\n onloadend?: () => void;\n onprogress?: (event: ProgressEventLike) => void;\n onabort?: () => void;\n ontimeout?: (event: unknown) => void;\n abort?: () => void;\n};\n\n/** `CommonMediaRequest` as HTTPLoader builds it. */\nexport type CommonMediaRequestLike = {\n url: string;\n method?: string;\n responseType?: string;\n headers?: Record<string, string | undefined>;\n customData?: RequestCustomData;\n};\n\n/** `CommonMediaResponse` as HTTPLoader expects the loader to fill it. */\nexport type CommonMediaResponseLike = {\n url?: string;\n status: number;\n statusText?: string;\n headers?: Record<string, string> | null;\n data?: unknown;\n};\n\n/** The instance dash.js's own `XHRLoader` factory produces. */\nexport type XhrLoaderLike = {\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean;\n abort(): void;\n};\n\n/**\n * What `FactoryMaker` binds as `this` when it applies an `override`\n * extension: the real instance is `parent`.\n */\nexport type FactoryMakerThis = {\n context: object;\n factory: unknown;\n parent: XhrLoaderLike;\n};\n","import {\n Core,\n CoreRequestError,\n ProcessedManifest,\n byteRangeFromRangeHeader,\n debug,\n} from \"p2p-media-loader-core\";\nimport {\n CommonMediaRequestLike,\n CommonMediaResponseLike,\n FactoryMakerThis,\n REQUEST_TYPE,\n XhrLoaderLike,\n} from \"./types.js\";\n\nexport type LoaderHooks = {\n /** Called with what the core read from each MPD, before dash.js parses it. */\n onManifestProcessed?: (manifest: ProcessedManifest) => void;\n};\n\nconst SEGMENT_TYPES: ReadonlySet<string> = new Set([\n REQUEST_TYPE.INIT_SEGMENT,\n REQUEST_TYPE.MEDIA_SEGMENT,\n REQUEST_TYPE.INDEX_SEGMENT,\n]);\n\n/**\n * The `XHRLoader` replacement, in the shape dash.js's `FactoryMaker` applies\n * it: a plain function it calls with `this.parent` set to the real loader,\n * whose `load` and `abort` the returned object overrides. Registered per\n * player through `player.extend(\"XHRLoader\", extension, true)`.\n *\n * Every request dash.js makes over HTTP passes through here — MPD, init,\n * media and index segments, licences — and is told apart by the type of the\n * `FragmentRequest` behind it. See specs/player-adapters.md, \"dash.js\".\n */\nexport function createXhrLoaderExtension(core: Core, hooks: LoaderHooks = {}) {\n return function xhrLoaderExtension(this: FactoryMakerThis): XhrLoaderLike {\n // FactoryMaker copies the returned `load` and `abort` onto the parent\n // instance itself, so `this.parent.load` would point back here once the\n // override is applied. Keep dash.js's own methods before that happens.\n const { parent } = this;\n const original: XhrLoaderLike = {\n load: parent.load.bind(parent),\n abort: parent.abort.bind(parent),\n };\n const router = new RequestRouter(core, original, hooks);\n return {\n load: (request, response) => router.load(request, response),\n abort: () => router.abort(),\n };\n };\n}\n\nclass RequestRouter {\n private readonly logger = debug(\"p2pml-dashjs:loader\");\n /** Aborts the request served by the core most recently, if still in flight. */\n private abortCurrent?: () => void;\n\n constructor(\n private readonly core: Core,\n private readonly parent: XhrLoaderLike,\n private readonly hooks: LoaderHooks,\n ) {}\n\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean {\n const type = request.customData?.request?.type ?? undefined;\n const { url } = request;\n const byteRange = byteRangeFromRangeHeader(\n request.headers?.Range ?? request.headers?.range,\n );\n\n // Every MPD dash.js fetches — first load and each refresh — reaches the\n // core before dash.js parses the same bytes.\n if (type === REQUEST_TYPE.MPD) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (typeof data !== \"string\" && !isBinary(data)) return;\n // The response URL, when the loader filled it in, follows redirects.\n const responseUrl = response.url;\n const processed = this.core.processManifest({\n url:\n responseUrl !== undefined && responseUrl !== \"\" ? responseUrl : url,\n data,\n });\n if (processed) this.hooks.onManifestProcessed?.(processed);\n });\n }\n\n if (type !== undefined && SEGMENT_TYPES.has(type)) {\n // A SegmentBase stream's index: dash.js loads it, the core reads the\n // segment list from the same bytes. Recognition, not lookup.\n if (this.core.isSegmentIndex(url, byteRange)) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (!isBinary(data)) return;\n this.core.processSegmentIndex({ url, byteRange, data });\n });\n }\n\n // Whitelist by lookup: a segment the registry knows on a stream with\n // P2P enabled is served by the core; initialization segments and\n // anything the registry does not know load through dash.js itself.\n if (\n type === REQUEST_TYPE.MEDIA_SEGMENT &&\n this.core.isSegmentLoadable(url, byteRange)\n ) {\n this.serve(request, response, byteRange);\n return true;\n }\n }\n\n // Licences, certificates, steering, XLink, init segments: untouched.\n return this.parent.load(request, response);\n }\n\n abort() {\n this.abortCurrent?.();\n this.parent.abort();\n }\n\n private passThroughAndObserve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n observe: (data: unknown) => void,\n ): boolean {\n request.customData ??= {};\n const { customData } = request;\n const original = customData.onloadend;\n // dash.js's XHRLoader copies `onloadend` onto the XHR at `load`, so the\n // wrap has to be in place before the parent runs.\n customData.onloadend = () => {\n try {\n if (response.status >= 200 && response.status <= 299) {\n observe(response.data);\n }\n } catch (error) {\n this.logger(\"failed to process %s: %O\", request.url, error);\n }\n original?.();\n };\n return this.parent.load(request, response);\n }\n\n private serve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n byteRange: ReturnType<typeof byteRangeFromRangeHeader>,\n ) {\n const { url } = request;\n request.customData ??= {};\n const { customData } = request;\n let settled = false;\n\n const abort = () => {\n if (settled) return;\n this.core.abortSegmentLoading(url, byteRange);\n };\n customData.abort = abort;\n this.abortCurrent = abort;\n\n this.core\n .loadSegment(url, { byteRange })\n .then(({ data, bandwidth }) => {\n settled = true;\n response.url = url;\n response.status = 200;\n response.statusText = \"OK\";\n response.headers = {};\n response.data = data;\n\n // dash.js measures throughput from progress traces, dropping the\n // first (it carries the latency) and summing the rest. Two events\n // give it one download trace whose duration is the core's bandwidth\n // hint — wall-clock time says nothing about the network for a segment\n // that came from a peer or from storage. Never 0 ms.\n const total = data.byteLength;\n customData.onprogress?.({\n lengthComputable: true,\n loaded: 0,\n total,\n time: 1,\n });\n customData.onprogress?.({\n lengthComputable: true,\n loaded: total,\n total,\n time: loadingTimeMs(bandwidth, total),\n });\n customData.onloadend?.();\n })\n .catch((error: unknown) => {\n settled = true;\n if (error instanceof CoreRequestError && error.type === \"aborted\") {\n customData.onabort?.();\n return;\n }\n // A non-2xx status is what dash.js's HTTPLoader retries on; the\n // failure is reported as one rather than thrown into dash.js.\n response.url = url;\n response.status = 0;\n response.statusText =\n error instanceof Error ? error.message : String(error);\n response.data = undefined;\n this.logger(\"core failed to load %s: %O\", url, error);\n customData.onloadend?.();\n });\n }\n}\n\nfunction isBinary(data: unknown): data is ArrayBuffer | ArrayBufferView {\n return data instanceof ArrayBuffer || ArrayBuffer.isView(data);\n}\n\n/** Download time in ms for the core's bandwidth hint; see the Shaka adapter. */\nfunction loadingTimeMs(bandwidth: number, bytes: number): number {\n if (bandwidth <= 0) return 1;\n return Math.max(1, Math.round((bytes * 8 * 1000) / bandwidth));\n}\n","import type { MediaPlayerClass, MediaPlayerEvents } from \"dashjs\";\nimport { dashManifestParser } from \"p2p-media-loader-core/dash\";\nimport {\n Core,\n CoreConfig,\n CoreEventMap,\n DefinedCoreConfig,\n DynamicCoreConfig,\n ProcessedManifest,\n debug,\n getPlaybackStateFromMediaElement,\n liveDelayFor,\n type LiveDelay,\n} from \"p2p-media-loader-core\";\nimport { createXhrLoaderExtension } from \"./loader.js\";\n\n/** A type for specifying dynamic configuration options that can be changed at runtime for the P2P engine's core. */\nexport type DynamicDashJsP2PEngineConfig = {\n /** Dynamic core config */\n core?: DynamicCoreConfig;\n};\n\n/** Represents the complete configuration for the `DashJsP2PEngine`. */\nexport type DashJsP2PEngineConfig = {\n /** Complete core configuration settings. */\n core: DefinedCoreConfig;\n};\n\n/** Allows for partial configuration settings for the `DashJsP2PEngine`. */\nexport type PartialDashJsP2PEngineConfig = {\n /** Partial core config */\n core?: Partial<CoreConfig>;\n};\n\n/**\n * Live delay until the first live manifest says how wide the window is; from\n * then on the delay follows the window (see the core's liveDelayFor). Only\n * applied when the integrator left dash.js's own default in place.\n */\nconst INITIAL_LIVE_EDGE_DELAY = 25;\n\n/** Least forward buffer to leave the player, whatever the windows work out to. */\nconst MIN_BUFFER_SEGMENTS = 2;\n/** Segments left between the player's forward buffer and the live edge. */\nconst LIVE_EDGE_MARGIN_SEGMENTS = 1;\n\nconst STREAM_INITIALIZED: MediaPlayerEvents[\"STREAM_INITIALIZED\"] =\n \"streamInitialized\";\nconst STREAM_TEARDOWN_COMPLETE: MediaPlayerEvents[\"STREAM_TEARDOWN_COMPLETE\"] =\n \"streamTeardownComplete\";\n\n// Every event after which the buffer ahead of the playhead or the rate may\n// have changed. `progress` covers buffer growth without playhead movement.\nconst PLAYBACK_EVENTS = [\n \"timeupdate\",\n \"progress\",\n \"seeking\",\n \"seeked\",\n \"ratechange\",\n \"play\",\n \"pause\",\n \"waiting\",\n] as const;\n\n/**\n * Represents a Peer-to-Peer (P2P) engine designed to enhance media streaming efficiency.\n * This class integrates P2P technologies into dash.js, enabling the distribution of media segments via a peer network\n * alongside traditional HTTP fetching. This reduces server bandwidth costs and improves scalability by sharing the load\n * across multiple clients.\n *\n * The engine has three responsibilities (see specs/player-adapters.md): it\n * hands every MPD dash.js fetches to the core, routes segment requests\n * through the core, and reports playback state from the media element. dash.js's\n * own manifest parsing runs untouched; the core parses the same bytes itself.\n *\n * @example\n * const player = dashjs.MediaPlayer().create();\n * const engine = new DashJsP2PEngine({\n * core: {\n * swarmId: \"example-swarm-id\",\n * announceTrackers: [\"wss://personal.tracker.com\"],\n * },\n * });\n * engine.bindPlayer(player); // before initialize()\n * player.initialize(videoElement, manifestUrl, true);\n */\nexport class DashJsP2PEngine {\n private player?: MediaPlayerClass;\n private media?: HTMLMediaElement;\n private readonly core: Core;\n /** False when the integrator configured a live delay themselves. */\n private managesLiveDelay = false;\n private readonly debug = debug(\"p2pml-dashjs:engine\");\n\n /**\n * Constructs an instance of `DashJsP2PEngine`.\n *\n * @param config An optional configuration for customizing the P2P engine's behavior.\n */\n constructor(config?: PartialDashJsP2PEngineConfig) {\n this.core = new Core({\n ...config?.core,\n // dash.js plays DASH only, so its bundle carries the DASH parser only.\n manifestParsers: config?.core?.manifestParsers ?? [dashManifestParser],\n });\n }\n\n /**\n * Hooks the engine into a dash.js player. Call before `player.initialize()`:\n * the engine replaces the player's `XHRLoader` through `player.extend`,\n * which dash.js resolves when it first loads.\n *\n * @param player The dash.js `MediaPlayer` instance.\n */\n bindPlayer(player: MediaPlayerClass) {\n if (this.player === player) return;\n if (this.player) this.destroy();\n this.player = player;\n\n const liveDelay = player.getSettings().streaming?.delay?.liveDelay;\n this.managesLiveDelay = liveDelay === undefined || Number.isNaN(liveDelay);\n if (this.managesLiveDelay) {\n player.updateSettings({\n streaming: {\n delay: {\n liveDelay: INITIAL_LIVE_EDGE_DELAY,\n // A server's suggestion places the player near the edge, where\n // there is nothing to share.\n useSuggestedPresentationDelay: false,\n },\n },\n });\n }\n\n player.extend(\n \"XHRLoader\",\n createXhrLoaderExtension(this.core, {\n onManifestProcessed: this.applyLivePlacement,\n }),\n true,\n );\n\n player.on(STREAM_INITIALIZED, this.handleStreamInitialized);\n player.on(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n this.registerMediaElement();\n }\n\n /**\n * Applies dynamic configuration updates to the P2P engine.\n *\n * @param dynamicConfig The configuration changes to apply.\n */\n applyDynamicConfig(dynamicConfig: DynamicDashJsP2PEngineConfig) {\n if (dynamicConfig.core) this.core.applyDynamicConfig(dynamicConfig.core);\n }\n\n /**\n * Retrieves the current configuration of the `DashJsP2PEngine`.\n *\n * @returns The configuration as a readonly object.\n */\n getConfig(): DashJsP2PEngineConfig {\n return { core: this.core.getConfig() };\n }\n\n /**\n * Adds an event listener for the specified event.\n * @param eventName The name of the event to listen for.\n * @param listener The callback function to be invoked when the event is triggered.\n *\n * @example\n * engine.addEventListener('onSegmentLoaded', (details) => {\n * console.log('Segment Loaded:', details);\n * });\n */\n addEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.addEventListener(eventName, listener);\n }\n\n /**\n * Removes an event listener for the specified event.\n * @param eventName The name of the event.\n * @param listener The callback function that was previously added.\n */\n removeEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.removeEventListener(eventName, listener);\n }\n\n /**\n * Places the player in the live window from the window the core just\n * parsed: how far behind the edge it plays, and how far ahead of the\n * playhead it may fetch. The MPD reaches the core before dash.js parses the\n * same bytes, so both are in place when dash.js computes its live position.\n * Re-applied only when the window changes by at least half a segment.\n */\n private applyLivePlacement = (manifest: ProcessedManifest) => {\n if (!this.player || !this.managesLiveDelay) return;\n const target = liveDelayFor(manifest);\n if (!target) return;\n\n const current = this.player.getSettings().streaming?.delay?.liveDelay;\n if (\n current !== undefined &&\n !Number.isNaN(current) &&\n Math.abs(current - target.delay) < target.segment / 2\n ) {\n return;\n }\n\n const buffer = this.forwardBufferSettings(target);\n this.debug(\n `Setting liveDelay to ${target.delay}, forward buffer to ${buffer.bufferTimeDefault}`,\n );\n this.player.updateSettings({\n streaming: { delay: { liveDelay: target.delay }, buffer },\n });\n };\n\n /**\n * How far ahead of the playhead dash.js may fetch: the high-demand window,\n * never closer to the live edge than a segment, never less than a couple of\n * segments. The segments beyond it are the core's to prefetch, and they are\n * the ones peers exchange.\n *\n * Left alone, dash.js buffers `bufferTimeAtTopQualityLongForm` — a minute,\n * since a dynamic stream is long-form by its duration — which on a live\n * stream is the whole window. Its playhead then sits a live delay behind the\n * edge while its *fetch* position rides the edge itself, where the registry\n * cannot yet know the segment: core learns of one only when dash.js refreshes\n * the MPD, and dash.js derives availability from its own synced clock. Every\n * such request misses the registry and falls through to dash.js's own loader,\n * so the stream plays perfectly with no P2P at all.\n *\n * Settings the integrator already holds below this are left alone; the value\n * is a ceiling, not a target.\n */\n private forwardBufferSettings(target: LiveDelay) {\n const { mainStream, secondaryStream } = this.core.getConfig();\n const highDemandTimeWindow = Math.max(\n mainStream.highDemandTimeWindow,\n secondaryStream.highDemandTimeWindow,\n );\n const bufferTime = Math.max(\n target.segment * MIN_BUFFER_SEGMENTS,\n Math.min(\n highDemandTimeWindow,\n target.delay - target.segment * LIVE_EDGE_MARGIN_SEGMENTS,\n ),\n );\n\n const current = this.player?.getSettings().streaming?.buffer;\n const lower = (setting: number | undefined) =>\n setting === undefined || Number.isNaN(setting) || setting > bufferTime\n ? bufferTime\n : setting;\n\n return {\n bufferTimeDefault: lower(current?.bufferTimeDefault),\n bufferTimeAtTopQuality: lower(current?.bufferTimeAtTopQuality),\n bufferTimeAtTopQualityLongForm: lower(\n current?.bufferTimeAtTopQualityLongForm,\n ),\n };\n }\n\n private handleStreamInitialized = () => {\n this.registerMediaElement();\n };\n\n private handleStreamTeardown = () => {\n this.core.destroy();\n this.unregisterMediaElement();\n };\n\n private registerMediaElement() {\n let media: HTMLMediaElement | undefined;\n try {\n // Throws until a view is attached.\n media = this.player?.getVideoElement();\n } catch {\n return;\n }\n if (!media || media === this.media) return;\n this.unregisterMediaElement();\n this.media = media;\n for (const event of PLAYBACK_EVENTS) {\n media.addEventListener(event, this.handlePlaybackUpdate);\n }\n }\n\n private unregisterMediaElement() {\n const { media } = this;\n if (!media) return;\n for (const event of PLAYBACK_EVENTS) {\n media.removeEventListener(event, this.handlePlaybackUpdate);\n }\n this.media = undefined;\n }\n\n private handlePlaybackUpdate = (event: Event) => {\n const media = event.target as HTMLMediaElement;\n this.core.updatePlayback(getPlaybackStateFromMediaElement(media));\n };\n\n /** Cleans up and releases all resources, and unregisters all event handlers. */\n destroy() {\n this.core.destroy();\n this.unregisterMediaElement();\n if (this.player) {\n this.player.off(STREAM_INITIALIZED, this.handleStreamInitialized);\n this.player.off(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n }\n this.player = undefined;\n }\n}\n"],"mappings":";;;AAQA,IAAa,IAAe;CAC1B,KAAK;CACL,cAAc;CACd,eAAe;CACf,eAAe;AACjB,GCOM,oBAAqC,IAAI,IAAI;CACjD,EAAa;CACb,EAAa;CACb,EAAa;AACf,CAAC;AAYD,SAAgB,EAAyB,GAAY,IAAqB,CAAC,GAAG;CAC5E,OAAO,WAAmE;EAIxE,IAAM,EAAE,cAAW,MAKb,IAAS,IAAI,EAAc,GAAM;GAHrC,MAAM,EAAO,KAAK,KAAK,CAAM;GAC7B,OAAO,EAAO,MAAM,KAAK,CAAM;EAEM,GAAU,CAAK;EACtD,OAAO;GACL,OAAO,GAAS,MAAa,EAAO,KAAK,GAAS,CAAQ;GAC1D,aAAa,EAAO,MAAM;EAC5B;CACF;AACF;AAEA,IAAM,IAAN,MAAoB;CAMC;CACA;CACA;CAPnB,SAA0B,EAAM,qBAAqB;CAErD;CAEA,YACE,GACA,GACA,GACA;EADiB,AAFA,KAAA,OAAA,GACA,KAAA,SAAA,GACA,KAAA,QAAA;CAChB;CAEH,KACE,GACA,GACS;EACT,IAAM,IAAO,EAAQ,YAAY,SAAS,QAAQ,KAAA,GAC5C,EAAE,WAAQ,GACV,IAAY,EAChB,EAAQ,SAAS,SAAS,EAAQ,SAAS,KAC7C;EAIA,IAAI,MAAS,EAAa,KACxB,OAAO,KAAK,sBAAsB,GAAS,IAAW,MAAS;GAC7D,IAAI,OAAO,KAAS,YAAY,CAAC,EAAS,CAAI,GAAG;GAEjD,IAAM,IAAc,EAAS,KACvB,IAAY,KAAK,KAAK,gBAAgB;IAC1C,KACE,MAAgB,KAAA,KAAa,MAAgB,KAAK,IAAc;IAClE;GACF,CAAC;GACD,AAAI,KAAW,KAAK,MAAM,sBAAsB,CAAS;EAC3D,CAAC;EAGH,IAAI,MAAS,KAAA,KAAa,EAAc,IAAI,CAAI,GAAG;GAGjD,IAAI,KAAK,KAAK,eAAe,GAAK,CAAS,GACzC,OAAO,KAAK,sBAAsB,GAAS,IAAW,MAAS;IACxD,EAAS,CAAI,KAClB,KAAK,KAAK,oBAAoB;KAAE;KAAK;KAAW;IAAK,CAAC;GACxD,CAAC;GAMH,IACE,MAAS,EAAa,iBACtB,KAAK,KAAK,kBAAkB,GAAK,CAAS,GAG1C,OADA,KAAK,MAAM,GAAS,GAAU,CAAS,GAChC;EAEX;EAGA,OAAO,KAAK,OAAO,KAAK,GAAS,CAAQ;CAC3C;CAEA,QAAQ;EAEN,AADA,KAAK,eAAe,GACpB,KAAK,OAAO,MAAM;CACpB;CAEA,sBACE,GACA,GACA,GACS;EACT,EAAQ,eAAe,CAAC;EACxB,IAAM,EAAE,kBAAe,GACjB,IAAW,EAAW;EAa5B,OAVA,EAAW,kBAAkB;GAC3B,IAAI;IACF,AAAI,EAAS,UAAU,OAAO,EAAS,UAAU,OAC/C,EAAQ,EAAS,IAAI;GAEzB,SAAS,GAAO;IACd,KAAK,OAAO,4BAA4B,EAAQ,KAAK,CAAK;GAC5D;GACA,IAAW;EACb,GACO,KAAK,OAAO,KAAK,GAAS,CAAQ;CAC3C;CAEA,MACE,GACA,GACA,GACA;EACA,IAAM,EAAE,WAAQ;EAChB,EAAQ,eAAe,CAAC;EACxB,IAAM,EAAE,kBAAe,GACnB,IAAU,IAER,UAAc;GACd,KACJ,KAAK,KAAK,oBAAoB,GAAK,CAAS;EAC9C;EAIA,AAHA,EAAW,QAAQ,GACnB,KAAK,eAAe,GAEpB,KAAK,KACF,YAAY,GAAK,EAAE,aAAU,CAAC,CAAC,CAC/B,MAAM,EAAE,SAAM,mBAAgB;GAM7B,AALA,IAAU,IACV,EAAS,MAAM,GACf,EAAS,SAAS,KAClB,EAAS,aAAa,MACtB,EAAS,UAAU,CAAC,GACpB,EAAS,OAAO;GAOhB,IAAM,IAAQ,EAAK;GAanB,AAZA,EAAW,aAAa;IACtB,kBAAkB;IAClB,QAAQ;IACR;IACA,MAAM;GACR,CAAC,GACD,EAAW,aAAa;IACtB,kBAAkB;IAClB,QAAQ;IACR;IACA,MAAM,EAAc,GAAW,CAAK;GACtC,CAAC,GACD,EAAW,YAAY;EACzB,CAAC,CAAC,CACD,OAAO,MAAmB;GAEzB,IADA,IAAU,IACN,aAAiB,KAAoB,EAAM,SAAS,WAAW;IACjE,EAAW,UAAU;IACrB;GACF;GASA,AANA,EAAS,MAAM,GACf,EAAS,SAAS,GAClB,EAAS,aACP,aAAiB,QAAQ,EAAM,UAAU,OAAO,CAAK,GACvD,EAAS,OAAO,KAAA,GAChB,KAAK,OAAO,8BAA8B,GAAK,CAAK,GACpD,EAAW,YAAY;EACzB,CAAC;CACL;AACF;AAEA,SAAS,EAAS,GAAsD;CACtE,OAAO,aAAgB,eAAe,YAAY,OAAO,CAAI;AAC/D;AAGA,SAAS,EAAc,GAAmB,GAAuB;CAE/D,OADI,KAAa,IAAU,IACpB,KAAK,IAAI,GAAG,KAAK,MAAO,IAAQ,IAAI,MAAQ,CAAS,CAAC;AAC/D;;;ACpLA,IAAM,IAA0B,IAG1B,IAAsB,GAEtB,IAA4B,GAE5B,IACJ,qBACI,IACJ,0BAII,IAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,GAwBa,IAAb,MAA6B;CAC3B;CACA;CACA;CAEA,mBAA2B;CAC3B,QAAyB,EAAM,qBAAqB;CAOpD,YAAY,GAAuC;EACjD,KAAK,OAAO,IAAI,EAAK;GACnB,GAAG,GAAQ;GAEX,iBAAiB,GAAQ,MAAM,mBAAmB,CAAC,CAAkB;EACvE,CAAC;CACH;CASA,WAAW,GAA0B;EACnC,IAAI,KAAK,WAAW,GAAQ;EAE5B,AADI,KAAK,UAAQ,KAAK,QAAQ,GAC9B,KAAK,SAAS;EAEd,IAAM,IAAY,EAAO,YAAY,CAAC,CAAC,WAAW,OAAO;EAyBzD,AAxBA,KAAK,mBAAmB,MAAc,KAAA,KAAa,OAAO,MAAM,CAAS,GACrE,KAAK,oBACP,EAAO,eAAe,EACpB,WAAW,EACT,OAAO;GACL,WAAW;GAGX,+BAA+B;EACjC,EACF,EACF,CAAC,GAGH,EAAO,OACL,aACA,EAAyB,KAAK,MAAM,EAClC,qBAAqB,KAAK,mBAC5B,CAAC,GACD,EACF,GAEA,EAAO,GAAG,GAAoB,KAAK,uBAAuB,GAC1D,EAAO,GAAG,GAA0B,KAAK,oBAAoB,GAC7D,KAAK,qBAAqB;CAC5B;CAOA,mBAAmB,GAA6C;EAC9D,AAAI,EAAc,QAAM,KAAK,KAAK,mBAAmB,EAAc,IAAI;CACzE;CAOA,YAAmC;EACjC,OAAO,EAAE,MAAM,KAAK,KAAK,UAAU,EAAE;CACvC;CAYA,iBACE,GACA,GACA;EACA,KAAK,KAAK,iBAAiB,GAAW,CAAQ;CAChD;CAOA,oBACE,GACA,GACA;EACA,KAAK,KAAK,oBAAoB,GAAW,CAAQ;CACnD;CASA,sBAA8B,MAAgC;EAC5D,IAAI,CAAC,KAAK,UAAU,CAAC,KAAK,kBAAkB;EAC5C,IAAM,IAAS,EAAa,CAAQ;EACpC,IAAI,CAAC,GAAQ;EAEb,IAAM,IAAU,KAAK,OAAO,YAAY,CAAC,CAAC,WAAW,OAAO;EAC5D,IACE,MAAY,KAAA,KACZ,CAAC,OAAO,MAAM,CAAO,KACrB,KAAK,IAAI,IAAU,EAAO,KAAK,IAAI,EAAO,UAAU,GAEpD;EAGF,IAAM,IAAS,KAAK,sBAAsB,CAAM;EAIhD,AAHA,KAAK,MACH,wBAAwB,EAAO,MAAM,sBAAsB,EAAO,mBACpE,GACA,KAAK,OAAO,eAAe,EACzB,WAAW;GAAE,OAAO,EAAE,WAAW,EAAO,MAAM;GAAG;EAAO,EAC1D,CAAC;CACH;CAoBA,sBAA8B,GAAmB;EAC/C,IAAM,EAAE,eAAY,uBAAoB,KAAK,KAAK,UAAU,GACtD,IAAuB,KAAK,IAChC,EAAW,sBACX,EAAgB,oBAClB,GACM,IAAa,KAAK,IACtB,EAAO,UAAU,GACjB,KAAK,IACH,GACA,EAAO,QAAQ,EAAO,UAAU,CAClC,CACF,GAEM,IAAU,KAAK,QAAQ,YAAY,CAAC,CAAC,WAAW,QAChD,KAAS,MACb,MAAY,KAAA,KAAa,OAAO,MAAM,CAAO,KAAK,IAAU,IACxD,IACA;EAEN,OAAO;GACL,mBAAmB,EAAM,GAAS,iBAAiB;GACnD,wBAAwB,EAAM,GAAS,sBAAsB;GAC7D,gCAAgC,EAC9B,GAAS,8BACX;EACF;CACF;CAEA,gCAAwC;EACtC,KAAK,qBAAqB;CAC5B;CAEA,6BAAqC;EAEnC,AADA,KAAK,KAAK,QAAQ,GAClB,KAAK,uBAAuB;CAC9B;CAEA,uBAA+B;EAC7B,IAAI;EACJ,IAAI;GAEF,IAAQ,KAAK,QAAQ,gBAAgB;EACvC,QAAQ;GACN;EACF;EACI,IAAC,KAAS,MAAU,KAAK,OAE7B;GADA,KAAK,uBAAuB,GAC5B,KAAK,QAAQ;GACb,KAAK,IAAM,KAAS,GAClB,EAAM,iBAAiB,GAAO,KAAK,oBAAoB;EAF5C;CAIf;CAEA,yBAAiC;EAC/B,IAAM,EAAE,aAAU;EACb,OACL;QAAK,IAAM,KAAS,GAClB,EAAM,oBAAoB,GAAO,KAAK,oBAAoB;GAE5D,KAAK,QAAQ,KAAA;EAF+C;CAG9D;CAEA,wBAAgC,MAAiB;EAC/C,IAAM,IAAQ,EAAM;EACpB,KAAK,KAAK,eAAe,EAAiC,CAAK,CAAC;CAClE;CAGA,UAAU;EAOR,AANA,KAAK,KAAK,QAAQ,GAClB,KAAK,uBAAuB,GACxB,KAAK,WACP,KAAK,OAAO,IAAI,GAAoB,KAAK,uBAAuB,GAChE,KAAK,OAAO,IAAI,GAA0B,KAAK,oBAAoB,IAErE,KAAK,SAAS,KAAA;CAChB;AACF"}
|
|
1
|
+
{"version":3,"file":"p2p-media-loader-dashjs.es.min.js","names":[],"sources":["../src/types.ts","../src/loader.ts","../src/engine.ts"],"sourcesContent":["/**\n * The slice of dash.js's request plumbing the adapter touches, typed\n * structurally. dash.js's own declarations for these live in\n * `@svta/cml-request`, a transitive dependency this package cannot import\n * directly, and the adapter needs only a handful of fields.\n */\n\n/** `HTTPRequest.*_TYPE` values a request carries in `customData.request.type`. */\nexport const REQUEST_TYPE = {\n MPD: \"MPD\",\n INIT_SEGMENT: \"InitializationSegment\",\n MEDIA_SEGMENT: \"MediaSegment\",\n INDEX_SEGMENT: \"IndexSegment\",\n} as const;\n\n/** What `_onprogress` in dash.js's HTTPLoader reads off a progress event. */\nexport type ProgressEventLike = {\n lengthComputable: boolean;\n loaded: number;\n total: number;\n /** Trace duration in ms; dash.js uses it instead of the wall clock when set. */\n time?: number;\n};\n\n/** The dash.js `FragmentRequest` (or `TextRequest`) behind a network request. */\ntype FragmentRequestLike = {\n type?: string | null;\n url?: string | null;\n range?: string | null;\n mediaType?: string | null;\n};\n\n/** Callbacks and state dash.js's HTTPLoader hangs on a request. */\ntype RequestCustomData = {\n request?: FragmentRequestLike;\n onloadend?: () => void;\n onprogress?: (event: ProgressEventLike) => void;\n onabort?: () => void;\n ontimeout?: (event: unknown) => void;\n abort?: () => void;\n};\n\n/** `CommonMediaRequest` as HTTPLoader builds it. */\nexport type CommonMediaRequestLike = {\n url: string;\n method?: string;\n responseType?: string;\n headers?: Record<string, string | undefined>;\n customData?: RequestCustomData;\n};\n\n/** `CommonMediaResponse` as HTTPLoader expects the loader to fill it. */\nexport type CommonMediaResponseLike = {\n url?: string;\n status: number;\n statusText?: string;\n headers?: Record<string, string> | null;\n data?: unknown;\n};\n\n/** The instance dash.js's own `XHRLoader` factory produces. */\nexport type XhrLoaderLike = {\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean;\n abort(): void;\n};\n\n/**\n * What `FactoryMaker` binds as `this` when it applies an `override`\n * extension: the real instance is `parent`.\n */\nexport type FactoryMakerThis = {\n context: object;\n factory: unknown;\n parent: XhrLoaderLike;\n};\n","import {\n Core,\n CoreRequestError,\n ProcessedManifest,\n byteRangeFromRangeHeader,\n debug,\n} from \"p2p-media-loader-core\";\nimport {\n CommonMediaRequestLike,\n CommonMediaResponseLike,\n FactoryMakerThis,\n REQUEST_TYPE,\n XhrLoaderLike,\n} from \"./types.js\";\n\nexport type LoaderHooks = {\n /** Called with what the core read from each MPD, before dash.js parses it. */\n onManifestProcessed?: (manifest: ProcessedManifest) => void;\n};\n\nconst SEGMENT_TYPES: ReadonlySet<string> = new Set([\n REQUEST_TYPE.INIT_SEGMENT,\n REQUEST_TYPE.MEDIA_SEGMENT,\n REQUEST_TYPE.INDEX_SEGMENT,\n]);\n\n/**\n * The `XHRLoader` replacement, in the shape dash.js's `FactoryMaker` applies\n * it: a plain function it calls with `this.parent` set to the real loader,\n * whose `load` and `abort` the returned object overrides. Registered per\n * player through `player.extend(\"XHRLoader\", extension, true)`.\n *\n * Every request dash.js makes over HTTP passes through here — MPD, init,\n * media and index segments, licences — and is told apart by the type of the\n * `FragmentRequest` behind it. See specs/player-adapters.md, \"dash.js\".\n */\nexport function createXhrLoaderExtension(core: Core, hooks: LoaderHooks = {}) {\n return function xhrLoaderExtension(this: FactoryMakerThis): XhrLoaderLike {\n // FactoryMaker copies the returned `load` and `abort` onto the parent\n // instance itself, so `this.parent.load` would point back here once the\n // override is applied. Keep dash.js's own methods before that happens.\n const { parent } = this;\n const original: XhrLoaderLike = {\n load: parent.load.bind(parent),\n abort: parent.abort.bind(parent),\n };\n const router = new RequestRouter(core, original, hooks);\n return {\n load: (request, response) => router.load(request, response),\n abort: () => router.abort(),\n };\n };\n}\n\nclass RequestRouter {\n private readonly logger = debug(\"p2pml-dashjs:loader\");\n /** Aborts the request served by the core most recently, if still in flight. */\n private abortCurrent?: () => void;\n\n constructor(\n private readonly core: Core,\n private readonly parent: XhrLoaderLike,\n private readonly hooks: LoaderHooks,\n ) {}\n\n load(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n ): boolean {\n const type = request.customData?.request?.type ?? undefined;\n const { url } = request;\n const byteRange = byteRangeFromRangeHeader(\n request.headers?.Range ?? request.headers?.range,\n );\n\n // Every MPD dash.js fetches — first load and each refresh — reaches the\n // core before dash.js parses the same bytes.\n if (type === REQUEST_TYPE.MPD) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (typeof data !== \"string\" && !isBinary(data)) return;\n // The response URL, when the loader filled it in, follows redirects.\n const responseUrl = response.url;\n const processed = this.core.processManifest({\n url:\n responseUrl !== undefined && responseUrl !== \"\" ? responseUrl : url,\n requestedUrl: url,\n data,\n });\n if (processed) this.hooks.onManifestProcessed?.(processed);\n });\n }\n\n if (type !== undefined && SEGMENT_TYPES.has(type)) {\n // A SegmentBase stream's index: dash.js loads it, the core reads the\n // segment list from the same bytes. Recognition, not lookup.\n if (this.core.isSegmentIndex(url, byteRange)) {\n return this.passThroughAndObserve(request, response, (data) => {\n if (!isBinary(data)) return;\n this.core.processSegmentIndex({ url, byteRange, data });\n });\n }\n\n // Whitelist by lookup: a segment the registry knows on a stream with\n // P2P enabled is served by the core; initialization segments and\n // anything the registry does not know load through dash.js itself.\n if (\n type === REQUEST_TYPE.MEDIA_SEGMENT &&\n this.core.isSegmentLoadable(url, byteRange)\n ) {\n this.serve(request, response, byteRange);\n return true;\n }\n }\n\n // Licences, certificates, steering, XLink, init segments: untouched.\n return this.parent.load(request, response);\n }\n\n abort() {\n this.abortCurrent?.();\n this.parent.abort();\n }\n\n private passThroughAndObserve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n observe: (data: unknown) => void,\n ): boolean {\n request.customData ??= {};\n const { customData } = request;\n const original = customData.onloadend;\n // dash.js's XHRLoader copies `onloadend` onto the XHR at `load`, so the\n // wrap has to be in place before the parent runs.\n customData.onloadend = () => {\n try {\n if (response.status >= 200 && response.status <= 299) {\n observe(response.data);\n }\n } catch (error) {\n this.logger(\"failed to process %s: %O\", request.url, error);\n }\n original?.();\n };\n return this.parent.load(request, response);\n }\n\n private serve(\n request: CommonMediaRequestLike,\n response: CommonMediaResponseLike,\n byteRange: ReturnType<typeof byteRangeFromRangeHeader>,\n ) {\n const { url } = request;\n request.customData ??= {};\n const { customData } = request;\n let settled = false;\n let aborted = false;\n\n const abort = () => {\n if (settled) return;\n aborted = true;\n this.core.abortSegmentLoading(url, byteRange);\n };\n customData.abort = abort;\n this.abortCurrent = abort;\n\n this.core\n .loadSegment(url, { byteRange })\n .then(({ data, bandwidth }) => {\n // The core cannot always cancel in time — a request waiting for the\n // segment storage has no loader yet — so what dash.js has abandoned\n // is dropped here rather than reported as a download.\n if (aborted) {\n settled = true;\n customData.onabort?.();\n return;\n }\n settled = true;\n response.url = url;\n response.status = 200;\n response.statusText = \"OK\";\n response.headers = {};\n response.data = data;\n\n // dash.js measures throughput from progress traces, dropping the\n // first (it carries the latency) and summing the rest. Two events\n // give it one download trace whose duration is the core's bandwidth\n // hint — wall-clock time says nothing about the network for a segment\n // that came from a peer or from storage. Never 0 ms.\n const total = data.byteLength;\n customData.onprogress?.({\n lengthComputable: true,\n loaded: 0,\n total,\n time: 1,\n });\n customData.onprogress?.({\n lengthComputable: true,\n loaded: total,\n total,\n time: loadingTimeMs(bandwidth, total),\n });\n customData.onloadend?.();\n })\n .catch((error: unknown) => {\n settled = true;\n if (error instanceof CoreRequestError && error.type === \"aborted\") {\n customData.onabort?.();\n return;\n }\n // A non-2xx status is what dash.js's HTTPLoader retries on; the\n // failure is reported as one rather than thrown into dash.js.\n response.url = url;\n response.status = 0;\n response.statusText =\n error instanceof Error ? error.message : String(error);\n response.data = undefined;\n this.logger(\"core failed to load %s: %O\", url, error);\n customData.onloadend?.();\n });\n }\n}\n\nfunction isBinary(data: unknown): data is ArrayBuffer | ArrayBufferView {\n return data instanceof ArrayBuffer || ArrayBuffer.isView(data);\n}\n\n/** Download time in ms for the core's bandwidth hint; see the Shaka adapter. */\nfunction loadingTimeMs(bandwidth: number, bytes: number): number {\n if (bandwidth <= 0) return 1;\n return Math.max(1, Math.round((bytes * 8 * 1000) / bandwidth));\n}\n","import type { MediaPlayerClass, MediaPlayerEvents } from \"dashjs\";\nimport { dashManifestParser } from \"p2p-media-loader-core/dash\";\nimport {\n Core,\n CoreConfig,\n CoreEventMap,\n DefinedCoreConfig,\n DynamicCoreConfig,\n ProcessedManifest,\n debug,\n trackMediaElementPlayback,\n liveDelayFor,\n type LiveDelay,\n} from \"p2p-media-loader-core\";\nimport { createXhrLoaderExtension } from \"./loader.js\";\n\n/** A type for specifying dynamic configuration options that can be changed at runtime for the P2P engine's core. */\nexport type DynamicDashJsP2PEngineConfig = {\n /** Dynamic core config */\n core?: DynamicCoreConfig;\n};\n\n/** Represents the complete configuration for the `DashJsP2PEngine`. */\nexport type DashJsP2PEngineConfig = {\n /** Complete core configuration settings. */\n core: DefinedCoreConfig;\n};\n\n/** Allows for partial configuration settings for the `DashJsP2PEngine`. */\nexport type PartialDashJsP2PEngineConfig = {\n /** Partial core config */\n core?: Partial<CoreConfig>;\n};\n\n/**\n * Live delay until the first live manifest says how wide the window is; from\n * then on the delay follows the window (see the core's liveDelayFor). Only\n * applied when the integrator left dash.js's own default in place.\n */\nconst INITIAL_LIVE_EDGE_DELAY = 25;\n\n/** Least forward buffer to leave the player, whatever the windows work out to. */\nconst MIN_BUFFER_SEGMENTS = 2;\n/** Segments left between the player's forward buffer and the live edge. */\nconst LIVE_EDGE_MARGIN_SEGMENTS = 1;\n\nconst STREAM_INITIALIZED: MediaPlayerEvents[\"STREAM_INITIALIZED\"] =\n \"streamInitialized\";\nconst STREAM_TEARDOWN_COMPLETE: MediaPlayerEvents[\"STREAM_TEARDOWN_COMPLETE\"] =\n \"streamTeardownComplete\";\n\n/**\n * Represents a Peer-to-Peer (P2P) engine designed to enhance media streaming efficiency.\n * This class integrates P2P technologies into dash.js, enabling the distribution of media segments via a peer network\n * alongside traditional HTTP fetching. This reduces server bandwidth costs and improves scalability by sharing the load\n * across multiple clients.\n *\n * The engine has three responsibilities (see specs/player-adapters.md): it\n * hands every MPD dash.js fetches to the core, routes segment requests\n * through the core, and reports playback state from the media element. dash.js's\n * own manifest parsing runs untouched; the core parses the same bytes itself.\n *\n * @example\n * const player = dashjs.MediaPlayer().create();\n * const engine = new DashJsP2PEngine({\n * core: {\n * swarmId: \"example-swarm-id\",\n * announceTrackers: [\"wss://personal.tracker.com\"],\n * },\n * });\n * engine.bindPlayer(player); // before initialize()\n * player.initialize(videoElement, manifestUrl, true);\n */\nexport class DashJsP2PEngine {\n private player?: MediaPlayerClass;\n private readonly playback = trackMediaElementPlayback((state) =>\n this.core.updatePlayback(state),\n );\n private readonly core: Core;\n /** False when the integrator configured a live delay themselves. */\n private managesLiveDelay = false;\n private readonly debug = debug(\"p2pml-dashjs:engine\");\n\n /**\n * Constructs an instance of `DashJsP2PEngine`.\n *\n * @param config An optional configuration for customizing the P2P engine's behavior.\n */\n constructor(config?: PartialDashJsP2PEngineConfig) {\n this.core = new Core({\n ...config?.core,\n // dash.js plays DASH only, so its bundle carries the DASH parser only.\n manifestParsers: config?.core?.manifestParsers ?? [dashManifestParser],\n });\n }\n\n /**\n * Hooks the engine into a dash.js player. Call before `player.initialize()`:\n * the engine replaces the player's `XHRLoader` through `player.extend`,\n * which dash.js resolves when it first loads.\n *\n * @param player The dash.js `MediaPlayer` instance.\n */\n bindPlayer(player: MediaPlayerClass) {\n if (this.player === player) return;\n if (this.player) this.destroy();\n this.player = player;\n\n const liveDelay = player.getSettings().streaming?.delay?.liveDelay;\n this.managesLiveDelay = liveDelay === undefined || Number.isNaN(liveDelay);\n if (this.managesLiveDelay) {\n player.updateSettings({\n streaming: {\n delay: {\n liveDelay: INITIAL_LIVE_EDGE_DELAY,\n // A server's suggestion places the player near the edge, where\n // there is nothing to share.\n useSuggestedPresentationDelay: false,\n },\n },\n });\n }\n\n player.extend(\n \"XHRLoader\",\n createXhrLoaderExtension(this.core, {\n onManifestProcessed: this.applyLivePlacement,\n }),\n true,\n );\n\n player.on(STREAM_INITIALIZED, this.handleStreamInitialized);\n player.on(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n this.registerMediaElement();\n }\n\n /**\n * Applies dynamic configuration updates to the P2P engine.\n *\n * @param dynamicConfig The configuration changes to apply.\n */\n applyDynamicConfig(dynamicConfig: DynamicDashJsP2PEngineConfig) {\n if (dynamicConfig.core) this.core.applyDynamicConfig(dynamicConfig.core);\n }\n\n /**\n * Retrieves the current configuration of the `DashJsP2PEngine`.\n *\n * @returns The configuration as a readonly object.\n */\n getConfig(): DashJsP2PEngineConfig {\n return { core: this.core.getConfig() };\n }\n\n /**\n * Adds an event listener for the specified event.\n * @param eventName The name of the event to listen for.\n * @param listener The callback function to be invoked when the event is triggered.\n *\n * @example\n * engine.addEventListener('onSegmentLoaded', (details) => {\n * console.log('Segment Loaded:', details);\n * });\n */\n addEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.addEventListener(eventName, listener);\n }\n\n /**\n * Removes an event listener for the specified event.\n * @param eventName The name of the event.\n * @param listener The callback function that was previously added.\n */\n removeEventListener<K extends keyof CoreEventMap>(\n eventName: K,\n listener: CoreEventMap[K],\n ) {\n this.core.removeEventListener(eventName, listener);\n }\n\n /**\n * Places the player in the live window from the window the core just\n * parsed: how far behind the edge it plays, and how far ahead of the\n * playhead it may fetch. The MPD reaches the core before dash.js parses the\n * same bytes, so both are in place when dash.js computes its live position.\n * Re-applied only when the window changes by at least half a segment.\n */\n private applyLivePlacement = (manifest: ProcessedManifest) => {\n if (!this.player || !this.managesLiveDelay) return;\n const target = liveDelayFor(manifest);\n if (!target) return;\n\n const current = this.player.getSettings().streaming?.delay?.liveDelay;\n if (\n current !== undefined &&\n !Number.isNaN(current) &&\n Math.abs(current - target.delay) < target.segment / 2\n ) {\n return;\n }\n\n const buffer = this.forwardBufferSettings(target);\n this.debug(\n `Setting liveDelay to ${target.delay}, forward buffer to ${buffer.bufferTimeDefault}`,\n );\n this.player.updateSettings({\n streaming: { delay: { liveDelay: target.delay }, buffer },\n });\n };\n\n /**\n * How far ahead of the playhead dash.js may fetch: the high-demand window,\n * never closer to the live edge than a segment, never less than a couple of\n * segments. The segments beyond it are the core's to prefetch, and they are\n * the ones peers exchange.\n *\n * Left alone, dash.js buffers `bufferTimeAtTopQualityLongForm` — a minute,\n * since a dynamic stream is long-form by its duration — which on a live\n * stream is the whole window. Its playhead then sits a live delay behind the\n * edge while its *fetch* position rides the edge itself, where the registry\n * cannot yet know the segment: core learns of one only when dash.js refreshes\n * the MPD, and dash.js derives availability from its own synced clock. Every\n * such request misses the registry and falls through to dash.js's own loader,\n * so the stream plays perfectly with no P2P at all.\n *\n * Settings the integrator already holds below this are left alone; the value\n * is a ceiling, not a target.\n */\n private forwardBufferSettings(target: LiveDelay) {\n const { mainStream, secondaryStream } = this.core.getConfig();\n const highDemandTimeWindow = Math.max(\n mainStream.highDemandTimeWindow,\n secondaryStream.highDemandTimeWindow,\n );\n const bufferTime = Math.max(\n target.segment * MIN_BUFFER_SEGMENTS,\n Math.min(\n highDemandTimeWindow,\n target.delay - target.segment * LIVE_EDGE_MARGIN_SEGMENTS,\n ),\n );\n\n const current = this.player?.getSettings().streaming?.buffer;\n const lower = (setting: number | undefined) =>\n setting === undefined || Number.isNaN(setting) || setting > bufferTime\n ? bufferTime\n : setting;\n\n return {\n bufferTimeDefault: lower(current?.bufferTimeDefault),\n bufferTimeAtTopQuality: lower(current?.bufferTimeAtTopQuality),\n bufferTimeAtTopQualityLongForm: lower(\n current?.bufferTimeAtTopQualityLongForm,\n ),\n };\n }\n\n private handleStreamInitialized = () => {\n this.registerMediaElement();\n };\n\n private handleStreamTeardown = () => {\n this.core.destroy();\n this.playback.stop();\n };\n\n private registerMediaElement() {\n let media: HTMLMediaElement | undefined;\n try {\n // Throws until a view is attached.\n media = this.player?.getVideoElement();\n } catch {\n return;\n }\n if (media) this.playback.watch(media);\n }\n\n /** Cleans up and releases all resources, and unregisters all event handlers. */\n destroy() {\n this.core.destroy();\n this.playback.stop();\n if (this.player) {\n this.player.off(STREAM_INITIALIZED, this.handleStreamInitialized);\n this.player.off(STREAM_TEARDOWN_COMPLETE, this.handleStreamTeardown);\n }\n this.player = undefined;\n }\n}\n"],"mappings":"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"}
|