@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/videoExport/exporter.js

@@ -0,0 +1,74 @@
+import { val } from '@dreamerbird/dataverse';
+import { createMediaRecorderEncoder, extForMime } from './encoder';
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * 导出镜头视频:序列从头播到尾,canvas 画面实时编码,数据块流式写给 sink。
+ * 调用前先把画面切到镜头视角(录的就是 canvas 当前内容)。
+ *
+ * 一期限制:实时录制——序列多长就录多久,播放掉帧录出来也掉帧;
+ * 容器格式看浏览器(webm 为主)。离线逐帧渲染 + mp4 留作以后升级。
+ */
+export function startShotExport(args) {
+    const { canvas, sheet, sink, onError } = args;
+    // 30fps 是上限:frameloop="demand" 下只有画面真变才有帧,不会硬塞重复帧
+    const stream = canvas.captureStream(30);
+    const encoder = createMediaRecorderEncoder(stream);
+    if (!encoder) {
+        onError?.('当前浏览器不支持视频录制(MediaRecorder 无可用格式)');
+        return undefined;
+    }
+    const sequence = sheet.sequence;
+    const length = val(sequence.pointer.length);
+    const stamp = new Date().toISOString().slice(0, 16).replace(/[T:]/g, '-');
+    const suggestedName = `镜头-${stamp}.${extForMime(encoder.mimeType)}`;
+    let aborted = false;
+    const done = (async () => {
+        try {
+            // 另存为会在这里弹系统对话框;用户点取消 = AbortError,安静结束
+            await sink.start({ mimeType: encoder.mimeType, suggestedName });
+        }
+        catch (err) {
+            if (err?.name === 'AbortError')
+                return;
+            throw err;
+        }
+        // sink.write 串行化:MediaRecorder 的块按序到达,写也按序落盘
+        let writeChain = Promise.resolve();
+        encoder.onChunk = (chunk) => {
+            writeChain = writeChain.then(() => sink.write(chunk));
+        };
+        // 等编码器真正启动('start' 事件)再计时:冷页面 init 实测 400ms+,
+        // 不等就开录,stop() 会抢在 'start' 前,短片段产出 0 字节(2026-10-19)
+        await encoder.start();
+        await sleep(150); // 编码器热身,开头少丢帧
+        try {
+            sequence.position = 0;
+            // play 全程 resolve true;pause() 打断 resolve false,两条路都走到收尾
+            await sequence.play({ iterationCount: 1, range: [0, length] });
+            await sleep(120); // 末尾帧冲刷
+        }
+        finally {
+            await encoder.stop();
+            await writeChain;
+        }
+        if (aborted) {
+            await sink.abort();
+            return;
+        }
+        await sink.finish();
+    })().catch((err) => {
+        sink.abort().catch(() => { });
+        onError?.(`导出失败:${err?.message ?? err}`);
+        throw err;
+    });
+    return {
+        finishEarly() {
+            sequence.pause();
+        },
+        abort() {
+            aborted = true;
+            sequence.pause();
+        },
+        done,
+    };
+}

package/dist/videoExport/sinks.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 导出目标(ExportSink):编码器产出的数据块写到哪儿。
+ * 一期两个本地目标:另存为(流式写盘)和直接下载(攒 Blob);
+ * 以后接存储 API(分片上传、finish 提交合并)就是再实现一个
+ * 同样的接口,导出菜单自动多一项,编码器和导出流程不动。
+ */
+export interface ExportSinkMeta {
+    mimeType: string;
+    suggestedName: string;
+}
+export interface ExportSink {
+    readonly id: string;
+    /** 菜单里显示的名字 */
+    readonly label: string;
+    /** 菜单里的一行说明 */
+    readonly description: string;
+    /** 当前环境是否可用(另存为需要 File System Access API) */
+    available(): boolean;
+    /** 另存为会在这里弹系统对话框,所以 start 必须在用户点击的调用栈里调 */
+    start(meta: ExportSinkMeta): Promise<void>;
+    /** 流式写一块;调用方保证顺序、不并发 */
+    write(chunk: Uint8Array): Promise<void>;
+    /** 全部写完,落盘收尾 */
+    finish(): Promise<void>;
+    /** 中途取消:丢弃已收到的内容,不留半成品 */
+    abort(): Promise<void>;
+}
+/** 直接下载:块攒在内存,结束后拼 Blob 触发浏览器下载(所有浏览器可用) */
+export declare class BlobDownloadSink implements ExportSink {
+    readonly id = "download";
+    readonly label = "\u76F4\u63A5\u4E0B\u8F7D";
+    readonly description = "\u5F55\u5236\u5B8C\u6210\u540E\u5B58\u5230\u6D4F\u89C8\u5668\u7684\u4E0B\u8F7D\u76EE\u5F55";
+    private chunks;
+    private meta;
+    available(): boolean;
+    start(meta: ExportSinkMeta): Promise<void>;
+    write(chunk: Uint8Array): Promise<void>;
+    finish(): Promise<void>;
+    abort(): Promise<void>;
+}
+/** 另存为:File System Access API 流式写盘,录制前用户选好位置(Chrome/Edge) */
+export declare class SaveAsSink implements ExportSink {
+    readonly id = "save-as";
+    readonly label = "\u53E6\u5B58\u4E3A\u2026";
+    readonly description = "\u5F00\u59CB\u524D\u9009\u62E9\u4FDD\u5B58\u4F4D\u7F6E,\u8FB9\u5F55\u8FB9\u5199\u76D8";
+    private writable;
+    available(): boolean;
+    start(meta: ExportSinkMeta): Promise<void>;
+    write(chunk: Uint8Array): Promise<void>;
+    finish(): Promise<void>;
+    abort(): Promise<void>;
+}
+/** 当前可用的导出目标,按推荐顺序 */
+export declare function listSinks(): ExportSink[];
+//# sourceMappingURL=sinks.d.ts.map

package/dist/videoExport/sinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.d.ts","sourceRoot":"","sources":["../../src/videoExport/sinks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,eAAe;IACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,6CAA6C;IAC7C,SAAS,IAAI,OAAO,CAAA;IACpB,2CAA2C;IAC3C,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,wBAAwB;IACxB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,gBAAgB;IAChB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,0BAA0B;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,4CAA4C;AAC5C,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,EAAE,cAAa;IACxB,QAAQ,CAAC,KAAK,8BAAS;IACvB,QAAQ,CAAC,WAAW,gGAAoB;IACxC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,IAAI,CAA4B;IAExC,SAAS,IAAI,OAAO;IAId,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAcvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,6DAA6D;AAC7D,qBAAa,UAAW,YAAW,UAAU;IAC3C,QAAQ,CAAC,EAAE,aAAY;IACvB,QAAQ,CAAC,KAAK,8BAAS;IACvB,QAAQ,CAAC,WAAW,2FAAoB;IACxC,OAAO,CAAC,QAAQ,CAA0C;IAE1D,SAAS,IAAI,OAAO;IAId,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED,sBAAsB;AACtB,wBAAgB,SAAS,IAAI,UAAU,EAAE,CAExC"}

package/dist/videoExport/sinks.js

@@ -0,0 +1,69 @@
+/** 直接下载:块攒在内存,结束后拼 Blob 触发浏览器下载(所有浏览器可用) */
+export class BlobDownloadSink {
+    constructor() {
+        this.id = 'download';
+        this.label = '直接下载';
+        this.description = '录制完成后存到浏览器的下载目录';
+        this.chunks = [];
+    }
+    available() {
+        return true;
+    }
+    async start(meta) {
+        this.chunks = [];
+        this.meta = meta;
+    }
+    async write(chunk) {
+        this.chunks.push(chunk);
+    }
+    async finish() {
+        const blob = new Blob(this.chunks, {
+            type: this.meta?.mimeType,
+        });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = this.meta?.suggestedName ?? 'video.webm';
+        a.click();
+        //  revoke 得太早有的浏览器还没开始下载,给一拍
+        setTimeout(() => URL.revokeObjectURL(url), 1000);
+        this.chunks = [];
+    }
+    async abort() {
+        this.chunks = [];
+    }
+}
+/** 另存为:File System Access API 流式写盘,录制前用户选好位置(Chrome/Edge) */
+export class SaveAsSink {
+    constructor() {
+        this.id = 'save-as';
+        this.label = '另存为…';
+        this.description = '开始前选择保存位置,边录边写盘';
+    }
+    available() {
+        return typeof window.showSaveFilePicker === 'function';
+    }
+    async start(meta) {
+        const handle = await window.showSaveFilePicker({
+            suggestedName: meta.suggestedName,
+        });
+        this.writable =
+            (await handle.createWritable());
+    }
+    async write(chunk) {
+        await this.writable.write(chunk);
+    }
+    async finish() {
+        await this.writable.close();
+        this.writable = undefined;
+    }
+    async abort() {
+        // abort 后文件里可能留有已写入的前缀,浏览器不保证删得掉,尽力而为
+        await this.writable?.abort();
+        this.writable = undefined;
+    }
+}
+/** 当前可用的导出目标,按推荐顺序 */
+export function listSinks() {
+    return [new SaveAsSink(), new BlobDownloadSink()].filter((s) => s.available());
+}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@dreamerbird/camera-studio",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract-tests": {
+      "types": "./dist/assetLibrary/contractTests.d.ts",
+      "default": "./dist/assetLibrary/contractTests.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "assets/**/*"
+  ],
+  "scripts": {
+    "build:ts": "tsc -b tsconfig.json",
+    "build:api": "tsc -b tsconfig.json && api-extractor run --local --config devEnv/api-extractor.json",
+    "clean": "rimraf dist tsconfig.tsbuildinfo"
+  },
+  "peerDependencies": {
+    "@dreamerbird/core": "*",
+    "@dreamerbird/studio": "*",
+    "@react-three/fiber": "^9.0.0",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "three": ">=0.185"
+  },
+  "dependencies": {
+    "@dreamerbird/dataverse": "1.0.0",
+    "@dreamerbird/r3f": "1.0.0",
+    "@dreamerbird/react": "1.0.0",
+    "@dreamerbird/threeik": "0.2.1",
+    "@gltf-transform/core": "^4.0.0",
+    "@gltf-transform/extensions": "^4.0.0",
+    "@gltf-transform/functions": "^4.0.0",
+    "@phosphor-icons/react": "^2.1.10",
+    "@react-three/drei": "^10.7.8",
+    "draco3dgltf": "^1.5.7",
+    "styled-components": "^6.5.3",
+    "three-stdlib": "^2.36.1"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.28.6",
+    "@react-three/fiber": "^9.7.0",
+    "@types/jest": "^26.0.23",
+    "@types/node": "^15.6.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "@types/three": "0.185.4",
+    "fake-indexeddb": "^5",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "three": "^0.185.1",
+    "typescript": "5.6.3"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.