@yume-chan/scrcpy 0.0.19 → 0.0.21

package/esm/options/types.d.ts

@@ -1,47 +1,88 @@
-import type { TransformStream } from "@yume-chan/stream-extra";
-import type { ScrcpyBackOrScreenOnControlMessage, ScrcpyControlMessageType, ScrcpySetClipboardControlMessage } from "../control/index.js";
+import type { ReadableStream, TransformStream } from "@yume-chan/stream-extra";
+import type { ValueOrPromise } from "@yume-chan/struct";
+import type { ScrcpyBackOrScreenOnControlMessage, ScrcpyControlMessageType, ScrcpyInjectTouchControlMessage, ScrcpySetClipboardControlMessage } from "../control/index.js";
 import type { ScrcpyScrollController } from "./1_16/scroll.js";
+import type { ScrcpyAudioStreamMetadata, ScrcpyMediaStreamPacket, ScrcpyVideoStream } from "./codec.js";
 export declare const DEFAULT_SERVER_PATH = "/data/local/tmp/scrcpy-server.jar";
 export interface ScrcpyOptionValue {
     toOptionValue(): string | undefined;
 }
 export declare function isScrcpyOptionValue(value: unknown): value is ScrcpyOptionValue;
 export declare function toScrcpyOptionValue<T>(value: unknown, empty: T): string | T;
-export interface H264Configuration {
-    profileIndex: number;
-    constraintSet: number;
-    levelIndex: number;
-    encodedWidth: number;
-    encodedHeight: number;
-    cropLeft: number;
-    cropRight: number;
-    cropTop: number;
-    cropBottom: number;
-    croppedWidth: number;
-    croppedHeight: number;
+export interface ScrcpyEncoder {
+    type: "video" | "audio";
+    codec?: string;
+    name: string;
 }
-export interface ScrcpyVideoStreamConfigurationPacket {
-    type: "configuration";
-    sequenceParameterSet: Uint8Array;
-    pictureParameterSet: Uint8Array;
-    data: H264Configuration;
+export interface ScrcpyDisplay {
+    id: number;
+    resolution?: string;
 }
-export interface ScrcpyVideoStreamFramePacket {
-    type: "frame";
-    keyframe?: boolean;
-    pts?: bigint;
-    data: Uint8Array;
-}
-export type ScrcpyVideoStreamPacket = ScrcpyVideoStreamConfigurationPacket | ScrcpyVideoStreamFramePacket;
 export interface ScrcpyOptions<T extends object> {
-    value: Partial<T>;
-    getDefaultValue(): T;
-    formatServerArguments(): string[];
-    getOutputEncoderNameRegex(): RegExp;
-    createVideoStreamTransformer(): TransformStream<Uint8Array, ScrcpyVideoStreamPacket>;
-    getControlMessageTypes(): ScrcpyControlMessageType[];
+    readonly defaults: Required<T>;
+    readonly controlMessageTypes: readonly ScrcpyControlMessageType[];
+    readonly value: Required<T>;
+    serialize(): string[];
+    /**
+     * Set the essential options to let Scrcpy server print out available encoders.
+     */
+    setListEncoders(): void;
+    /**
+     * Set the essential options to let Scrcpy server print out available displays.
+     */
+    setListDisplays(): void;
+    /**
+     * Parse encoder information from Scrcpy server output
+     * @param line One line of Scrcpy server output
+     */
+    parseEncoder(line: string): ScrcpyEncoder | undefined;
+    /**
+     * Parse display information from Scrcpy server output
+     * @param line One line of Scrcpy server output
+     */
+    parseDisplay(line: string): ScrcpyDisplay | undefined;
+    /**
+     * Parse the device metadata from video stream according to the current version and options.
+     * @param stream The video stream.
+     * @returns
+     * A tuple of the video stream and the metadata.
+     *
+     * The returned video stream may be different from the input stream, and should be used for further processing.
+     */
+    parseVideoStreamMetadata(stream: ReadableStream<Uint8Array>): ValueOrPromise<ScrcpyVideoStream>;
+    parseAudioStreamMetadata(stream: ReadableStream<Uint8Array>): ValueOrPromise<ScrcpyAudioStreamMetadata>;
+    createMediaStreamTransformer(): TransformStream<Uint8Array, ScrcpyMediaStreamPacket>;
+    serializeInjectTouchControlMessage(message: ScrcpyInjectTouchControlMessage): Uint8Array;
+    serializeBackOrScreenOnControlMessage(message: ScrcpyBackOrScreenOnControlMessage): Uint8Array | undefined;
+    serializeSetClipboardControlMessage(message: ScrcpySetClipboardControlMessage): Uint8Array;
+    createScrollController(): ScrcpyScrollController;
+}
+export declare abstract class ScrcpyOptionsBase<T extends object, B extends ScrcpyOptions<object>> implements ScrcpyOptions<T> {
+    #private;
+    protected _base: B;
+    abstract get defaults(): Required<T>;
+    get controlMessageTypes(): readonly ScrcpyControlMessageType[];
+    readonly value: Required<T>;
+    constructor(base: B, value: Required<T>);
+    abstract serialize(): string[];
+    setListEncoders(): void;
+    setListDisplays(): void;
+    parseEncoder(line: string): ScrcpyEncoder | undefined;
+    parseDisplay(line: string): ScrcpyDisplay | undefined;
+    /**
+     * Parse the device metadata from video stream according to the current version and options.
+     * @param stream The video stream.
+     * @returns
+     * A tuple of the video stream and the metadata.
+     *
+     * The returned video stream may be different from the input stream, and should be used for further processing.
+     */
+    parseVideoStreamMetadata(stream: ReadableStream<Uint8Array>): ValueOrPromise<ScrcpyVideoStream>;
+    parseAudioStreamMetadata(stream: ReadableStream<Uint8Array>): ValueOrPromise<ScrcpyAudioStreamMetadata>;
+    createMediaStreamTransformer(): TransformStream<Uint8Array, ScrcpyMediaStreamPacket>;
+    serializeInjectTouchControlMessage(message: ScrcpyInjectTouchControlMessage): Uint8Array;
     serializeBackOrScreenOnControlMessage(message: ScrcpyBackOrScreenOnControlMessage): Uint8Array | undefined;
     serializeSetClipboardControlMessage(message: ScrcpySetClipboardControlMessage): Uint8Array;
-    getScrollController(): ScrcpyScrollController;
+    createScrollController(): ScrcpyScrollController;
 }
 //# sourceMappingURL=types.d.ts.map

package/esm/options/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/options/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EACR,kCAAkC,EAClC,wBAAwB,EACxB,gCAAgC,EACnC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,eAAO,MAAM,mBAAmB,sCAAsC,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAC9B,aAAa,IAAI,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,OAAO,GACf,KAAK,IAAI,iBAAiB,CAO5B;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAW3E;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oCAAoC;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB,oBAAoB,EAAE,UAAU,CAAC;IACjC,mBAAmB,EAAE,UAAU,CAAC;IAChC,IAAI,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAC7B,oCAAoC,GACpC,4BAA4B,CAAC;AAEnC,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM;IAC3C,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAElB,eAAe,IAAI,CAAC,CAAC;IAErB,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAElC,yBAAyB,IAAI,MAAM,CAAC;IAEpC,4BAA4B,IAAI,eAAe,CAC3C,UAAU,EACV,uBAAuB,CAC1B,CAAC;IAEF,sBAAsB,IAAI,wBAAwB,EAAE,CAAC;IAErD,qCAAqC,CACjC,OAAO,EAAE,kCAAkC,GAC5C,UAAU,GAAG,SAAS,CAAC;IAE1B,mCAAmC,CAC/B,OAAO,EAAE,gCAAgC,GAC1C,UAAU,CAAC;IAEd,mBAAmB,IAAI,sBAAsB,CAAC;CACjD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/options/types.ts"],"names":[],"mappings":"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"}

package/esm/options/types.js

@@ -15,4 +15,66 @@ export function toScrcpyOptionValue(value, empty) {
     }
     return String(value);
 }
+export class ScrcpyOptionsBase {
+    _base;
+    get controlMessageTypes() {
+        return this._base.controlMessageTypes;
+    }
+    value;
+    constructor(base, value) {
+        this._base = base;
+        this.value = value;
+        this.#setValue();
+    }
+    #setValue() {
+        // Share `value` with `_base` class,
+        // so updating `_base.value` in `_base.setListEncoders()`/
+        // `_base.setListDisplays()` will also update `this.value`.
+        Object.assign(this._base, { value: this.value });
+        if (this._base instanceof ScrcpyOptionsBase) {
+            this._base.#setValue();
+        }
+    }
+    setListEncoders() {
+        this._base.setListEncoders();
+    }
+    setListDisplays() {
+        this._base.setListDisplays();
+    }
+    parseEncoder(line) {
+        return this._base.parseEncoder(line);
+    }
+    parseDisplay(line) {
+        return this._base.parseDisplay(line);
+    }
+    /**
+     * Parse the device metadata from video stream according to the current version and options.
+     * @param stream The video stream.
+     * @returns
+     * A tuple of the video stream and the metadata.
+     *
+     * The returned video stream may be different from the input stream, and should be used for further processing.
+     */
+    parseVideoStreamMetadata(stream) {
+        return this._base.parseVideoStreamMetadata(stream);
+    }
+    parseAudioStreamMetadata(stream) {
+        return this._base.parseAudioStreamMetadata(stream);
+    }
+    createMediaStreamTransformer() {
+        return this._base.createMediaStreamTransformer();
+    }
+    serializeInjectTouchControlMessage(message) {
+        return this._base.serializeInjectTouchControlMessage(message);
+    }
+    serializeBackOrScreenOnControlMessage(message) {
+        return this._base.serializeBackOrScreenOnControlMessage(message);
+    }
+    serializeSetClipboardControlMessage(message) {
+        return this._base.serializeSetClipboardControlMessage(message);
+    }
+    createScrollController() {
+        return this._base.createScrollController();
+    }
+}
 //# sourceMappingURL=types.js.map

package/esm/options/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/options/types.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAMvE,MAAM,UAAU,mBAAmB,CAC/B,KAAc;IAEd,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,eAAe,IAAI,KAAK;QACxB,OAAO,KAAK,CAAC,aAAa,KAAK,UAAU,CAC5C,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAI,KAAc,EAAE,KAAQ;IAC3D,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE;QAC5B,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;KACjC;IAED,uDAAuD;IACvD,IAAI,KAAK,KAAK,SAAS,EAAE;QACrB,OAAO,KAAK,CAAC;KAChB;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/options/types.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAMvE,MAAM,UAAU,mBAAmB,CAC/B,KAAc;IAEd,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,eAAe,IAAI,KAAK;QACxB,OAAO,KAAK,CAAC,aAAa,KAAK,UAAU,CAC5C,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAI,KAAc,EAAE,KAAQ;IAC3D,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE;QAC5B,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;KACjC;IAED,uDAAuD;IACvD,IAAI,KAAK,KAAK,SAAS,EAAE;QACrB,OAAO,KAAK,CAAC;KAChB;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAgFD,MAAM,OAAgB,iBAAiB;IAKzB,KAAK,CAAI;IAInB,IAAI,mBAAmB;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAC1C,CAAC;IAEQ,KAAK,CAAc;IAE5B,YAAY,IAAO,EAAE,KAAkB;QACnC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,SAAS;QACL,oCAAoC;QACpC,0DAA0D;QAC1D,2DAA2D;QAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,KAAK,YAAY,iBAAiB,EAAE;YACzC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;SAC1B;IACL,CAAC;IAID,eAAe;QACX,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;IACjC,CAAC;IAED,eAAe;QACX,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;IACjC,CAAC;IAED,YAAY,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,YAAY,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,wBAAwB,CACpB,MAAkC;QAElC,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,wBAAwB,CACpB,MAAkC;QAElC,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,4BAA4B;QAIxB,OAAO,IAAI,CAAC,KAAK,CAAC,4BAA4B,EAAE,CAAC;IACrD,CAAC;IAED,kCAAkC,CAC9B,OAAwC;QAExC,OAAO,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,qCAAqC,CACjC,OAA2C;QAE3C,OAAO,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,mCAAmC,CAC/B,OAAyC;QAEzC,OAAO,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,sBAAsB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC;IAC/C,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yume-chan/scrcpy",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "TypeScript implementation of Scrcpy.",
   "keywords": [
     "adb",
@@ -22,40 +22,30 @@
   "bugs": {
     "url": "https://github.com/yume-chan/ya-webadb/issues"
   },
-  "bin": {
-    "fetch-scrcpy-server": "scripts/fetch-server.cjs"
-  },
   "type": "module",
   "main": "esm/index.js",
   "types": "esm/index.d.ts",
   "dependencies": {
-    "@yume-chan/async": "^2.2.0",
-    "@yume-chan/event": "^0.0.19",
-    "@yume-chan/stream-extra": "^0.0.19",
-    "@yume-chan/struct": "^0.0.19",
-    "tslib": "^2.4.1"
+    "@yume-chan/stream-extra": "^0.0.21",
+    "@yume-chan/struct": "^0.0.21",
+    "tslib": "^2.6.0"
   },
   "devDependencies": {
-    "@jest/globals": "^29.5.0",
-    "@yume-chan/adb": "^0.0.19",
+    "@jest/globals": "^29.6.1",
     "@yume-chan/eslint-config": "^1.0.0",
     "@yume-chan/tsconfig": "^1.0.0",
     "cross-env": "^7.0.3",
-    "eslint": "^8.36.0",
+    "eslint": "^8.44.0",
     "gh-release-fetch": "^3.0.2",
     "jest": "^29.5.0",
-    "prettier": "^2.8.4",
-    "ts-jest": "^29.0.4",
-    "typescript": "^4.9.4"
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.1.6"
   },
   "peerDependencies": {
-    "@yume-chan/adb": "^0.0.19",
     "gh-release-fetch": "^3.0.2"
   },
   "peerDependenciesMeta": {
-    "@yume-chan/adb": {
-      "optional": true
-    },
     "gh-release-fetch": {
       "optional": true
     }

package/src/codec/av1.ts

@@ -0,0 +1,33 @@
+export enum AndroidAv1Profile {
+    Main8 = 1 << 0,
+    Main10 = 1 << 1,
+    Main10Hdr10 = 1 << 12,
+    Main10Hdr10Plus = 1 << 13,
+}
+
+export enum AndroidAv1Level {
+    Level2 = 1 << 0,
+    Level21 = 1 << 1,
+    Level22 = 1 << 2,
+    Level23 = 1 << 3,
+    Level3 = 1 << 4,
+    Level31 = 1 << 5,
+    Level32 = 1 << 6,
+    Level33 = 1 << 7,
+    Level4 = 1 << 8,
+    Level41 = 1 << 9,
+    Level42 = 1 << 10,
+    Level43 = 1 << 11,
+    Level5 = 1 << 12,
+    Level51 = 1 << 13,
+    Level52 = 1 << 14,
+    Level53 = 1 << 15,
+    Level6 = 1 << 16,
+    Level61 = 1 << 17,
+    Level62 = 1 << 18,
+    Level63 = 1 << 19,
+    Level7 = 1 << 20,
+    Level71 = 1 << 21,
+    Level72 = 1 << 22,
+    Level73 = 1 << 23,
+}

package/src/codec/h264.ts

@@ -0,0 +1,317 @@
+// cspell: ignore golomb
+// cspell: ignore qpprime
+// cspell: ignore colour
+
+import { NaluSodbBitReader, annexBSplitNalu } from "./nalu.js";
+
+// From https://developer.android.com/reference/android/media/MediaCodecInfo.CodecProfileLevel
+export enum AndroidAvcProfile {
+    Baseline = 1 << 0,
+    Main = 1 << 1,
+    Extended = 1 << 2,
+    High = 1 << 3,
+    High10 = 1 << 4,
+    High422 = 1 << 5,
+    High444 = 1 << 6,
+    ConstrainedBaseline = 1 << 16,
+    ConstrainedHigh = 1 << 19,
+}
+
+export enum AndroidAvcLevel {
+    Level1 = 1 << 0,
+    Level1b = 1 << 1,
+    Level11 = 1 << 2,
+    Level12 = 1 << 3,
+    Level13 = 1 << 4,
+    Level2 = 1 << 5,
+    Level21 = 1 << 6,
+    Level22 = 1 << 7,
+    Level3 = 1 << 8,
+    Level31 = 1 << 9,
+    Level32 = 1 << 10,
+    Level4 = 1 << 11,
+    Level41 = 1 << 12,
+    Level42 = 1 << 13,
+    Level5 = 1 << 14,
+    Level51 = 1 << 15,
+    Level52 = 1 << 16,
+    Level6 = 1 << 17,
+    Level61 = 1 << 18,
+    Level62 = 1 << 19,
+}
+
+// H.264 has two standards: ITU-T H.264 and ISO/IEC 14496-10
+// they have the same content, and refer themselves as "H.264".
+// The name "AVC" (Advanced Video Coding) is only used in ISO spec name,
+// and other ISO specs referring to H.264.
+// Because this module parses H.264 Annex B format,
+// it's named "h264" instead of "avc".
+
+// 7.3.2.1.1 Sequence parameter set data syntax
+// Variable names in this method uses the snake_case convention as in the spec for easier referencing.
+export function h264ParseSequenceParameterSet(nalu: Uint8Array) {
+    const reader = new NaluSodbBitReader(nalu);
+    if (reader.next() !== 0) {
+        throw new Error("Invalid data");
+    }
+
+    const nal_ref_idc = reader.read(2);
+    const nal_unit_type = reader.read(5);
+
+    if (nal_unit_type !== 7) {
+        throw new Error("Invalid data");
+    }
+
+    if (nal_ref_idc === 0) {
+        throw new Error("Invalid data");
+    }
+
+    const profile_idc = reader.read(8);
+    const constraint_set = reader.peek(8);
+
+    const constraint_set0_flag = !!reader.next();
+    const constraint_set1_flag = !!reader.next();
+    const constraint_set2_flag = !!reader.next();
+    const constraint_set3_flag = !!reader.next();
+    const constraint_set4_flag = !!reader.next();
+    const constraint_set5_flag = !!reader.next();
+
+    // reserved_zero_2bits
+    if (reader.read(2) !== 0) {
+        throw new Error("Invalid data");
+    }
+
+    const level_idc = reader.read(8);
+    const seq_parameter_set_id = reader.decodeExponentialGolombNumber();
+
+    if (
+        profile_idc === 100 ||
+        profile_idc === 110 ||
+        profile_idc === 122 ||
+        profile_idc === 244 ||
+        profile_idc === 44 ||
+        profile_idc === 83 ||
+        profile_idc === 86 ||
+        profile_idc === 118 ||
+        profile_idc === 128 ||
+        profile_idc === 138 ||
+        profile_idc === 139 ||
+        profile_idc === 134
+    ) {
+        const chroma_format_idc = reader.decodeExponentialGolombNumber();
+        if (chroma_format_idc === 3) {
+            // separate_colour_plane_flag
+            reader.next();
+        }
+
+        // bit_depth_luma_minus8
+        reader.decodeExponentialGolombNumber();
+        // bit_depth_chroma_minus8
+        reader.decodeExponentialGolombNumber();
+
+        // qpprime_y_zero_transform_bypass_flag
+        reader.next();
+
+        const seq_scaling_matrix_present_flag = !!reader.next();
+        if (seq_scaling_matrix_present_flag) {
+            const seq_scaling_list_present_flag: boolean[] = [];
+            for (let i = 0; i < (chroma_format_idc !== 3 ? 8 : 12); i += 1) {
+                seq_scaling_list_present_flag[i] = !!reader.next();
+                if (seq_scaling_list_present_flag[i])
+                    if (i < 6) {
+                        // TODO
+                        // scaling_list( ScalingList4x4[ i ], 16,
+                        //               UseDefaultScalingMatrix4x4Flag[ i ])
+                    } else {
+                        // TODO
+                        // scaling_list( ScalingList8x8[ i − 6 ], 64,
+                        //               UseDefaultScalingMatrix8x8Flag[ i − 6 ] )
+                    }
+            }
+        }
+    }
+
+    // log2_max_frame_num_minus4
+    reader.decodeExponentialGolombNumber();
+    const pic_order_cnt_type = reader.decodeExponentialGolombNumber();
+    if (pic_order_cnt_type === 0) {
+        // log2_max_pic_order_cnt_lsb_minus4
+        reader.decodeExponentialGolombNumber();
+    } else if (pic_order_cnt_type === 1) {
+        // delta_pic_order_always_zero_flag
+        reader.next();
+        // offset_for_non_ref_pic
+        reader.decodeExponentialGolombNumber();
+        // offset_for_top_to_bottom_field
+        reader.decodeExponentialGolombNumber();
+        const num_ref_frames_in_pic_order_cnt_cycle =
+            reader.decodeExponentialGolombNumber();
+        const offset_for_ref_frame: number[] = [];
+        for (let i = 0; i < num_ref_frames_in_pic_order_cnt_cycle; i += 1) {
+            offset_for_ref_frame[i] = reader.decodeExponentialGolombNumber();
+        }
+    }
+
+    // max_num_ref_frames
+    reader.decodeExponentialGolombNumber();
+    // gaps_in_frame_num_value_allowed_flag
+    reader.next();
+    const pic_width_in_mbs_minus1 = reader.decodeExponentialGolombNumber();
+    const pic_height_in_map_units_minus1 =
+        reader.decodeExponentialGolombNumber();
+
+    const frame_mbs_only_flag = reader.next();
+    if (!frame_mbs_only_flag) {
+        // mb_adaptive_frame_field_flag
+        reader.next();
+    }
+
+    // direct_8x8_inference_flag
+    reader.next();
+
+    const frame_cropping_flag = !!reader.next();
+    let frame_crop_left_offset: number;
+    let frame_crop_right_offset: number;
+    let frame_crop_top_offset: number;
+    let frame_crop_bottom_offset: number;
+    if (frame_cropping_flag) {
+        frame_crop_left_offset = reader.decodeExponentialGolombNumber();
+        frame_crop_right_offset = reader.decodeExponentialGolombNumber();
+        frame_crop_top_offset = reader.decodeExponentialGolombNumber();
+        frame_crop_bottom_offset = reader.decodeExponentialGolombNumber();
+    } else {
+        frame_crop_left_offset = 0;
+        frame_crop_right_offset = 0;
+        frame_crop_top_offset = 0;
+        frame_crop_bottom_offset = 0;
+    }
+
+    const vui_parameters_present_flag = !!reader.next();
+    if (vui_parameters_present_flag) {
+        // TODO
+        // vui_parameters( )
+    }
+
+    return {
+        profile_idc,
+        constraint_set,
+        constraint_set0_flag,
+        constraint_set1_flag,
+        constraint_set2_flag,
+        constraint_set3_flag,
+        constraint_set4_flag,
+        constraint_set5_flag,
+        level_idc,
+        seq_parameter_set_id,
+        pic_width_in_mbs_minus1,
+        pic_height_in_map_units_minus1,
+        frame_mbs_only_flag,
+        frame_cropping_flag,
+        frame_crop_left_offset,
+        frame_crop_right_offset,
+        frame_crop_top_offset,
+        frame_crop_bottom_offset,
+    };
+}
+
+/**
+ * Find Sequence Parameter Set (SPS) and Picture Parameter Set (PPS)
+ * from H.264 Annex B formatted data.
+ */
+export function h264SearchConfiguration(buffer: Uint8Array) {
+    let sequenceParameterSet: Uint8Array | undefined;
+    let pictureParameterSet: Uint8Array | undefined;
+
+    for (const nalu of annexBSplitNalu(buffer)) {
+        const naluType = nalu[0]! & 0x1f;
+        switch (naluType) {
+            case 7: // Sequence parameter set
+                sequenceParameterSet = nalu;
+                if (pictureParameterSet) {
+                    return {
+                        sequenceParameterSet,
+                        pictureParameterSet,
+                    };
+                }
+                break;
+            case 8: // Picture parameter set
+                pictureParameterSet = nalu;
+                if (sequenceParameterSet) {
+                    return {
+                        sequenceParameterSet,
+                        pictureParameterSet,
+                    };
+                }
+                break;
+            default:
+                // ignore
+                break;
+        }
+    }
+
+    throw new Error("Invalid data");
+}
+
+export interface H264Configuration {
+    pictureParameterSet: Uint8Array;
+    sequenceParameterSet: Uint8Array;
+
+    profileIndex: number;
+    constraintSet: number;
+    levelIndex: number;
+
+    encodedWidth: number;
+    encodedHeight: number;
+
+    cropLeft: number;
+    cropRight: number;
+    cropTop: number;
+    cropBottom: number;
+    croppedWidth: number;
+    croppedHeight: number;
+}
+
+export function h264ParseConfiguration(data: Uint8Array): H264Configuration {
+    const { sequenceParameterSet, pictureParameterSet } =
+        h264SearchConfiguration(data);
+
+    const {
+        profile_idc: profileIndex,
+        constraint_set: constraintSet,
+        level_idc: levelIndex,
+        pic_width_in_mbs_minus1,
+        pic_height_in_map_units_minus1,
+        frame_mbs_only_flag,
+        frame_crop_left_offset,
+        frame_crop_right_offset,
+        frame_crop_top_offset,
+        frame_crop_bottom_offset,
+    } = h264ParseSequenceParameterSet(sequenceParameterSet);
+
+    const encodedWidth = (pic_width_in_mbs_minus1 + 1) * 16;
+    const encodedHeight =
+        (pic_height_in_map_units_minus1 + 1) * (2 - frame_mbs_only_flag) * 16;
+    const cropLeft = frame_crop_left_offset * 2;
+    const cropRight = frame_crop_right_offset * 2;
+    const cropTop = frame_crop_top_offset * 2;
+    const cropBottom = frame_crop_bottom_offset * 2;
+
+    const croppedWidth = encodedWidth - cropLeft - cropRight;
+    const croppedHeight = encodedHeight - cropTop - cropBottom;
+
+    return {
+        pictureParameterSet,
+        sequenceParameterSet,
+        profileIndex,
+        constraintSet,
+        levelIndex,
+        encodedWidth,
+        encodedHeight,
+        cropLeft,
+        cropRight,
+        cropTop,
+        cropBottom,
+        croppedWidth,
+        croppedHeight,
+    };
+}