@norskvideo/moq-hang 0.1.0

package/util/latency.js

@@ -0,0 +1,49 @@
+/* @ts-self-types="./latency.d.ts" */
+import { Time } from "@norskvideo/moq-net";
+import { Effect, Signal } from "@norskvideo/moq-signals";
+/**
+ * A helper class that computes the final latency based on the catalog's jitter and the user's buffer.
+ * If the jitter is not present, then we use framerate to estimate a default.
+ *
+ * Effective latency = catalog.jitter + buffer
+ */
+export class Latency {
+    /** The user-configured buffer, added on top of the catalog jitter. */
+    buffer;
+    /** The track config supplying jitter and framerate. */
+    config;
+    /** The reactive effect recomputing the combined latency. */
+    signals = new Effect();
+    #combined = new Signal(0);
+    /** The effective latency in milliseconds (catalog jitter plus buffer). */
+    combined = this.#combined;
+    /** Start tracking latency from the given buffer and config signals. */
+    constructor(props) {
+        this.buffer = props.buffer;
+        this.config = props.config;
+        this.signals.run(this.#run.bind(this));
+    }
+    #run(effect) {
+        const buffer = effect.get(this.buffer);
+        // Compute the latency based on the catalog's jitter and the user's buffer.
+        const config = effect.get(this.config);
+        // Use jitter from catalog if available, otherwise estimate from framerate
+        let jitter = config?.jitter;
+        if (jitter === undefined && config?.framerate !== undefined && config.framerate > 0) {
+            // Estimate jitter as one frame duration if framerate is available
+            jitter = 1000 / config.framerate;
+        }
+        jitter ??= 0;
+        const latency = Time.Milli.add(jitter, buffer);
+        this.#combined.set(latency);
+    }
+    /** Read the current effective latency without subscribing. */
+    peek() {
+        return this.#combined.peek();
+    }
+    /** Stop tracking and release the effect. */
+    close() {
+        this.signals.close();
+    }
+}
+//# sourceMappingURL=latency.js.map

package/util/latency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency.js","sourceRoot":"","sources":["../../src/util/latency.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,EAAe,MAAM,EAAE,MAAM,cAAc,CAAC;AAY3D;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IACnB,sEAAsE;IACtE,MAAM,CAAyB;IAC/B,uDAAuD;IACvD,MAAM,CAAuC;IAE7C,4DAA4D;IAC5D,OAAO,GAAG,IAAI,MAAM,EAAE,CAAC;IAEvB,SAAS,GAAG,IAAI,MAAM,CAAiB,CAAmB,CAAC,CAAC;IAC5D,0EAA0E;IACjE,QAAQ,GAA2B,IAAI,CAAC,SAAS,CAAC;IAE3D,uEAAuE;IACvE,YAAY,KAAmB;QAC9B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,MAAc;QAClB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvC,2EAA2E;QAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvC,0EAA0E;QAC1E,IAAI,MAAM,GAAuB,MAAM,EAAE,MAAM,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACrF,kEAAkE;YAClE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,CAAC;QACD,MAAM,KAAK,CAAC,CAAC;QAEb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAwB,EAAE,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,8DAA8D;IAC9D,IAAI;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACJ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACD","sourcesContent":["import type * as Moq from \"@moq/net\";\nimport { Time } from \"@moq/net\";\nimport { Effect, type Getter, Signal } from \"@moq/signals\";\n\ntype ConfigWithJitter = { jitter?: number; framerate?: number };\n\n/** Options for constructing a {@link Latency}. */\nexport interface LatencyProps {\n\t/** The user-configured buffer, added on top of the catalog jitter. */\n\tbuffer: Signal<Moq.Time.Milli>;\n\t/** The track config supplying jitter and framerate, or undefined until known. */\n\tconfig: Getter<ConfigWithJitter | undefined>;\n}\n\n/**\n * A helper class that computes the final latency based on the catalog's jitter and the user's buffer.\n * If the jitter is not present, then we use framerate to estimate a default.\n *\n * Effective latency = catalog.jitter + buffer\n */\nexport class Latency {\n\t/** The user-configured buffer, added on top of the catalog jitter. */\n\tbuffer: Signal<Moq.Time.Milli>;\n\t/** The track config supplying jitter and framerate. */\n\tconfig: Getter<ConfigWithJitter | undefined>;\n\n\t/** The reactive effect recomputing the combined latency. */\n\tsignals = new Effect();\n\n\t#combined = new Signal<Moq.Time.Milli>(0 as Moq.Time.Milli);\n\t/** The effective latency in milliseconds (catalog jitter plus buffer). */\n\treadonly combined: Signal<Moq.Time.Milli> = this.#combined;\n\n\t/** Start tracking latency from the given buffer and config signals. */\n\tconstructor(props: LatencyProps) {\n\t\tthis.buffer = props.buffer;\n\t\tthis.config = props.config;\n\n\t\tthis.signals.run(this.#run.bind(this));\n\t}\n\n\t#run(effect: Effect): void {\n\t\tconst buffer = effect.get(this.buffer);\n\n\t\t// Compute the latency based on the catalog's jitter and the user's buffer.\n\t\tconst config = effect.get(this.config);\n\n\t\t// Use jitter from catalog if available, otherwise estimate from framerate\n\t\tlet jitter: number | undefined = config?.jitter;\n\t\tif (jitter === undefined && config?.framerate !== undefined && config.framerate > 0) {\n\t\t\t// Estimate jitter as one frame duration if framerate is available\n\t\t\tjitter = 1000 / config.framerate;\n\t\t}\n\t\tjitter ??= 0;\n\n\t\tconst latency = Time.Milli.add(jitter as Moq.Time.Milli, buffer);\n\t\tthis.#combined.set(latency);\n\t}\n\n\t/** Read the current effective latency without subscribing. */\n\tpeek(): Moq.Time.Milli {\n\t\treturn this.#combined.peek();\n\t}\n\n\t/** Stop tracking and release the effect. */\n\tclose(): void {\n\t\tthis.signals.close();\n\t}\n}\n"]}

package/util/libav.d.ts

@@ -0,0 +1,3 @@
+/** Load the libav WebCodecs polyfill (Opus) if AudioEncoder/AudioDecoder are missing. Resolves true once available. */
+export declare function polyfill(): Promise<boolean>;
+//# sourceMappingURL=libav.d.ts.map

package/util/libav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libav.d.ts","sourceRoot":"","sources":["../../src/util/libav.ts"],"names":[],"mappings":"AAEA,uHAAuH;AACvH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAuBjD"}

package/util/libav.js

@@ -0,0 +1,26 @@
+/* @ts-self-types="./libav.d.ts" */
+let loading;
+/** Load the libav WebCodecs polyfill (Opus) if AudioEncoder/AudioDecoder are missing. Resolves true once available. */
+export async function polyfill() {
+    if (globalThis.AudioEncoder && globalThis.AudioDecoder) {
+        return true;
+    }
+    if (!loading) {
+        console.warn("using Opus polyfill; performance may be degraded");
+        // Load the polyfill and the libav variant we're using.
+        // TODO build with AAC support.
+        // I forked libavjs-webcodecs-polyfill to avoid Typescript errors; there's no changes otherwise.
+        loading = Promise.all([
+            import("@libav.js/variant-opus-af"),
+            import("@kixelated/libavjs-webcodecs-polyfill"),
+        ]).then(async ([opus, libav]) => {
+            await libav.load({
+                LibAV: opus,
+                polyfill: true,
+            });
+            return true;
+        });
+    }
+    return await loading;
+}
+//# sourceMappingURL=libav.js.map

package/util/libav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libav.js","sourceRoot":"","sources":["../../src/util/libav.ts"],"names":[],"mappings":"AAAA,IAAI,OAAqC,CAAC;AAE1C,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC7B,IAAI,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAEjE,uDAAuD;QACvD,+BAA+B;QAC/B,gGAAgG;QAChG,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;YACrB,MAAM,CAAC,2BAA2B,CAAC;YACnC,MAAM,CAAC,uCAAuC,CAAC;SAC/C,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;YAC/B,MAAM,KAAK,CAAC,IAAI,CAAC;gBAChB,KAAK,EAAE,IAAI;gBACX,QAAQ,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACb,CAAC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,OAAO,CAAC;AACtB,CAAC","sourcesContent":["let loading: Promise<boolean> | undefined;\n\n/** Load the libav WebCodecs polyfill (Opus) if AudioEncoder/AudioDecoder are missing. Resolves true once available. */\nexport async function polyfill(): Promise<boolean> {\n\tif (globalThis.AudioEncoder && globalThis.AudioDecoder) {\n\t\treturn true;\n\t}\n\n\tif (!loading) {\n\t\tconsole.warn(\"using Opus polyfill; performance may be degraded\");\n\n\t\t// Load the polyfill and the libav variant we're using.\n\t\t// TODO build with AAC support.\n\t\t// I forked libavjs-webcodecs-polyfill to avoid Typescript errors; there's no changes otherwise.\n\t\tloading = Promise.all([\n\t\t\timport(\"@libav.js/variant-opus-af\"),\n\t\t\timport(\"@kixelated/libavjs-webcodecs-polyfill\"),\n\t\t]).then(async ([opus, libav]) => {\n\t\t\tawait libav.load({\n\t\t\t\tLibAV: opus,\n\t\t\t\tpolyfill: true,\n\t\t\t});\n\t\t\treturn true;\n\t\t});\n\t}\n\treturn await loading;\n}\n"]}