@homebridge-plugins/homebridge-eufy-security 5.0.0-beta.32 → 5.0.0-beta.34

package/dist/media/live-preview.js

@@ -0,0 +1,96 @@
+import { spawn } from 'node:child_process';
+import { commonArguments, PROCESS_STOP_GRACE_MS } 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;
+/** 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' };
+/**
+ * A camera's live video as JPEG pictures, five a second and 640 pixels wide, for the settings page.
+ *
+ * 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.
+ */
+export function startLivePreview(executable, source, onPicture, onEnd) {
+    const abandonment = new AbortController();
+    let live;
+    let ffmpeg;
+    let codec;
+    let ended = false;
+    const end = () => {
+        if (ended)
+            return;
+        ended = true;
+        clearTimeout(deadline);
+        abandonment.abort();
+        try {
+            live?.stop();
+        }
+        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();
+    };
+    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);
+        let pending = Buffer.alloc(0);
+        process.stdout.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));
+                pending = pending.subarray(at + JPEG_END.length);
+            }
+            if (pending.length > MAX_PICTURE_BYTES)
+                end();
+        });
+        return process;
+    };
+    source.live({ signal: abandonment.signal }).then((consumer) => {
+        if (ended) {
+            consumer.stop();
+            return;
+        }
+        live = consumer;
+        consumer.on('error', end);
+        consumer.on('stop', end);
+        consumer.on('budget', (notice) => notice.extend());
+        consumer.on('video', (frame) => {
+            if (ended)
+                return;
+            if (!ffmpeg) {
+                const format = INPUT_FORMATS[frame.codec];
+                if (!frame.keyframe)
+                    return;
+                if (!format)
+                    return end();
+                codec = frame.codec;
+                ffmpeg = adapt(format);
+            }
+            if (frame.codec !== codec)
+                return end();
+            const stdin = ffmpeg.stdin;
+            if (!stdin.write(frame.data)) {
+                consumer.pause();
+                stdin.once('drain', () => consumer.resume());
+            }
+        });
+    }, end);
+    return end;
+}
+//# sourceMappingURL=live-preview.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -182,6 +182,252 @@ export async function resolveFfmpegIdentity(path, source, probe = probeFfmpegVer
 }
 /** 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. */
+function libx264Arguments(selection) {
+    return [
+        '-preset',
+        'superfast',
+        '-tune',
+        'zerolatency',
+        '-profile:v',
+        selection.profile,
+        '-level:v',
+        selection.level,
+        '-pix_fmt',
+        'yuv420p',
+    ];
+}
+/** The software encoder every selection no qualified hardware encoder serves is coded by. */
+const LIBX264 = {
+    name: 'libx264',
+    args: (selection, kbps) => [...libx264Arguments(selection), '-b:v', kbps, '-maxrate', kbps, '-bufsize', kbps],
+};
+/** `libx264` at {@link CONSTANT_QUALITY_CRF} with no rate control, which no hardware encoder replaces. */
+const CONSTANT_QUALITY = {
+    name: 'libx264',
+    args: (selection) => [...libx264Arguments(selection), '-crf', String(CONSTANT_QUALITY_CRF)],
+};
+/** The H.264 `profile_idc` of each negotiable profile. */
+const PROFILE_IDC = { baseline: 66, main: 77, high: 100 };
+/**
+ * The hardware encoders a selection may be served by, in order of preference, each with the hosts whose
+ * binary may carry it.
+ *
+ * Each states profile, level and rate control in its own encoder's spelling, with B-frames off and its
+ * lowest-latency mode, as docs/reference/hardware-encoder-viability.md records them. None is used for a
+ * selection until {@link FfmpegLiveMedia.qualify} has proven it against that selection.
+ */
+const HARDWARE_ENCODERS = [
+    {
+        name: 'h264_videotoolbox',
+        triedOn: (host) => host.platform === 'darwin',
+        args: (selection, kbps) => [
+            '-profile:v',
+            selection.profile,
+            '-level:v',
+            selection.level,
+            '-realtime',
+            '1',
+            '-prio_speed',
+            '1',
+            '-bf',
+            '0',
+            '-pix_fmt',
+            'yuv420p',
+            '-b:v',
+            kbps,
+            '-maxrate',
+            kbps,
+        ],
+    },
+    {
+        name: 'h264_qsv',
+        triedOn: (host) => host.platform === 'win32' || host.configured,
+        args: (selection, kbps) => [
+            '-profile:v',
+            selection.profile,
+            '-level:v',
+            selection.level.replace('.', ''),
+            '-pix_fmt',
+            'nv12',
+            '-bf',
+            '0',
+            '-look_ahead',
+            '0',
+            '-async_depth',
+            '1',
+            '-b:v',
+            kbps,
+            '-maxrate',
+            kbps,
+        ],
+    },
+    {
+        name: 'h264_nvenc',
+        triedOn: (host) => host.configured,
+        args: (selection, kbps) => [
+            '-profile:v',
+            selection.profile,
+            '-level:v',
+            selection.level,
+            '-preset',
+            'p1',
+            '-tune',
+            'ull',
+            '-zerolatency',
+            '1',
+            '-bf',
+            '0',
+            '-pix_fmt',
+            'yuv420p',
+            '-rc',
+            'cbr',
+            '-b:v',
+            kbps,
+            '-maxrate',
+            kbps,
+            '-bufsize',
+            kbps,
+        ],
+    },
+    {
+        name: 'h264_amf',
+        triedOn: (host) => host.platform === 'linux' && host.arch === 'x64',
+        args: (selection, kbps) => [
+            '-profile:v',
+            selection.profile === 'baseline' ? 'constrained_baseline' : selection.profile,
+            '-level:v',
+            selection.level,
+            '-usage',
+            'ultralowlatency',
+            '-bf',
+            '0',
+            '-pix_fmt',
+            'yuv420p',
+            '-b:v',
+            kbps,
+            '-maxrate',
+            kbps,
+            '-bufsize',
+            kbps,
+        ],
+    },
+    {
+        name: 'h264_vaapi',
+        triedOn: (host) => host.platform === 'linux' && host.configured,
+        upload: ',format=nv12,hwupload',
+        args: (selection, kbps) => [
+            '-vaapi_device',
+            '/dev/dri/renderD128',
+            '-profile:v',
+            selection.profile === 'baseline' ? 'constrained_baseline' : selection.profile,
+            '-level:v',
+            selection.level,
+            '-bf',
+            '0',
+            '-async_depth',
+            '1',
+            '-b:v',
+            kbps,
+            '-maxrate',
+            kbps,
+        ],
+    },
+    {
+        name: 'h264_v4l2m2m',
+        triedOn: (host) => host.platform === 'linux' && (host.arch === 'arm' || host.arch === 'arm64'),
+        args: (selection, kbps) => [
+            '-profile:v',
+            String(PROFILE_IDC[selection.profile]),
+            '-pix_fmt',
+            'yuv420p',
+            '-b:v',
+            kbps,
+        ],
+    },
+];
+/** How many seconds of synthetic picture one qualification run codes. */
+const QUALIFICATION_SECONDS = 2;
+/** The longest one qualification process may run before its selection counts as unqualified. */
+const QUALIFICATION_RUN_TIMEOUT_MS = 10_000;
+/** The longest qualification as a whole may take; a selection it has not finished by then stays unqualified. */
+const QUALIFICATION_BUDGET_MS = 60_000;
+/**
+ * The selections every hardware encoder is qualified against: each advertised profile and level, at the
+ * largest advertised geometry that level's frame-size limit admits, at the advertised frame-rate ceiling, and
+ * at 299 kbps, the lowest bit rate a controller has been measured selecting.
+ */
+const QUALIFICATION_SELECTIONS = ['baseline', 'main', 'high'].flatMap((profile) => [
+    ['3.1', 1280, 720],
+    ['3.2', 1280, 720],
+    ['4.0', 1920, 1080],
+].map(([level, width, height]) => ({
+    profile,
+    level,
+    width,
+    height,
+    fps: 30,
+    maxBitRate: 299,
+    mtu: 1378,
+    payloadType: 99,
+    ssrc: 1,
+    rtcpInterval: 0.5,
+})));
+const runQualification = (executable, args, input, timeoutMs) => new Promise((resolve) => {
+    const child = execFile(executable, args, { encoding: 'buffer', timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, windowsHide: true }, (error, stdout, stderr) => resolve(error ? undefined : { stdout, stderr: stderr.toString() }));
+    child.stdin?.on('error', () => undefined);
+    child.stdin?.end(input);
+});
+/**
+ * Qualifies `encoder` for `selection` before `deadline`.
+ *
+ * The encoder codes {@link QUALIFICATION_SECONDS} of moving synthetic picture through the session's own
+ * argument list, which proves it is named by the binary, accepts those arguments, and opens on this host's
+ * devices. A second FFmpeg then traces the coded parameter sets, which proves what was coded: a profile at or
+ * below the negotiated one, the negotiated level and macroblock geometry, every frame, and no more bytes than
+ * the encoder budget plus the one second of it the session's rate control may borrow.
+ */
+async function qualification(executable, encoder, selection, run, deadline) {
+    const within = (args, input) => {
+        const left = deadline - Date.now();
+        return left > 0 ? run(executable, args, input, Math.min(left, QUALIFICATION_RUN_TIMEOUT_MS)) : 'budget';
+    };
+    const coded = await within([
+        '-hide_banner',
+        '-loglevel',
+        'error',
+        '-f',
+        'lavfi',
+        '-i',
+        `testsrc2=size=${selection.width}x${selection.height}:rate=${selection.fps}:duration=${QUALIFICATION_SECONDS}`,
+        ...encodeArguments(encoder, selection),
+        '-f',
+        'h264',
+        'pipe:1',
+    ]);
+    if (!coded || coded === 'budget') {
+        return coded ?? 'encode';
+    }
+    const traced = await within(['-hide_banner', '-f', 'h264', '-i', 'pipe:0', '-c', 'copy', '-bsf:v', 'trace_headers', '-f', 'null', '-'], coded.stdout);
+    if (!traced || traced === 'budget') {
+        return traced ?? 'trace';
+    }
+    const field = (name) => Number(new RegExp(`\\b${name}\\s.*= (\\d+)$`, 'm').exec(traced.stderr)?.[1]);
+    const profile = field('profile_idc');
+    const wanted = PROFILE_IDC[selection.profile];
+    const checks = [
+        ['profile', profile === wanted || (profile === 66 && field('constraint_set1_flag') === 1) || (profile === 77 && wanted === 100)],
+        ['level', field('level_idc') === Number(selection.level.replace('.', ''))],
+        [
+            'geometry',
+            field('pic_width_in_mbs_minus1') + 1 === Math.ceil(selection.width / 16) &&
+                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';
+}
 /** The live video packet size an administrator can choose for networks that drop the negotiated one. */
 export const SMALL_VIDEO_PACKET_SIZE = 1128;
 /** Adapts separate SDK elementary streams into independently failing HomeKit SRTP outputs. */
@@ -204,6 +450,40 @@ export class FfmpegLiveMedia {
         this.copyVideo = copyVideo;
         this.constantQuality = constantQuality;
     }
+    /**
+     * Each hardware encoder's qualified selections, as `profile@level`, for the rest of this run.
+     *
+     * A spawn reads it, so a selection is served by hardware from the moment it qualifies, and an encoder that
+     * exits before output in a session is removed from it and serves nothing again.
+     */
+    qualified = new Map();
+    /**
+     * Qualifies every hardware encoder `host`'s binary may carry against every selection it is qualified for,
+     * one run after another and within {@link QUALIFICATION_BUDGET_MS}, and returns each tried encoder's
+     * outcome per `profile@level`.
+     *
+     * Until a selection qualifies it is coded by `libx264`, and a selection no encoder qualifies for stays there.
+     */
+    async qualify(host, run = runQualification) {
+        const deadline = Date.now() + QUALIFICATION_BUDGET_MS;
+        const outcomes = {};
+        for (const encoder of HARDWARE_ENCODERS.filter((candidate) => candidate.triedOn(host))) {
+            const tried = (outcomes[encoder.name] = {});
+            for (const selection of QUALIFICATION_SELECTIONS) {
+                const key = `${selection.profile}@${selection.level}`;
+                tried[key] = await qualification(this.executable, encoder, selection, run, deadline);
+                if (tried[key] === 'qualified') {
+                    this.qualified.set(encoder.name, (this.qualified.get(encoder.name) ?? new Set()).add(key));
+                }
+            }
+        }
+        return outcomes;
+    }
+    /** The first hardware encoder qualified for `selection`, or `libx264` where none is. */
+    encoderFor(selection) {
+        const key = `${selection.profile}@${selection.level}`;
+        return HARDWARE_ENCODERS.find((encoder) => this.qualified.get(encoder.name)?.has(key)) ?? LIBX264;
+    }
     /**
      * 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
@@ -504,9 +784,21 @@ export class FfmpegLiveMedia {
             if (!videoProcess) {
                 adaptationConfig = videoConfig;
                 videoSequence = (videoSequence + OUTPUT_SEQUENCE_STEP) & 0xffff;
-                const child = this.createProcess(this.executable, videoArguments(videoConfig, negotiated.video, targetAddress, transport.video, videoSequence, copyVideo, constantQuality));
+                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));
                 videoProcess = child;
-                adaptationDiagnostics?.report({ role: 'live-video', event: 'started', cause: videoCause });
+                const encoderName = encoder === 'copy' ? encoder : encoder.name;
+                adaptationDiagnostics?.report({
+                    role: 'live-video',
+                    event: 'started',
+                    cause: videoCause,
+                    encoder: encoderName,
+                    source: videoConfig.codec,
+                });
                 const stderr = new AdaptationStderr();
                 let producedOutput = false;
                 child.stderr.on('data', (chunk) => {
@@ -534,6 +826,9 @@ export class FfmpegLiveMedia {
                         return;
                     }
                     reportAdaptation('live-video', producedOutput ? 'exited-while-streaming' : 'exited-before-output', stderr, code, signal);
+                    if (!producedOutput && this.qualified.delete(encoderName)) {
+                        adaptationDiagnostics?.report({ role: 'live-video', event: 'encoder-disqualified', encoder: encoderName });
+                    }
                     failVideo(producedOutput ? 'adaptation-exited-while-streaming' : 'adaptation-exited-before-output');
                 });
             }
@@ -851,7 +1146,7 @@ export class FfmpegLiveMedia {
  * leading keyframe the caller waited for, and a raw A-law demuxer stops emitting timestamps entirely, so both
  * cost media that was already in hand.
  */
-function commonArguments(inputFormat, inputOptions = []) {
+export function commonArguments(inputFormat, inputOptions = []) {
     return [
         '-hide_banner',
         '-loglevel',
@@ -941,41 +1236,26 @@ function outputArguments(targetAddress, target, payloadType, ssrc, packetSize, s
  * the geometry, frame rate, bit rate, profile and keyframe interval are the camera's own, not the negotiated
  * selection. Only the RTP output is the negotiated one. An H.265 source is transcoded either way.
  *
- * `constantQuality` codes at {@link CONSTANT_QUALITY_CRF} with no rate control, so the negotiated bit rate is not
+ * {@link CONSTANT_QUALITY} codes at {@link CONSTANT_QUALITY_CRF} with no rate control, so the negotiated bit rate is not
  * 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, copy = false, constantQuality = false) {
-    if (copy && input.codec === 'h264') {
-        return [
-            ...commonArguments('h264'),
-            '-an',
-            '-c:v',
-            'copy',
-            ...outputArguments(targetAddress, target, selection.payloadType, selection.ssrc, selection.mtu, sequence),
-        ];
+function videoArguments(input, selection, targetAddress, target, sequence, encoder) {
+    const output = outputArguments(targetAddress, target, selection.payloadType, selection.ssrc, selection.mtu, sequence);
+    if (encoder === 'copy') {
+        return [...commonArguments('h264'), '-an', '-c:v', 'copy', ...output];
     }
-    const budget = videoBudgetInsideCeiling(selection);
-    const rate = constantQuality
-        ? ['-crf', String(CONSTANT_QUALITY_CRF)]
-        : ['-b:v', `${budget}k`, '-maxrate', `${budget}k`, '-bufsize', `${budget}k`];
+    return [...commonArguments(input.codec === 'h265' ? 'hevc' : input.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) {
     return [
-        ...commonArguments(input.codec === 'h265' ? 'hevc' : input.codec),
         '-an',
         '-c:v',
-        'libx264',
-        '-preset',
-        'superfast',
-        '-tune',
-        'zerolatency',
-        '-profile:v',
-        selection.profile,
-        '-level:v',
-        selection.level,
-        '-pix_fmt',
-        'yuv420p',
+        encoder.name,
+        ...encoder.args(selection, `${videoBudgetInsideCeiling(selection)}k`),
         '-vf',
-        `scale=${selection.width}:${selection.height}:force_original_aspect_ratio=decrease,pad=${selection.width}:${selection.height}:(ow-iw)/2:(oh-ih)/2`,
+        `scale=${selection.width}:${selection.height}:force_original_aspect_ratio=decrease,pad=${selection.width}:${selection.height}:(ow-iw)/2:(oh-ih)/2${encoder.upload ?? ''}`,
         '-fpsmax',
         String(selection.fps),
         '-g',
@@ -984,8 +1264,6 @@ function videoArguments(input, selection, targetAddress, target, sequence, copy
         String(selection.fps * 2),
         '-sc_threshold',
         '0',
-        ...rate,
-        ...outputArguments(targetAddress, target, selection.payloadType, selection.ssrc, selection.mtu, sequence),
     ];
 }
 /** FLV signature, version 1, the audio-only flag, header size 9, and the zero size of the tag before the first. */