@homebridge-plugins/homebridge-eufy-security 5.0.0-beta.35 → 5.0.0-beta.36

package/dist/media/live-preview.js

@@ -1,26 +1,72 @@
 import { spawn } from 'node:child_process';
-import { commonArguments, PROCESS_STOP_GRACE_MS } from './live-stream.js';
+import { adaptationReporter, AdaptationStderr, commonArguments, stopProcess, } from './live-stream.js';
 /** How long one preview runs before it ends on its own, so a page left open does not hold a camera. */
-export const LIVE_PREVIEW_MAX_MS = 3 * 60_000;
+const LIVE_PREVIEW_MAX_MS = 3 * 60_000;
+/** How long coded video may flow without decoding to a picture before the HomeKit side ends as unplayable. */
+export const LIVE_PREVIEW_PICTURE_MS = 10_000;
 /** The most bytes one picture may reach before FFmpeg's output is taken as no longer pictures. */
 const MAX_PICTURE_BYTES = 1024 * 1024;
 const JPEG_END = Buffer.from([0xff, 0xd9]);
-/** The FFmpeg input format each SDK codec is read in. AV1 has none, so such a camera has no preview. */
-const INPUT_FORMATS = { h264: 'h264', h265: 'hevc' };
+/** The JPEG output both preview sides are decoded into: five pictures a second, 640 pixels wide, on stdout. */
+const STILLS = ['-an', '-vf', 'fps=5,scale=640:-2', '-q:v', '8', '-f', 'image2pipe', '-c:v', 'mjpeg', 'pipe:1'];
+/** What an iPhone asks a camera for, on Wi-Fi and on cellular: High 4.0 at 30 fps over a 1378-byte MTU. */
+const IPHONE = { fps: 30, profile: 'high', level: '4.0', payloadType: 99, ssrc: 1, mtu: 1378, rtcpInterval: 0.5 };
+const IPHONE_ASKS = {
+    wifi: { ...IPHONE, width: 1280, height: 720, maxBitRate: 299 },
+    cellular: { ...IPHONE, width: 640, height: 360, maxBitRate: 132 },
+};
 /**
- * A camera's live video as JPEG pictures, five a second and 640 pixels wide, for the settings page.
+ * A camera's live video as JPEG pictures for the settings page, five a second and 640 pixels wide, on two sides:
+ * `raw` decoded straight from the camera, and `homekit` coded as a live session configured with `adaptation`
+ * codes it for that iPhone ask, and decoded again.
  *
- * Starts at the first keyframe and has no audio. A write FFmpeg refuses holds the SDK source until it drains,
- * so the SDK's keyframe-aware queue is the only one. A codec change, a source or FFmpeg failure, the time limit
- * and the returned stop all end it, and `onEnd` is called exactly once whichever came first.
+ * Each picture carries its side, the encoder of the HomeKit side and, once that has written for a second, the
+ * kilobits a second it wrote.
+ *
+ * The SDK source is fanned out to two FFmpegs: one decodes it into the `raw` pictures, one runs the session's own
+ * encoder and argument list and writes the coded H.264 elementary stream, which a third decodes into the
+ * `homekit` pictures. The camera side starts at the first keyframe, and each HomeKit run at a keyframe too. No
+ * audio. A write either refuses holds the SDK source until it drains, so the SDK's keyframe-aware queue is the
+ * only one, and the HomeKit decoder holds the encoder the same way.
+ *
+ * `adapt` ends the HomeKit run and starts the next with other settings at the next keyframe, leaving the source
+ * and the camera side running. A HomeKit run that fails, or yields no picture within
+ * {@link LIVE_PREVIEW_PICTURE_MS}, ends alone with an empty `homekit` picture while the camera side showed, and
+ * no other starts until `adapt`. `onRun` is called once with each run's result, and with one result where none
+ * started. A codec change, a source or camera side failure, the time limit and `stop` end the whole preview, and
+ * `onEnd` is called exactly once, saying whether the last run was unplayable. `diagnostics` receives each
+ * process's `started` and `output` notices as a live session's do, under the `preview-raw`, `preview-encode` and
+ * `preview-decode` roles.
  */
-export function startLivePreview(executable, source, onPicture, onEnd) {
+export function startLivePreview(executable, media, source, adaptation, onPicture, onRun, onEnd, diagnostics) {
+    const report = adaptationReporter(diagnostics);
     const abandonment = new AbortController();
     let live;
-    let ffmpeg;
+    let raw;
+    let rawPictures = 0;
     let codec;
+    let homekit;
+    let latest;
+    let wanted = true;
+    let last;
     let ended = false;
-    const end = () => {
+    const finish = (stopped) => {
+        const run = homekit;
+        homekit = undefined;
+        clearTimeout(run?.pictureless);
+        run?.processes.forEach(stopProcess);
+        const { profile, level, width, height, fps, maxBitRate } = IPHONE_ASKS[adaptation.ask];
+        last = {
+            outcome: run?.pictures ? 'picture' : stopped ? 'stopped' : rawPictures ? 'unplayable' : 'no-video',
+            selection: { profile, level, width, height, fps, maxBitRate },
+            ...adaptation,
+            ...(run ? { encoder: run.coding.encoder } : {}),
+            ...(codec ? { source: codec } : {}),
+            ...(run?.coding.kbps === undefined ? {} : { kbps: run.coding.kbps }),
+        };
+        onRun(last);
+    };
+    const end = (stopped = false) => {
         if (ended)
             return;
         ended = true;
@@ -32,34 +78,85 @@ export function startLivePreview(executable, source, onPicture, onEnd) {
         catch {
             live = undefined;
         }
-        if (ffmpeg) {
-            const process = ffmpeg;
-            process.stdin?.destroy();
-            process.kill('SIGTERM');
-            const kill = setTimeout(() => process.kill('SIGKILL'), PROCESS_STOP_GRACE_MS);
-            kill.unref();
-            process.once('exit', () => clearTimeout(kill));
-        }
-        onEnd();
+        if (homekit || !last)
+            finish(stopped);
+        if (raw)
+            stopProcess(raw);
+        onEnd(last?.outcome === 'unplayable');
+    };
+    const fail = () => {
+        if (!rawPictures)
+            return end();
+        const encoder = homekit.coding.encoder;
+        finish(false);
+        onPicture(Buffer.alloc(0), { side: 'homekit', encoder });
     };
-    const deadline = setTimeout(end, LIVE_PREVIEW_MAX_MS);
+    const deadline = setTimeout(() => end(), LIVE_PREVIEW_MAX_MS);
     deadline.unref();
-    const adapt = (format) => {
-        const process = spawn(executable, [...commonArguments(format), '-an', '-vf', 'fps=5,scale=640:-2', '-q:v', '8', '-f', 'image2pipe', '-c:v', 'mjpeg', 'pipe:1'], { stdio: ['pipe', 'pipe', 'ignore'] });
-        process.once('error', end);
-        process.once('exit', end);
-        process.stdin.on('error', end);
+    const spawnRole = (role, args) => {
+        const process = spawn(executable, args, { stdio: ['pipe', 'pipe', 'pipe'] });
+        const stderr = new AdaptationStderr();
+        const lost = () => {
+            if (process === raw)
+                end();
+            else if (homekit?.processes.includes(process))
+                fail();
+        };
+        process.stderr.on('data', (chunk) => stderr.observe(chunk));
+        process.once('error', lost);
+        process.once('exit', (code, signal) => {
+            report(role, 'output', stderr, code, signal);
+            lost();
+        });
+        process.stdin.on('error', lost);
+        return process;
+    };
+    const stills = (output, side, run) => {
         let pending = Buffer.alloc(0);
-        process.stdout.on('data', (chunk) => {
+        output.on('data', (chunk) => {
             pending = Buffer.concat([pending, chunk]);
             for (let at = pending.indexOf(JPEG_END); at !== -1; at = pending.indexOf(JPEG_END)) {
-                onPicture(pending.subarray(0, at + JPEG_END.length));
+                if (run && run !== homekit)
+                    return;
+                if (run) {
+                    clearTimeout(run.pictureless);
+                    run.pictures += 1;
+                }
+                else
+                    rawPictures += 1;
+                onPicture(pending.subarray(0, at + JPEG_END.length), { side, ...(run ?? latest).coding });
                 pending = pending.subarray(at + JPEG_END.length);
             }
             if (pending.length > MAX_PICTURE_BYTES)
                 end();
         });
-        return process;
+    };
+    const startHomeKit = (input) => {
+        const ask = IPHONE_ASKS[adaptation.ask];
+        const { encoder, args } = media.videoAdaptation(input, ask, ['-f', 'h264', 'pipe:1'], adaptation);
+        const cause = last ? 'controller-selection' : 'first';
+        diagnostics?.report({ role: 'preview-encode', event: 'started', cause, encoder, source: input });
+        const encoding = spawnRole('preview-encode', args);
+        diagnostics?.report({ role: 'preview-decode', event: 'started', cause, source: 'h264' });
+        const decoding = spawnRole('preview-decode', [...commonArguments('h264'), ...STILLS]);
+        const run = { processes: [encoding, decoding], coding: { encoder }, pictures: 0 };
+        let firstCodedAt;
+        let countedBytes = 0;
+        encoding.stdout.on('data', (chunk) => {
+            const now = Date.now();
+            if (firstCodedAt === undefined) {
+                firstCodedAt = now;
+                run.pictureless = setTimeout(() => run === homekit && fail(), LIVE_PREVIEW_PICTURE_MS);
+                run.pictureless.unref();
+                return;
+            }
+            countedBytes += chunk.length;
+            if (now - firstCodedAt >= 1_000)
+                run.coding.kbps = Math.round((countedBytes * 8) / (now - firstCodedAt));
+        });
+        encoding.stdout.pipe(decoding.stdin);
+        stills(decoding.stdout, 'homekit', run);
+        return (latest = run);
     };
     source.live({ signal: abandonment.signal }).then((consumer) => {
         if (ended) {
@@ -67,30 +164,54 @@ export function startLivePreview(executable, source, onPicture, onEnd) {
             return;
         }
         live = consumer;
-        consumer.on('error', end);
-        consumer.on('stop', end);
+        consumer.on('error', () => end());
+        consumer.on('stop', () => end());
         consumer.on('budget', (notice) => notice.extend());
+        let held = 0;
+        const feed = (stdin, data) => {
+            if (stdin.write(data))
+                return;
+            held += 1;
+            consumer.pause();
+            const release = () => {
+                stdin.off('drain', release).off('close', release);
+                if (--held === 0)
+                    consumer.resume();
+            };
+            stdin.on('drain', release).on('close', release);
+        };
         consumer.on('video', (frame) => {
             if (ended)
                 return;
-            if (!ffmpeg) {
-                const format = INPUT_FORMATS[frame.codec];
+            if (!raw) {
                 if (!frame.keyframe)
                     return;
-                if (!format)
-                    return end();
                 codec = frame.codec;
-                ffmpeg = adapt(format);
+                diagnostics?.report({ role: 'preview-raw', event: 'started', cause: 'first', source: codec });
+                raw = spawnRole('preview-raw', [...commonArguments(codec === 'h265' ? 'hevc' : codec), ...STILLS]);
+                stills(raw.stdout, 'raw');
             }
             if (frame.codec !== codec)
                 return end();
-            const stdin = ffmpeg.stdin;
-            if (!stdin.write(frame.data)) {
-                consumer.pause();
-                stdin.once('drain', () => consumer.resume());
+            if (wanted && frame.keyframe) {
+                wanted = false;
+                homekit = startHomeKit(codec);
             }
+            feed(raw.stdin, frame.data);
+            if (homekit)
+                feed(homekit.processes[0].stdin, frame.data);
         });
-    }, end);
-    return end;
+    }, () => end());
+    return {
+        stop: () => end(true),
+        adapt: (next) => {
+            if (ended)
+                return;
+            if (homekit)
+                finish(true);
+            adaptation = next;
+            wanted = true;
+        },
+    };
 }
 //# sourceMappingURL=live-preview.js.map

package/dist/media/live-preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"live-preview.js","sourceRoot":"","sources":["../../src/media/live-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAK3C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,uGAAuG;AACvG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,MAAM,CAAC;AAE9C,kGAAkG;AAClG,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAE3C,wGAAwG;AACxG,MAAM,aAAa,GAAqD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAEvG;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,MAAuB,EACvB,SAAiC,EACjC,KAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;IAC1C,IAAI,IAAoC,CAAC;IACzC,IAAI,MAA4C,CAAC;IACjD,IAAI,KAA0C,CAAC;IAC/C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,GAAG,GAAG,GAAS,EAAE;QACrB,IAAI,KAAK;YAAE,OAAO;QAClB,KAAK,GAAG,IAAI,CAAC;QACb,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,WAAW,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,EAAE,IAAI,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,MAAM,CAAC;YACvB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC,CAAC;YAC9E,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,EAAE,CAAC;IACV,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEjB,MAAM,KAAK,GAAG,CAAC,MAAc,EAA4B,EAAE;QACzD,MAAM,OAAO,GAAG,KAAK,CACnB,UAAU,EACV,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAC5H,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CACtC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC3C,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,KAAK,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnF,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBACrD,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB;gBAAE,GAAG,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC9C,CAAC,QAAQ,EAAE,EAAE;QACX,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,GAAG,QAAQ,CAAC;QAChB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACzB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAqB,EAAE,EAAE;YAC7C,IAAI,KAAK;gBAAE,OAAO;YAClB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,QAAQ;oBAAE,OAAO;gBAC5B,IAAI,CAAC,MAAM;oBAAE,OAAO,GAAG,EAAE,CAAC;gBAC1B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBACpB,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;gBAAE,OAAO,GAAG,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAM,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,EACD,GAAG,CACJ,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"live-preview.js","sourceRoot":"","sources":["../../src/media/live-preview.ts"],"names":[],"mappings":"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"}

package/dist/media/live-stream.js

@@ -1,9 +1,18 @@
 import { LiveStreamStartError, StationKeyUnavailableError, StationUnreachableError } from '@mega-yfue/eufy-sdk';
 import { createSocket } from 'node:dgram';
 import { execFile, spawn } from 'node:child_process';
+import { promisify } from 'node:util';
 import { setTimeout as delay } from 'node:timers/promises';
 /** How long a deliberately stopped adaptation process is given to exit before it is killed. */
-export const PROCESS_STOP_GRACE_MS = 2_000;
+const PROCESS_STOP_GRACE_MS = 2_000;
+/** Closes an adaptation process's input and terminates it, killing it if it has not exited within the grace. */
+export function stopProcess(process) {
+    process.stdin?.destroy();
+    process.kill('SIGTERM');
+    const killDeadline = setTimeout(() => process.kill('SIGKILL'), PROCESS_STOP_GRACE_MS);
+    killDeadline.unref?.();
+    process.on('exit', () => clearTimeout(killDeadline));
+}
 /**
  * Whether an adaptation opened for `running` can code what the source announced as `announced`.
  *
@@ -79,14 +88,20 @@ const SOURCE_ACQUISITION_TIMEOUT = Symbol('source-acquisition-timeout');
  * and reported `audio-only`. Every other stage is a source error, because nothing else distinguishes it
  * from a transport that failed.
  */
-function sourceFailure(error) {
+function liveSourceFailure(error) {
+    return error instanceof LiveStreamStartError && error.stage === 'audio-only' ? 'source-audio-only' : sourceFailure(error);
+}
+/**
+ * Why a source stopped producing, as this domain's bounded vocabulary.
+ *
+ * A station names its own failures apart from the camera's: every camera behind a base that did not connect
+ * fails together, and a sealed start the station gave no key for does not resolve by retrying.
+ */
+export function sourceFailure(error) {
     if (error instanceof StationUnreachableError) {
         return 'station-unreachable';
     }
-    if (error instanceof StationKeyUnavailableError) {
-        return 'station-key-unavailable';
-    }
-    return error instanceof LiveStreamStartError && error.stage === 'audio-only' ? 'source-audio-only' : 'source-error';
+    return error instanceof StationKeyUnavailableError ? 'station-key-unavailable' : 'source-error';
 }
 /** How many diagnostic lines one adaptation retains, which is what a failure is attributed from. */
 const ADAPTATION_STDERR_TAIL_LINES = 8;
@@ -164,12 +179,14 @@ const FFMPEG_VERSION_BANNER_LENGTH = 120;
  * to know whether this binary can be asked to encode: a missing file, a file that is not executable, one
  * that is not FFmpeg, and one that hangs all mean the same thing to the media that would have used it.
  */
-const probeFfmpegVersion = (path) => new Promise((resolve) => {
-    execFile(path, ['-hide_banner', '-version'], { timeout: FFMPEG_VERSION_PROBE_TIMEOUT_MS, maxBuffer: 64 * 1024, windowsHide: true }, (error, stdout) => {
-        const banner = error ? undefined : stdout.split(/\r?\n/, 1)[0]?.trim().slice(0, FFMPEG_VERSION_BANNER_LENGTH);
-        resolve(banner === undefined || banner === '' ? undefined : banner);
-    });
-});
+const probeFfmpegVersion = async (path) => {
+    const { stdout } = await promisify(execFile)(path, ['-hide_banner', '-version'], {
+        timeout: FFMPEG_VERSION_PROBE_TIMEOUT_MS,
+        maxBuffer: 64 * 1024,
+        windowsHide: true,
+    }).catch(() => ({ stdout: '' }));
+    return stdout.split(/\r?\n/, 1)[0]?.trim().slice(0, FFMPEG_VERSION_BANNER_LENGTH) || undefined;
+};
 /**
  * Resolves the complete identity of one adaptation binary, without opening any media.
  *
@@ -180,6 +197,30 @@ export async function resolveFfmpegIdentity(path, source, probe = probeFfmpegVer
     const version = await probe(path).catch(() => undefined);
     return { path, source, ...(version === undefined ? {} : { version }) };
 }
+/**
+ * Reports what one adaptation process did to `diagnostics`, whether or not the session it belonged to fails for it.
+ *
+ * An audio adaptation is restarted rather than failed and a return-audio one fails only talkback, so without a
+ * report of their own those two exit with no account anywhere of why they stopped. An `output` report carries
+ * nothing but the tail, so it is made only when the process actually wrote something: a silent process that
+ * ended as intended has nothing to attribute.
+ */
+export function adaptationReporter(diagnostics) {
+    return (role, event, stderr, code, signal, extras) => {
+        const tail = stderr.tail();
+        if (event === 'output' && tail.length === 0) {
+            return;
+        }
+        diagnostics?.report({
+            role,
+            event,
+            ...(typeof code === 'number' ? { code } : {}),
+            ...(typeof signal === 'string' ? { signal } : {}),
+            ...extras,
+            ...(tail.length ? { stderr: tail } : {}),
+        });
+    };
+}
 /** The `libx264` constant rate factor a live adaptation codes at when the negotiated bit rate is ignored. */
 const CONSTANT_QUALITY_CRF = 23;
 /** `libx264`'s profile, level, speed and pixel format, shared by its rate-capped and constant-quality forms. */
@@ -424,9 +465,10 @@ async function qualification(executable, encoder, selection, run, deadline) {
                 field('pic_height_in_map_units_minus1') + 1 === Math.ceil(selection.height / 16),
         ],
         ['frames', (traced.stderr.match(/\bPacket: /g)?.length ?? 0) === selection.fps * QUALIFICATION_SECONDS],
-        ['bytes', coded.stdout.length * 8 <= videoBudgetInsideCeiling(selection) * 1_000 * (QUALIFICATION_SECONDS + 1)],
     ];
-    return checks.find(([, passed]) => !passed)?.[0] ?? 'qualified';
+    const bound = videoBudgetInsideCeiling(selection) * 125 * (QUALIFICATION_SECONDS + 1);
+    return (checks.find(([, passed]) => !passed)?.[0] ??
+        (coded.stdout.length <= bound ? 'qualified' : ['bytes', coded.stdout.length, bound]));
 }
 /** The live video packet size an administrator can choose for networks that drop the negotiated one. */
 export const SMALL_VIDEO_PACKET_SIZE = 1128;
@@ -479,11 +521,38 @@ export class FfmpegLiveMedia {
         }
         return outcomes;
     }
-    /** The first hardware encoder qualified for `selection`, or `libx264` where none is. */
-    encoderFor(selection) {
+    /**
+     * What a session codes `selection` from a `codec` source with: `copy` for a passed-through H.264 source,
+     * {@link CONSTANT_QUALITY} where the negotiated bit rate is ignored, else the first hardware encoder qualified
+     * for `selection`, or `libx264` where none is or `settings` turn hardware off. Without `settings`, this
+     * adapter's own.
+     */
+    encoderFor(codec, selection, settings) {
+        if ((settings?.liveVideoPassthrough ?? this.copyVideo) && codec === 'h264')
+            return 'copy';
+        if (settings?.ignoreHomeBitRate ?? this.constantQuality)
+            return CONSTANT_QUALITY;
+        if (settings?.hardwareVideoEncoder === false)
+            return LIBX264;
         const key = `${selection.profile}@${selection.level}`;
         return HARDWARE_ENCODERS.find((encoder) => this.qualified.get(encoder.name)?.has(key)) ?? LIBX264;
     }
+    /** The largest video packet a session sends under `settings`, or under this adapter's own without them. */
+    packetSize(settings) {
+        if (!settings)
+            return this.maxVideoPacketSize;
+        return settings.smallVideoPackets ? SMALL_VIDEO_PACKET_SIZE : Number.POSITIVE_INFINITY;
+    }
+    /**
+     * The encoder and the argument list a session would code `selection` from a `codec` source with, its video
+     * written to `output` instead of RTP: every argument before `output` is the session's own, or that of a session
+     * of an adapter configured with `settings`.
+     */
+    videoAdaptation(codec, selection, output, settings) {
+        const video = { ...selection, mtu: Math.min(selection.mtu, this.packetSize(settings)) };
+        const encoder = this.encoderFor(codec, video, settings);
+        return { encoder: encoder === 'copy' ? encoder : encoder.name, args: videoArguments(codec, video, encoder, output) };
+    }
     /**
      * Reserves the negotiated output ports so `SetupEndpoints` can be answered with them, and returns a
      * session that holds nothing else: no SDK handle, adaptation process, or device session exists until
@@ -493,9 +562,7 @@ export class FfmpegLiveMedia {
     async prepare(transport) {
         const videoPort = await this.reservePort(transport.addressVersion);
         const targetAddress = transport.addressVersion === 'ipv6' ? `[${transport.targetAddress}]` : transport.targetAddress;
-        const maxVideoPacketSize = this.maxVideoPacketSize;
-        const copyVideo = this.copyVideo;
-        const constantQuality = this.constantQuality;
+        const maxVideoPacketSize = this.packetSize(transport.liveVideoSettings);
         let audioPort;
         try {
             audioPort = transport.audio ? await this.reservePort(transport.addressVersion) : undefined;
@@ -587,38 +654,14 @@ export class FfmpegLiveMedia {
             }
             sink.once('drain', () => releaseAdaptation(sink));
         };
-        /**
-         * Reports what one adaptation process did, whether or not the session it belonged to fails for it.
-         *
-         * An audio adaptation is restarted rather than failed and a return-audio one fails only talkback, so
-         * without a report of their own those two exit with no account anywhere of why they stopped. An `output`
-         * report carries nothing but the tail, so it is made only when the process actually wrote something:
-         * a silent process that ended as intended has nothing to attribute.
-         */
-        const reportAdaptation = (role, event, stderr, code, signal) => {
-            const tail = stderr.tail();
-            if (event === 'output' && tail.length === 0) {
-                return;
-            }
-            adaptationDiagnostics?.report({
-                role,
-                event,
-                ...(typeof code === 'number' ? { code } : {}),
-                ...(typeof signal === 'string' ? { signal } : {}),
-                ...(tail.length ? { stderr: tail } : {}),
-            });
-        };
-        const stopProcess = (process) => {
+        const reportAdaptation = adaptationReporter(adaptationDiagnostics);
+        const stopAdaptation = (process) => {
             if (!process) {
                 return;
             }
             stoppingProcesses.add(process);
-            process.stdin.destroy();
+            stopProcess(process);
             releaseAdaptation(process.stdin);
-            process.kill('SIGTERM');
-            const killDeadline = setTimeout(() => process.kill('SIGKILL'), PROCESS_STOP_GRACE_MS);
-            killDeadline.unref?.();
-            process.on('exit', () => clearTimeout(killDeadline));
         };
         /** Stop a caller-owned SDK handle without allowing synchronous or asynchronous faults to abort cleanup. */
         const stopTalkbackHandle = (handle) => {
@@ -632,7 +675,7 @@ export class FfmpegLiveMedia {
                 return;
             }
             talkbackEnded = true;
-            stopProcess(returnAudioProcess);
+            stopAdaptation(returnAudioProcess);
             returnAudioProcess?.stdout.destroy();
             returnAudioProcess?.eld.destroy();
             returnAudioProcess = undefined;
@@ -661,8 +704,8 @@ export class FfmpegLiveMedia {
             clearTimeout(initialRtcpGrace);
             clearTimeout(videoStartBackstop);
             stopTalkback();
-            stopProcess(videoProcess);
-            stopProcess(audioProcess);
+            stopAdaptation(videoProcess);
+            stopAdaptation(audioProcess);
             source?.stop();
             if (negotiated) {
                 transport.onSessionReleased?.(videoFailed ? 'failed' : 'requested', {
@@ -778,18 +821,15 @@ export class FfmpegLiveMedia {
                     return;
                 }
                 videoCause = 'source-configuration';
-                stopProcess(videoProcess);
+                stopAdaptation(videoProcess);
                 videoProcess = undefined;
             }
             if (!videoProcess) {
                 adaptationConfig = videoConfig;
                 videoSequence = (videoSequence + OUTPUT_SEQUENCE_STEP) & 0xffff;
-                const encoder = copyVideo && videoConfig.codec === 'h264'
-                    ? 'copy'
-                    : constantQuality
-                        ? CONSTANT_QUALITY
-                        : this.encoderFor(negotiated.video);
-                const child = this.createProcess(this.executable, videoArguments(videoConfig, negotiated.video, targetAddress, transport.video, videoSequence, encoder));
+                const { video } = negotiated;
+                const encoder = this.encoderFor(videoConfig.codec, video, transport.liveVideoSettings);
+                const child = this.createProcess(this.executable, videoArguments(videoConfig.codec, video, encoder, outputArguments(targetAddress, transport.video, video.payloadType, video.ssrc, video.mtu, videoSequence)));
                 videoProcess = child;
                 const encoderName = encoder === 'copy' ? encoder : encoder.name;
                 adaptationDiagnostics?.report({
@@ -869,14 +909,14 @@ export class FfmpegLiveMedia {
                     if (!stoppingProcesses.has(child) && audioProcess === child) {
                         reportAdaptation('live-audio', 'input-failed', stderr);
                     }
-                    stopProcess(child);
+                    stopAdaptation(child);
                     clearChild();
                 });
                 child.on('error', () => {
                     if (!stoppingProcesses.has(child)) {
                         reportAdaptation('live-audio', producedOutput ? 'exited-while-streaming' : 'spawn-failed', stderr);
                     }
-                    stopProcess(child);
+                    stopAdaptation(child);
                     clearChild();
                 });
                 child.on('exit', (code, signal) => {
@@ -889,7 +929,7 @@ export class FfmpegLiveMedia {
                 });
             }
             if (audioInputCodec !== frame.codec) {
-                stopProcess(audioProcess);
+                stopAdaptation(audioProcess);
                 audioProcess = undefined;
                 audioInputCodec = undefined;
                 writeAudio(frame);
@@ -1060,9 +1100,11 @@ export class FfmpegLiveMedia {
                         return;
                     }
                     reportAdaptation('return-audio', producedOutput ? 'exited-while-streaming' : 'exited-before-output', stderr, code, signal);
-                    failTalkback(stderr.tail().some((line) => line.includes('Error during demuxing: Operation timed out'))
-                        ? 'no-controller-audio'
-                        : 'adaptation-failed');
+                    failTalkback(!stderr.tail().some((line) => line.includes('Error during demuxing: Operation timed out'))
+                        ? 'adaptation-failed'
+                        : receivedVideoKeyframe
+                            ? 'no-controller-audio'
+                            : 'source-unavailable');
                 });
                 child.stdin.end(returnAudioSdp(audioPort.port, selection, transport.audio, transport.addressVersion));
                 await delay(RETURN_AUDIO_BIND_GRACE_MS);
@@ -1101,7 +1143,7 @@ export class FfmpegLiveMedia {
                 }
                 catch (error) {
                     acquisition.abort(new Error('live media source acquisition was cancelled'));
-                    failVideo(error === SOURCE_ACQUISITION_TIMEOUT ? 'source-acquisition-timeout' : sourceFailure(error), error);
+                    failVideo(error === SOURCE_ACQUISITION_TIMEOUT ? 'source-acquisition-timeout' : liveSourceFailure(error), error);
                     throw error === SOURCE_ACQUISITION_TIMEOUT ? new Error('live media source acquisition timed out') : error;
                 }
                 finally {
@@ -1122,7 +1164,7 @@ export class FfmpegLiveMedia {
                         notice.extend();
                     }
                 });
-                source.on('error', (error) => failVideo(sourceFailure(error), error));
+                source.on('error', (error) => failVideo(liveSourceFailure(error), error));
                 source.on('stop', () => failVideo('source-stopped'));
                 await returnAudioReady;
             },
@@ -1240,12 +1282,11 @@ function outputArguments(targetAddress, target, payloadType, ssrc, packetSize, s
  * honoured: the output spends what the picture needs. A controller asks 299 kbps for 720p and does not raise it
  * during a session, which the ceiling above codes as a blurred, then blocky, picture.
  */
-function videoArguments(input, selection, targetAddress, target, sequence, encoder) {
-    const output = outputArguments(targetAddress, target, selection.payloadType, selection.ssrc, selection.mtu, sequence);
+function videoArguments(codec, selection, encoder, output) {
     if (encoder === 'copy') {
         return [...commonArguments('h264'), '-an', '-c:v', 'copy', ...output];
     }
-    return [...commonArguments(input.codec === 'h265' ? 'hevc' : input.codec), ...encodeArguments(encoder, selection), ...output];
+    return [...commonArguments(codec === 'h265' ? 'hevc' : codec), ...encodeArguments(encoder, selection), ...output];
 }
 /** What one encoder is given to code `selection`, between its input and its output, in a session and in qualification alike. */
 function encodeArguments(encoder, selection) {