@blockcast/mmt-render 0.1.0-main.c71423b8a4e4 → 0.1.0-main.ce3c8aeb7f68
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/dist/audio/audio-render-pipeline.js +192 -247
- package/dist/audio/audio-render-pipeline.js.map +1 -1
- package/dist/audio/audio-ring-buffer.js +93 -127
- package/dist/audio/audio-ring-buffer.js.map +1 -1
- package/dist/audio/index.js +288 -360
- package/dist/audio/index.js.map +2 -2
- package/dist/pacing/frame-pacer.js +18 -38
- package/dist/pacing/frame-pacer.js.map +1 -1
- package/dist/pacing/index.js +18 -38
- package/dist/pacing/index.js.map +1 -1
- package/dist/video/index.js +103 -137
- package/dist/video/index.js.map +1 -1
- package/dist/video/keyframe-gate.js +5 -17
- package/dist/video/keyframe-gate.js.map +1 -1
- package/dist/video/video-render-pipeline.js +103 -137
- package/dist/video/video-render-pipeline.js.map +1 -1
- package/dist/worklet/render-worklet.js +171 -219
- package/dist/worklet/render-worklet.js.map +2 -2
- package/package.json +3 -3
package/dist/video/index.js
CHANGED
|
@@ -1,58 +1,36 @@
|
|
|
1
|
-
var __typeError = (msg) => {
|
|
2
|
-
throw TypeError(msg);
|
|
3
|
-
};
|
|
4
|
-
var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
|
|
5
|
-
var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
|
|
6
|
-
var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
|
|
7
|
-
var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
|
|
8
|
-
var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
|
|
9
|
-
var __privateWrapper = (obj, member, setter, getter) => ({
|
|
10
|
-
set _(value) {
|
|
11
|
-
__privateSet(obj, member, value, setter);
|
|
12
|
-
},
|
|
13
|
-
get _() {
|
|
14
|
-
return __privateGet(obj, member, getter);
|
|
15
|
-
}
|
|
16
|
-
});
|
|
17
|
-
|
|
18
1
|
// src/video/keyframe-gate.ts
|
|
19
|
-
var _open;
|
|
20
2
|
var KeyframeGate = class {
|
|
21
|
-
|
|
22
|
-
__privateAdd(this, _open, false);
|
|
23
|
-
}
|
|
3
|
+
#open = false;
|
|
24
4
|
get isOpen() {
|
|
25
|
-
return
|
|
5
|
+
return this.#open;
|
|
26
6
|
}
|
|
27
7
|
/**
|
|
28
8
|
* Decide whether to pass a frame through.
|
|
29
9
|
* Opens permanently once the first keyframe is seen.
|
|
30
10
|
*/
|
|
31
11
|
allow(keyframe) {
|
|
32
|
-
if (
|
|
12
|
+
if (this.#open) return true;
|
|
33
13
|
if (keyframe) {
|
|
34
|
-
|
|
14
|
+
this.#open = true;
|
|
35
15
|
return true;
|
|
36
16
|
}
|
|
37
17
|
return false;
|
|
38
18
|
}
|
|
39
19
|
/** Re-close the gate. Next keyframe reopens it. */
|
|
40
20
|
reset() {
|
|
41
|
-
|
|
21
|
+
this.#open = false;
|
|
42
22
|
}
|
|
43
23
|
};
|
|
44
|
-
_open = new WeakMap();
|
|
45
24
|
|
|
46
25
|
// src/video/video-render-pipeline.ts
|
|
47
26
|
import { MmtpDecodePipeline } from "@blockcast/mmt-container/mmtp-decode-pipeline";
|
|
48
27
|
|
|
49
28
|
// src/pacing/frame-pacer.ts
|
|
50
|
-
var _frameCount, _anchorWallMs, _anchored;
|
|
51
29
|
var FrameCountPacer = class {
|
|
30
|
+
#frameCount = 0;
|
|
31
|
+
#anchorWallMs = 0;
|
|
32
|
+
#anchored = false;
|
|
52
33
|
constructor(opts) {
|
|
53
|
-
__privateAdd(this, _frameCount, 0);
|
|
54
|
-
__privateAdd(this, _anchorWallMs, 0);
|
|
55
|
-
__privateAdd(this, _anchored, false);
|
|
56
34
|
if (!(opts.frameDurationMs > 0)) {
|
|
57
35
|
throw new Error("frameDurationMs must be > 0");
|
|
58
36
|
}
|
|
@@ -62,11 +40,11 @@ var FrameCountPacer = class {
|
|
|
62
40
|
}
|
|
63
41
|
/** Call on every emitted decoded frame (AU or picture). Anchors on first call. */
|
|
64
42
|
notifyFrame() {
|
|
65
|
-
if (!
|
|
66
|
-
|
|
67
|
-
|
|
43
|
+
if (!this.#anchored) {
|
|
44
|
+
this.#anchorWallMs = now();
|
|
45
|
+
this.#anchored = true;
|
|
68
46
|
}
|
|
69
|
-
|
|
47
|
+
this.#frameCount++;
|
|
70
48
|
}
|
|
71
49
|
/**
|
|
72
50
|
* Compute sleep ms before reading the next MoQ object.
|
|
@@ -100,39 +78,36 @@ var FrameCountPacer = class {
|
|
|
100
78
|
*/
|
|
101
79
|
computeSleepMs(observedDelayMs) {
|
|
102
80
|
if (this.thresholdMs <= 0) return 0;
|
|
103
|
-
if (!
|
|
104
|
-
if (
|
|
81
|
+
if (!this.#anchored) return 0;
|
|
82
|
+
if (this.#frameCount <= this.warmupFrames) return 0;
|
|
105
83
|
if (observedDelayMs !== void 0 && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {
|
|
106
84
|
return 0;
|
|
107
85
|
}
|
|
108
|
-
const mediaMs =
|
|
109
|
-
const wallMs = now() -
|
|
86
|
+
const mediaMs = this.#frameCount * this.frameDurationMs;
|
|
87
|
+
const wallMs = now() - this.#anchorWallMs;
|
|
110
88
|
const aheadMs = mediaMs - wallMs;
|
|
111
89
|
if (aheadMs <= this.thresholdMs) return 0;
|
|
112
90
|
return aheadMs - this.thresholdMs / 2;
|
|
113
91
|
}
|
|
114
92
|
/** Reset anchor + counter. Call on source switch (MoQ ↔ multicast). */
|
|
115
93
|
reset() {
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
94
|
+
this.#frameCount = 0;
|
|
95
|
+
this.#anchorWallMs = 0;
|
|
96
|
+
this.#anchored = false;
|
|
119
97
|
}
|
|
120
98
|
get snapshot() {
|
|
121
|
-
const mediaMs =
|
|
122
|
-
const wallMs =
|
|
99
|
+
const mediaMs = this.#frameCount * this.frameDurationMs;
|
|
100
|
+
const wallMs = this.#anchored ? now() - this.#anchorWallMs : 0;
|
|
123
101
|
return {
|
|
124
|
-
frameCount:
|
|
102
|
+
frameCount: this.#frameCount,
|
|
125
103
|
mediaMs,
|
|
126
104
|
wallMs,
|
|
127
105
|
aheadMs: mediaMs - wallMs,
|
|
128
106
|
thresholdMs: this.thresholdMs,
|
|
129
|
-
anchored:
|
|
107
|
+
anchored: this.#anchored
|
|
130
108
|
};
|
|
131
109
|
}
|
|
132
110
|
};
|
|
133
|
-
_frameCount = new WeakMap();
|
|
134
|
-
_anchorWallMs = new WeakMap();
|
|
135
|
-
_anchored = new WeakMap();
|
|
136
111
|
function now() {
|
|
137
112
|
if (typeof performance !== "undefined" && typeof performance.now === "function") {
|
|
138
113
|
return performance.now();
|
|
@@ -145,124 +120,115 @@ function deriveVideoReorderWindow(framerate, mapper) {
|
|
|
145
120
|
const framesPerGroup = Math.ceil(framerate * mapper.gopDurationMs / 1e3);
|
|
146
121
|
return mapper.d * framesPerGroup;
|
|
147
122
|
}
|
|
148
|
-
var _pacer, _gate, _opts, _decoder, _pipeline, _closed, _VideoRenderPipeline_instances, init_fn, configureDecoder_fn;
|
|
149
123
|
var VideoRenderPipeline = class {
|
|
124
|
+
#pacer;
|
|
125
|
+
#gate = new KeyframeGate();
|
|
126
|
+
#opts;
|
|
127
|
+
#decoder = null;
|
|
128
|
+
#pipeline = null;
|
|
129
|
+
#closed = false;
|
|
150
130
|
constructor(opts) {
|
|
151
|
-
__privateAdd(this, _VideoRenderPipeline_instances);
|
|
152
|
-
__privateAdd(this, _pacer);
|
|
153
|
-
__privateAdd(this, _gate, new KeyframeGate());
|
|
154
|
-
__privateAdd(this, _opts);
|
|
155
|
-
__privateAdd(this, _decoder, null);
|
|
156
|
-
__privateAdd(this, _pipeline, null);
|
|
157
|
-
__privateAdd(this, _closed, false);
|
|
158
131
|
if (!(opts.framerate > 0)) throw new Error("framerate must be > 0");
|
|
159
|
-
|
|
160
|
-
|
|
132
|
+
this.#opts = opts;
|
|
133
|
+
this.#pacer = new FrameCountPacer({
|
|
161
134
|
frameDurationMs: 1e3 / opts.framerate,
|
|
162
135
|
mapper: opts.mapper,
|
|
163
136
|
warmupFrames: opts.warmupFrames ?? 3
|
|
164
|
-
})
|
|
165
|
-
|
|
137
|
+
});
|
|
138
|
+
this.#init();
|
|
166
139
|
}
|
|
167
140
|
feedMoqObject(packet) {
|
|
168
|
-
|
|
141
|
+
this.#pipeline?.feedMoqObject(packet);
|
|
169
142
|
}
|
|
170
143
|
paceSleepMs() {
|
|
171
|
-
return
|
|
144
|
+
return this.#pacer.computeSleepMs();
|
|
172
145
|
}
|
|
173
146
|
get pacerSnapshot() {
|
|
174
|
-
return
|
|
147
|
+
return this.#pacer.snapshot;
|
|
175
148
|
}
|
|
176
149
|
/** Request a fresh keyframe after a decoder error (or source switch). */
|
|
177
150
|
reset() {
|
|
178
|
-
|
|
179
|
-
|
|
151
|
+
this.#gate.reset();
|
|
152
|
+
this.#pacer.reset();
|
|
180
153
|
try {
|
|
181
|
-
|
|
154
|
+
this.#decoder?.reset();
|
|
182
155
|
} catch {
|
|
183
156
|
}
|
|
184
|
-
|
|
157
|
+
this.#configureDecoder();
|
|
185
158
|
}
|
|
186
159
|
close() {
|
|
187
|
-
if (
|
|
188
|
-
|
|
160
|
+
if (this.#closed) return;
|
|
161
|
+
this.#closed = true;
|
|
189
162
|
try {
|
|
190
|
-
|
|
163
|
+
this.#decoder?.close();
|
|
191
164
|
} catch {
|
|
192
165
|
}
|
|
193
166
|
try {
|
|
194
|
-
|
|
167
|
+
this.#pipeline?.dispose();
|
|
195
168
|
} catch {
|
|
196
169
|
}
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
170
|
+
this.#decoder = null;
|
|
171
|
+
this.#pipeline = null;
|
|
172
|
+
}
|
|
173
|
+
// ─── Private ─────────────────────────────────────────────────────
|
|
174
|
+
#init() {
|
|
175
|
+
this.#configureDecoder();
|
|
176
|
+
const pipeline = new MmtpDecodePipeline();
|
|
177
|
+
const reorderWindow = this.#opts.reorderWindow ?? deriveVideoReorderWindow(this.#opts.framerate, this.#opts.mapper);
|
|
178
|
+
pipeline.configure({
|
|
179
|
+
codec: this.#opts.codec,
|
|
180
|
+
packetId: this.#opts.packetId,
|
|
181
|
+
description: this.#opts.description,
|
|
182
|
+
reorderWindow,
|
|
183
|
+
framerate: this.#opts.framerate,
|
|
184
|
+
groupDurationMs: this.#opts.mapper.gopDurationMs,
|
|
185
|
+
reassemblyPolicy: this.#opts.reassemblyPolicy
|
|
186
|
+
});
|
|
187
|
+
if (this.#opts.fecClient) pipeline.setFecClient(this.#opts.fecClient);
|
|
188
|
+
pipeline.onFrame((codecData, meta) => {
|
|
189
|
+
if (this.#closed || !this.#decoder) return;
|
|
190
|
+
if (codecData.byteLength === 0) return;
|
|
191
|
+
if (!this.#gate.allow(meta.keyframe)) return;
|
|
192
|
+
this.#pacer.notifyFrame();
|
|
193
|
+
try {
|
|
194
|
+
this.#decoder.decode(new EncodedVideoChunk({
|
|
195
|
+
type: meta.keyframe ? "key" : "delta",
|
|
196
|
+
data: codecData,
|
|
197
|
+
timestamp: meta.timestamp
|
|
198
|
+
}));
|
|
199
|
+
} catch (err) {
|
|
200
|
+
this.#opts.onError?.(err);
|
|
201
|
+
this.reset();
|
|
202
|
+
}
|
|
203
|
+
});
|
|
204
|
+
this.#pipeline = pipeline;
|
|
205
|
+
}
|
|
206
|
+
#configureDecoder() {
|
|
228
207
|
try {
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
data: codecData,
|
|
232
|
-
timestamp: meta.timestamp
|
|
233
|
-
}));
|
|
234
|
-
} catch (err) {
|
|
235
|
-
__privateGet(this, _opts).onError?.(err);
|
|
236
|
-
this.reset();
|
|
208
|
+
this.#decoder?.close();
|
|
209
|
+
} catch {
|
|
237
210
|
}
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
211
|
+
const userMeta = { timestamp: 0, keyframe: false, packetId: 0 };
|
|
212
|
+
const decoder = new VideoDecoder({
|
|
213
|
+
output: (frame) => {
|
|
214
|
+
userMeta.timestamp = frame.timestamp;
|
|
215
|
+
this.#opts.onFrame(frame, userMeta);
|
|
216
|
+
},
|
|
217
|
+
error: (err) => {
|
|
218
|
+
this.#opts.onError?.(err);
|
|
219
|
+
this.#gate.reset();
|
|
220
|
+
}
|
|
221
|
+
});
|
|
222
|
+
const config = {
|
|
223
|
+
codec: this.#opts.codec,
|
|
224
|
+
codedWidth: this.#opts.width,
|
|
225
|
+
codedHeight: this.#opts.height,
|
|
226
|
+
...this.#opts.description ? { description: this.#opts.description } : {},
|
|
227
|
+
...this.#opts.hardwareAcceleration ? { hardwareAcceleration: this.#opts.hardwareAcceleration } : {}
|
|
228
|
+
};
|
|
229
|
+
decoder.configure(config);
|
|
230
|
+
this.#decoder = decoder;
|
|
245
231
|
}
|
|
246
|
-
const userMeta = { timestamp: 0, keyframe: false, packetId: 0 };
|
|
247
|
-
const decoder = new VideoDecoder({
|
|
248
|
-
output: (frame) => {
|
|
249
|
-
userMeta.timestamp = frame.timestamp;
|
|
250
|
-
__privateGet(this, _opts).onFrame(frame, userMeta);
|
|
251
|
-
},
|
|
252
|
-
error: (err) => {
|
|
253
|
-
__privateGet(this, _opts).onError?.(err);
|
|
254
|
-
__privateGet(this, _gate).reset();
|
|
255
|
-
}
|
|
256
|
-
});
|
|
257
|
-
const config = {
|
|
258
|
-
codec: __privateGet(this, _opts).codec,
|
|
259
|
-
codedWidth: __privateGet(this, _opts).width,
|
|
260
|
-
codedHeight: __privateGet(this, _opts).height,
|
|
261
|
-
...__privateGet(this, _opts).description ? { description: __privateGet(this, _opts).description } : {},
|
|
262
|
-
...__privateGet(this, _opts).hardwareAcceleration ? { hardwareAcceleration: __privateGet(this, _opts).hardwareAcceleration } : {}
|
|
263
|
-
};
|
|
264
|
-
decoder.configure(config);
|
|
265
|
-
__privateSet(this, _decoder, decoder);
|
|
266
232
|
};
|
|
267
233
|
export {
|
|
268
234
|
KeyframeGate,
|
package/dist/video/index.js.map
CHANGED
|
@@ -2,6 +2,6 @@
|
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/video/keyframe-gate.ts", "../../src/video/video-render-pipeline.ts", "../../src/pacing/frame-pacer.ts"],
|
|
4
4
|
"sourcesContent": ["/**\n * KeyframeGate \u2014 drops delta frames until a keyframe arrives.\n *\n * Required when subscribing mid-stream: the relay may deliver P/B frames\n * from the middle of a GOP before the first IDR. Feeding those into\n * VideoDecoder before an init yields \"key frame required\" errors.\n *\n * Call reset() to re-arm the gate after a decoder error (requestKeyframe).\n */\n\nexport class KeyframeGate {\n #open = false\n\n get isOpen(): boolean {\n return this.#open\n }\n\n /**\n * Decide whether to pass a frame through.\n * Opens permanently once the first keyframe is seen.\n */\n allow(keyframe: boolean): boolean {\n if (this.#open) return true\n if (keyframe) {\n this.#open = true\n return true\n }\n return false\n }\n\n /** Re-close the gate. Next keyframe reopens it. */\n reset(): void {\n this.#open = false\n }\n}\n", "/**\n * VideoRenderPipeline \u2014 end-to-end video render for MoQ/MMT players.\n *\n * Pipeline: MoQ object \u2192 MmtpDecodePipeline \u2192 keyframe gate \u2192 WebCodecs\n * VideoDecoder \u2192 consumer's onFrame(VideoFrame).\n *\n * Replaces:\n * - moqtail's `decodeQueueSize > 10 drop-deltas` hack in webcodecs-backend.ts\n * - hang-mmt-fec's \"reorderWindow = 0 // TODO\" in video/decoder.ts\n *\n * Pacing uses FrameCountPacer (anchor on first decoded picture, frame count \u00D7\n * 1/fps) with threshold = mapper.pacingThresholdMs. Reorder window comes from\n * mapper.d (groups per FEC block), which is the natural bound for out-of-order\n * delivery within a block after converting catalog groups to frame count.\n */\n\nimport { MmtpDecodePipeline, type PipelineFecClient } from '@blockcast/mmt-container/mmtp-decode-pipeline'\nimport type { MfuReassemblyPolicy } from '@blockcast/mmt-container/mfu-reassembly-policy'\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\nimport { FrameCountPacer } from '../pacing/frame-pacer.js'\nimport { KeyframeGate } from './keyframe-gate.js'\n\nexport interface VideoFrameMeta {\n timestamp: number\n keyframe: boolean\n packetId: number\n}\n\nexport type VideoFrameCallback = (frame: VideoFrame, meta: VideoFrameMeta) => void\n\nexport function deriveVideoReorderWindow(\n framerate: number,\n mapper: Pick<FecBlockMapper, 'd' | 'gopDurationMs'>,\n): number {\n const framesPerGroup = Math.ceil(framerate * mapper.gopDurationMs / 1000)\n return mapper.d * framesPerGroup\n}\n\nexport interface VideoRenderPipelineOpts {\n codec: string\n /** MMTP packet_id for this video track \u2014 from catalog. */\n packetId?: number\n description?: Uint8Array\n width: number\n height: number\n /** Frames per second (used for pacing + default reorder window). */\n framerate: number\n mapper: FecBlockMapper\n fecClient?: PipelineFecClient\n /** Reliable MoQ is clock-free; datagram deadlines come from catalog/in-band timing. */\n reassemblyPolicy: MfuReassemblyPolicy\n /** Receives VideoFrames ready to render. */\n onFrame: VideoFrameCallback\n /** Called on decoder errors. */\n onError?: (err: unknown) => void\n /** Reorder window in frames. Defaults to one catalog-derived FEC block. */\n reorderWindow?: number\n /** Warmup frames before pacing engages. Default 3 (absorbs decoder init jitter). */\n warmupFrames?: number\n /** Optional decoder hardware acceleration hint. */\n hardwareAcceleration?: HardwareAcceleration\n}\n\nexport class VideoRenderPipeline {\n readonly #pacer: FrameCountPacer\n readonly #gate = new KeyframeGate()\n readonly #opts: VideoRenderPipelineOpts\n\n #decoder: VideoDecoder | null = null\n #pipeline: MmtpDecodePipeline | null = null\n #closed = false\n\n constructor(opts: VideoRenderPipelineOpts) {\n if (!(opts.framerate > 0)) throw new Error('framerate must be > 0')\n this.#opts = opts\n this.#pacer = new FrameCountPacer({\n frameDurationMs: 1000 / opts.framerate,\n mapper: opts.mapper,\n warmupFrames: opts.warmupFrames ?? 3,\n })\n this.#init()\n }\n\n feedMoqObject(packet: Uint8Array): void {\n this.#pipeline?.feedMoqObject(packet)\n }\n\n paceSleepMs(): number {\n return this.#pacer.computeSleepMs()\n }\n\n get pacerSnapshot() {\n return this.#pacer.snapshot\n }\n\n /** Request a fresh keyframe after a decoder error (or source switch). */\n reset(): void {\n this.#gate.reset()\n this.#pacer.reset()\n try { this.#decoder?.reset() } catch { /* may be closed */ }\n // Re-configure so the decoder is ready for the next keyframe.\n this.#configureDecoder()\n }\n\n close(): void {\n if (this.#closed) return\n this.#closed = true\n try { this.#decoder?.close() } catch { /* noop */ }\n try { this.#pipeline?.dispose() } catch { /* noop */ }\n this.#decoder = null\n this.#pipeline = null\n }\n\n // \u2500\u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n #init(): void {\n this.#configureDecoder()\n\n const pipeline = new MmtpDecodePipeline()\n const reorderWindow = this.#opts.reorderWindow\n ?? deriveVideoReorderWindow(this.#opts.framerate, this.#opts.mapper)\n pipeline.configure({\n codec: this.#opts.codec,\n packetId: this.#opts.packetId,\n description: this.#opts.description,\n reorderWindow,\n framerate: this.#opts.framerate,\n groupDurationMs: this.#opts.mapper.gopDurationMs,\n reassemblyPolicy: this.#opts.reassemblyPolicy,\n })\n if (this.#opts.fecClient) pipeline.setFecClient(this.#opts.fecClient)\n\n pipeline.onFrame((codecData, meta) => {\n if (this.#closed || !this.#decoder) return\n if (codecData.byteLength === 0) return\n if (!this.#gate.allow(meta.keyframe)) return\n\n this.#pacer.notifyFrame()\n try {\n this.#decoder.decode(new EncodedVideoChunk({\n type: meta.keyframe ? 'key' : 'delta',\n data: codecData,\n timestamp: meta.timestamp,\n }))\n } catch (err) {\n this.#opts.onError?.(err)\n this.reset()\n }\n })\n this.#pipeline = pipeline\n }\n\n #configureDecoder(): void {\n try { this.#decoder?.close() } catch { /* noop */ }\n\n const userMeta: VideoFrameMeta = { timestamp: 0, keyframe: false, packetId: 0 }\n const decoder = new VideoDecoder({\n output: (frame) => {\n // WebCodecs VideoFrame doesn't carry our frame meta; the consumer\n // rematches via frame.timestamp if needed.\n userMeta.timestamp = frame.timestamp\n this.#opts.onFrame(frame, userMeta)\n },\n error: (err) => {\n this.#opts.onError?.(err)\n this.#gate.reset()\n },\n })\n const config: VideoDecoderConfig = {\n codec: this.#opts.codec,\n codedWidth: this.#opts.width,\n codedHeight: this.#opts.height,\n ...(this.#opts.description ? { description: this.#opts.description } : {}),\n ...(this.#opts.hardwareAcceleration ? { hardwareAcceleration: this.#opts.hardwareAcceleration } : {}),\n }\n decoder.configure(config)\n this.#decoder = decoder\n }\n}\n", "/**\n * FrameCountPacer \u2014 media-agnostic wall-clock pacer for MMT A/V decode loops.\n *\n * Why not use MPU timestamps? Under FEC interleaving, encoders pack multiple\n * Access Units (AUs) per MMTP MPU with a single mpu_timestamp. The observed\n * timestamp delta between MPUs is a fraction of the real per-AU duration\n * (e.g. 10.22ms between MPUs for 21.33ms AAC frames at D=2 interleave).\n * Pacing on that delta sees \"media \u2248 wall\" and never sleeps, letting burst\n * relay delivery saturate the decoder / ring buffer.\n *\n * The Sony libatsc3 pattern (atsc3_mmt_context_mfu_depacketizer) solves this\n * by anchoring wall-clock time to the first received AU and counting AUs:\n * media_elapsed_ms = au_count \u00D7 nominal_au_duration_ms\n * The MPU timestamp is used elsewhere as an absolute-time anchor, never as\n * an incremental clock.\n *\n * The sleep threshold comes from the catalog's FEC interleaveDepthMs (via\n * FecBlockMapper.pacingThresholdMs). When no FEC is configured, a\n * NullBlockMapper yields threshold=0 and this pacer never sleeps.\n *\n * One pacer instance = one track (e.g. audio, video) on one player.\n */\n\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\n\nexport interface FrameCountPacerOpts {\n /** Required: AU duration (audio) or picture interval (video), in ms. */\n frameDurationMs: number\n /** FEC mapper from @blockcast/mmt-fec. NullBlockMapper disables pacing. */\n mapper: FecBlockMapper\n /**\n * Number of frames to let through before pacing starts. Lets startup\n * burst drain populate the ring buffer / decoder queue. Default 0.\n */\n warmupFrames?: number\n}\n\nexport interface PacerSnapshot {\n /** Frames observed (from notifyFrame). */\n frameCount: number\n /** Computed media time: frameCount \u00D7 frameDurationMs. */\n mediaMs: number\n /** Wall-clock time since anchor. */\n wallMs: number\n /** mediaMs - wallMs. Positive \u2192 decoder ahead of realtime. */\n aheadMs: number\n /** Pacing threshold (ms) from the FEC mapper. */\n thresholdMs: number\n /** Has the first frame been observed (wall anchor set)? */\n anchored: boolean\n}\n\nexport class FrameCountPacer {\n readonly frameDurationMs: number\n readonly thresholdMs: number\n readonly warmupFrames: number\n\n #frameCount = 0\n #anchorWallMs = 0\n #anchored = false\n\n constructor(opts: FrameCountPacerOpts) {\n if (!(opts.frameDurationMs > 0)) {\n throw new Error('frameDurationMs must be > 0')\n }\n this.frameDurationMs = opts.frameDurationMs\n this.thresholdMs = opts.mapper.pacingThresholdMs\n this.warmupFrames = Math.max(0, opts.warmupFrames ?? 0)\n }\n\n /** Call on every emitted decoded frame (AU or picture). Anchors on first call. */\n notifyFrame(): void {\n if (!this.#anchored) {\n this.#anchorWallMs = now()\n this.#anchored = true\n }\n this.#frameCount++\n }\n\n /**\n * Compute sleep ms before reading the next MoQ object.\n * Returns 0 when:\n * - pacing is disabled (NullBlockMapper \u2192 threshold=0)\n * - the anchor is not yet set\n * - still in warmup\n * - the caller reports a standing backlog (see `observedDelayMs`)\n * - decoder is not ahead of wall clock by more than threshold\n * Otherwise returns aheadMs - thresholdMs/2 (leaves half the threshold as headroom).\n *\n * `observedDelayMs` is how far this frame is behind the producer's own clock,\n * measured by the caller against a producer-supplied sending instant (for\n * MMTP, the header send-wall timestamp). It is optional because the anchored\n * rate below is blind to it: `#anchorWallMs` is the wall time of the FIRST\n * frame read, so `aheadMs` measures consumption against the join instant and\n * not against the producer. Once `aheadMs` reaches the threshold the loop\n * consumes at exactly the source rate, and recovering latency present at join\n * requires consuming FASTER than the source rate. So without this argument a\n * consumer that joined a live stream mid-block keeps that join latency for the\n * life of the subscription.\n *\n * A caller that can measure the real distance from the producer passes it and\n * gets a drain: while the backlog exceeds the threshold there is nothing to\n * pace against, so return 0 and let the transport set the rate. At the live\n * edge the anchored-rate behavior below applies unchanged.\n *\n * Callers with no producer clock omit it and keep the pure ATSC3-style\n * anchored pacing (see the class doc), where a first-frame anchor is correct\n * because a broadcast push has no live edge to catch up to.\n */\n computeSleepMs(observedDelayMs?: number): number {\n if (this.thresholdMs <= 0) return 0\n if (!this.#anchored) return 0\n if (this.#frameCount <= this.warmupFrames) return 0\n // Only a finite measurement can license the drain. NaN/Infinity mean the\n // caller could not measure the distance, which is not the same claim as\n // \"the consumer is at the edge\", so fall through to anchored pacing.\n if (observedDelayMs !== undefined && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {\n return 0\n }\n\n const mediaMs = this.#frameCount * this.frameDurationMs\n const wallMs = now() - this.#anchorWallMs\n const aheadMs = mediaMs - wallMs\n if (aheadMs <= this.thresholdMs) return 0\n return aheadMs - this.thresholdMs / 2\n }\n\n /** Reset anchor + counter. Call on source switch (MoQ \u2194 multicast). */\n reset(): void {\n this.#frameCount = 0\n this.#anchorWallMs = 0\n this.#anchored = false\n }\n\n get snapshot(): PacerSnapshot {\n const mediaMs = this.#frameCount * this.frameDurationMs\n const wallMs = this.#anchored ? now() - this.#anchorWallMs : 0\n return {\n frameCount: this.#frameCount,\n mediaMs,\n wallMs,\n aheadMs: mediaMs - wallMs,\n thresholdMs: this.thresholdMs,\n anchored: this.#anchored,\n }\n }\n}\n\nfunction now(): number {\n // performance.now() is available in main thread, workers, and AudioWorklet.\n // Fall back to Date.now() for exotic runtimes (shouldn't happen in browsers).\n if (typeof performance !== 'undefined' && typeof performance.now === 'function') {\n return performance.now()\n }\n return Date.now()\n}\n"],
|
|
5
|
-
"mappings": "
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,38 +1,26 @@
|
|
|
1
|
-
var __typeError = (msg) => {
|
|
2
|
-
throw TypeError(msg);
|
|
3
|
-
};
|
|
4
|
-
var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
|
|
5
|
-
var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
|
|
6
|
-
var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
|
|
7
|
-
var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
|
|
8
|
-
|
|
9
1
|
// src/video/keyframe-gate.ts
|
|
10
|
-
var _open;
|
|
11
2
|
var KeyframeGate = class {
|
|
12
|
-
|
|
13
|
-
__privateAdd(this, _open, false);
|
|
14
|
-
}
|
|
3
|
+
#open = false;
|
|
15
4
|
get isOpen() {
|
|
16
|
-
return
|
|
5
|
+
return this.#open;
|
|
17
6
|
}
|
|
18
7
|
/**
|
|
19
8
|
* Decide whether to pass a frame through.
|
|
20
9
|
* Opens permanently once the first keyframe is seen.
|
|
21
10
|
*/
|
|
22
11
|
allow(keyframe) {
|
|
23
|
-
if (
|
|
12
|
+
if (this.#open) return true;
|
|
24
13
|
if (keyframe) {
|
|
25
|
-
|
|
14
|
+
this.#open = true;
|
|
26
15
|
return true;
|
|
27
16
|
}
|
|
28
17
|
return false;
|
|
29
18
|
}
|
|
30
19
|
/** Re-close the gate. Next keyframe reopens it. */
|
|
31
20
|
reset() {
|
|
32
|
-
|
|
21
|
+
this.#open = false;
|
|
33
22
|
}
|
|
34
23
|
};
|
|
35
|
-
_open = new WeakMap();
|
|
36
24
|
export {
|
|
37
25
|
KeyframeGate
|
|
38
26
|
};
|
|
@@ -2,6 +2,6 @@
|
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/video/keyframe-gate.ts"],
|
|
4
4
|
"sourcesContent": ["/**\n * KeyframeGate \u2014 drops delta frames until a keyframe arrives.\n *\n * Required when subscribing mid-stream: the relay may deliver P/B frames\n * from the middle of a GOP before the first IDR. Feeding those into\n * VideoDecoder before an init yields \"key frame required\" errors.\n *\n * Call reset() to re-arm the gate after a decoder error (requestKeyframe).\n */\n\nexport class KeyframeGate {\n #open = false\n\n get isOpen(): boolean {\n return this.#open\n }\n\n /**\n * Decide whether to pass a frame through.\n * Opens permanently once the first keyframe is seen.\n */\n allow(keyframe: boolean): boolean {\n if (this.#open) return true\n if (keyframe) {\n this.#open = true\n return true\n }\n return false\n }\n\n /** Re-close the gate. Next keyframe reopens it. */\n reset(): void {\n this.#open = false\n }\n}\n"],
|
|
5
|
-
"mappings": "
|
|
5
|
+
"mappings": ";AAUO,IAAM,eAAN,MAAmB;AAAA,EACxB,QAAQ;AAAA,EAER,IAAI,SAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAA4B;AAChC,QAAI,KAAK,MAAO,QAAO;AACvB,QAAI,UAAU;AACZ,WAAK,QAAQ;AACb,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|