@xmaxai/web-sdk 1.0.7 → 1.0.9

package/dist/RecordingProcessor-ZSBJFF4J.js

@@ -0,0 +1,211 @@
+import {
+  __publicField
+} from "./chunk-V6TY7KAL.js";
+
+// src/Media/Recording/RecordingProcessor.ts
+import {
+  BlobSource,
+  BufferTarget,
+  EncodedAudioPacketSource,
+  EncodedPacketSink,
+  EncodedVideoPacketSource,
+  Input,
+  MP4,
+  WEBM,
+  Mp4OutputFormat,
+  Output,
+  WebMOutputFormat
+} from "mediabunny";
+
+// src/Media/Recording/RecordingTimeline.ts
+var _RecordingTimeline = class _RecordingTimeline {
+  /**
+   * 从显示时间戳估计正常帧间隔，只裁掉显著超长的等待部分。
+   */
+  constructor(timestamps, duration, audioPackets) {
+    __publicField(this, "duration", duration);
+    /**
+     * 原始时长、正常帧时长与待删除区间
+     */
+    __publicField(this, "frameDuration");
+    __publicField(this, "cuts");
+    if (!Number.isFinite(duration) || duration <= 0 || timestamps.length === 0 || timestamps.some((value) => !Number.isFinite(value) || value < 0 || value > duration)) {
+      throw new Error("Invalid recording timeline");
+    }
+    const sorted = [...timestamps].sort((a, b) => a - b);
+    const intervals = sorted.slice(1).map((time, index) => time - sorted[index]).filter((value) => value > 0).sort((a, b) => a - b);
+    this.frameDuration = intervals[Math.floor(intervals.length / 2)] ?? _RecordingTimeline.fallbackFrameDuration;
+    const threshold = Math.max(_RecordingTimeline.minimumGap, this.frameDuration * _RecordingTimeline.gapMultiplier);
+    const cuts = sorted.flatMap((start, index) => {
+      const end = sorted[index + 1] ?? duration;
+      return end - start > threshold + 1e-6 ? [{ start: start + this.frameDuration, end }] : [];
+    });
+    this.cuts = audioPackets ? cuts.flatMap((cut) => {
+      const contained = audioPackets.filter((packet) => packet.end > packet.start && packet.start >= cut.start && packet.end <= cut.end);
+      if (contained.length === 0) {
+        return [];
+      }
+      return [{
+        start: Math.min(...contained.map((packet) => packet.start)),
+        end: Math.max(...contained.map((packet) => packet.end))
+      }];
+    }) : cuts;
+  }
+  /**
+   * 将原始时间映射到裁剪后的时间；删除区间内的时刻映射到同一接缝。
+   */
+  map(time) {
+    let removed = 0;
+    for (const cut of this.cuts) {
+      if (time <= cut.start) {
+        break;
+      }
+      removed += Math.min(time, cut.end) - cut.start;
+    }
+    return time - removed;
+  }
+  /**
+   * 判断一个音频包是否位于删除区间；区间已对齐包边界，不会切断压缩数据。
+   */
+  removes(start, end) {
+    return this.cuts.some((cut) => start >= cut.start && end <= cut.end);
+  }
+};
+/**
+ * 长间隔判定与默认帧时长
+ */
+__publicField(_RecordingTimeline, "minimumGap", 0.12);
+__publicField(_RecordingTimeline, "gapMultiplier", 3);
+__publicField(_RecordingTimeline, "fallbackFrameDuration", 1 / 30);
+var RecordingTimeline = _RecordingTimeline;
+
+// src/Media/Recording/RecordingProcessor.ts
+var _RecordingProcessor = class _RecordingProcessor {
+  /**
+   * 裁剪成功返回新文件，无需裁剪时返回原文件；失败交由调用方保留原始录像。
+   */
+  async process(blob) {
+    if (blob.size > _RecordingProcessor.maximumBytes) {
+      throw new Error("Recording is too large to process");
+    }
+    const input = new Input({ source: new BlobSource(blob), formats: [MP4, WEBM] });
+    const controller = new AbortController();
+    let output;
+    let timer;
+    const timeout = new Promise((_, reject) => {
+      timer = setTimeout(() => {
+        controller.abort();
+        reject(new Error("Recording processing timed out"));
+      }, _RecordingProcessor.timeoutMs);
+    });
+    try {
+      return await Promise.race([
+        this.rewrite(input, blob, controller.signal, (value) => {
+          output = value;
+        }),
+        timeout
+      ]);
+    } finally {
+      controller.abort();
+      clearTimeout(timer);
+      input.dispose();
+      if (output && output.state !== "finalized" && output.state !== "canceled") {
+        void output.cancel().catch(() => {
+        });
+      }
+    }
+  }
+  /**
+   * 读取有限数量的编码包，维持原始解码顺序。
+   */
+  async readPackets(track, signal) {
+    const packets = [];
+    for await (const packet of new EncodedPacketSink(track).packets()) {
+      signal.throwIfAborted();
+      packets.push(packet);
+      if (packets.length > _RecordingProcessor.maximumPackets) {
+        throw new Error("Recording has too many media packets");
+      }
+    }
+    return packets;
+  }
+  /**
+   * 保留所有视频帧，删除等待区间内的完整音频包，并重新封装两条时间线。
+   */
+  async rewrite(input, original, signal, registerOutput) {
+    const video = await input.getPrimaryVideoTrack();
+    if (!video) {
+      throw new Error("Recording has no video track");
+    }
+    const videoPackets = await this.readPackets(video, signal);
+    const audio = await input.getPrimaryAudioTrack();
+    const audioPackets = audio ? await this.readPackets(audio, signal) : [];
+    const duration = await input.computeDuration();
+    const audioRanges = audioPackets.map((packet, index) => ({
+      start: packet.timestamp,
+      end: packet.duration > 0 ? packet.timestamp + packet.duration : audioPackets[index + 1]?.timestamp ?? duration
+    }));
+    const timeline = new RecordingTimeline(videoPackets.map((packet) => packet.timestamp), duration, audio ? audioRanges : void 0);
+    if (timeline.cuts.length === 0) {
+      return original;
+    }
+    const videoCodec = await video.getCodec();
+    const videoConfig = await video.getDecoderConfig();
+    const audioCodec = await audio?.getCodec();
+    const audioConfig = await audio?.getDecoderConfig();
+    if (!videoCodec || !videoConfig || audio && (!audioCodec || !audioConfig)) {
+      throw new Error("Unsupported recording codec");
+    }
+    const isWebM = (await input.getFormat()).name === WEBM.name;
+    const rotation = await video.getRotation();
+    const flip = await video.getFlip();
+    signal.throwIfAborted();
+    const output = new Output({
+      format: isWebM ? new WebMOutputFormat() : new Mp4OutputFormat(),
+      target: new BufferTarget()
+    });
+    registerOutput(output);
+    const videoSource = new EncodedVideoPacketSource(videoCodec);
+    output.addVideoTrack(videoSource, { rotation, flip });
+    const audioSource = audioCodec ? new EncodedAudioPacketSource(audioCodec) : void 0;
+    if (audioSource) {
+      output.addAudioTrack(audioSource);
+    }
+    await output.start();
+    for (const packet of videoPackets) {
+      signal.throwIfAborted();
+      const timestamp = timeline.map(packet.timestamp);
+      const duration2 = timeline.map(packet.timestamp + packet.duration) - timestamp;
+      await videoSource.add(packet.clone({ timestamp, duration: duration2 }), { decoderConfig: videoConfig });
+    }
+    videoSource.close();
+    if (audioSource && audioConfig) {
+      for (const [index, packet] of audioPackets.entries()) {
+        signal.throwIfAborted();
+        const range = audioRanges[index];
+        if (timeline.removes(range.start, range.end)) {
+          continue;
+        }
+        await audioSource.add(packet.clone({ timestamp: timeline.map(packet.timestamp) }), { decoderConfig: audioConfig });
+      }
+      audioSource.close();
+    }
+    signal.throwIfAborted();
+    await output.finalize();
+    if (!output.target.buffer || output.target.buffer.byteLength > _RecordingProcessor.maximumBytes) {
+      throw new Error("Processed recording exceeds the memory limit");
+    }
+    return new Blob([output.target.buffer], { type: output.format.mimeType });
+  }
+};
+/**
+ * 后处理资源上限，与实时连接的清理超时分离
+ */
+__publicField(_RecordingProcessor, "timeoutMs", 1e4);
+__publicField(_RecordingProcessor, "maximumBytes", 64 * 1024 * 1024);
+__publicField(_RecordingProcessor, "maximumPackets", 1e4);
+var RecordingProcessor = _RecordingProcessor;
+export {
+  RecordingProcessor
+};
+//# sourceMappingURL=RecordingProcessor-ZSBJFF4J.js.map

package/dist/RecordingProcessor-ZSBJFF4J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Media/Recording/RecordingProcessor.ts","../src/Media/Recording/RecordingTimeline.ts"],"sourcesContent":["import {\n  BlobSource, BufferTarget, EncodedAudioPacketSource, EncodedPacketSink,\n  EncodedVideoPacketSource, Input, MP4, WEBM, Mp4OutputFormat, Output, WebMOutputFormat,\n  type EncodedPacket, type InputTrack,\n} from \"mediabunny\";\nimport { RecordingTimeline } from \"./RecordingTimeline\";\n\n/**\n * 录制完成后裁掉长帧等待；音视频共用按音频包边界对齐的时间映射，不重新编码。\n */\nexport class RecordingProcessor {\n  /**\n   * 后处理资源上限，与实时连接的清理超时分离\n   */\n  private static readonly timeoutMs = 10_000;\n  private static readonly maximumBytes = 64 * 1024 * 1024;\n  private static readonly maximumPackets = 10_000;\n\n  /**\n   * 裁剪成功返回新文件，无需裁剪时返回原文件；失败交由调用方保留原始录像。\n   */\n  async process(blob: Blob): Promise<Blob> {\n    if (blob.size > RecordingProcessor.maximumBytes) {\n      throw new Error(\"Recording is too large to process\");\n    }\n\n    const input = new Input({ source: new BlobSource(blob), formats: [MP4, WEBM] });\n    const controller = new AbortController();\n    let output: Output | undefined;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    const timeout = new Promise<never>((_, reject) => {\n      timer = setTimeout(() => {\n        controller.abort();\n        reject(new Error(\"Recording processing timed out\"));\n      }, RecordingProcessor.timeoutMs);\n    });\n\n    try {\n      return await Promise.race([\n        this.rewrite(input, blob, controller.signal, value => { output = value; }),\n        timeout,\n      ]);\n    } finally {\n      controller.abort();\n      clearTimeout(timer);\n      input.dispose();\n      if (output && output.state !== \"finalized\" && output.state !== \"canceled\") {\n        void output.cancel().catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * 读取有限数量的编码包，维持原始解码顺序。\n   */\n  private async readPackets(track: InputTrack, signal: AbortSignal): Promise<EncodedPacket[]> {\n    const packets: EncodedPacket[] = [];\n    for await (const packet of new EncodedPacketSink(track).packets()) {\n      signal.throwIfAborted();\n      packets.push(packet);\n      if (packets.length > RecordingProcessor.maximumPackets) {\n        throw new Error(\"Recording has too many media packets\");\n      }\n    }\n    return packets;\n  }\n\n  /**\n   * 保留所有视频帧，删除等待区间内的完整音频包，并重新封装两条时间线。\n   */\n  private async rewrite(\n    input: Input,\n    original: Blob,\n    signal: AbortSignal,\n    registerOutput: (output: Output) => void,\n  ): Promise<Blob> {\n    const video = await input.getPrimaryVideoTrack();\n    if (!video) {\n      throw new Error(\"Recording has no video track\");\n    }\n    const videoPackets = await this.readPackets(video, signal);\n    const audio = await input.getPrimaryAudioTrack();\n    const audioPackets = audio ? await this.readPackets(audio, signal) : [];\n    const duration = await input.computeDuration();\n    const audioRanges = audioPackets.map((packet, index) => ({\n      start: packet.timestamp,\n      end: packet.duration > 0 ? packet.timestamp + packet.duration : audioPackets[index + 1]?.timestamp ?? duration,\n    }));\n    const timeline = new RecordingTimeline(videoPackets.map(packet => packet.timestamp), duration, audio ? audioRanges : undefined);\n    if (timeline.cuts.length === 0) {\n      return original;\n    }\n\n    const videoCodec = await video.getCodec();\n    const videoConfig = await video.getDecoderConfig();\n    const audioCodec = await audio?.getCodec();\n    const audioConfig = await audio?.getDecoderConfig();\n    if (!videoCodec || !videoConfig || (audio && (!audioCodec || !audioConfig))) {\n      throw new Error(\"Unsupported recording codec\");\n    }\n    const isWebM = (await input.getFormat()).name === WEBM.name;\n    const rotation = await video.getRotation();\n    const flip = await video.getFlip();\n    signal.throwIfAborted();\n\n    const output = new Output({\n      format: isWebM ? new WebMOutputFormat() : new Mp4OutputFormat(),\n      target: new BufferTarget(),\n    });\n    registerOutput(output);\n    const videoSource = new EncodedVideoPacketSource(videoCodec);\n    output.addVideoTrack(videoSource, { rotation, flip });\n    const audioSource = audioCodec ? new EncodedAudioPacketSource(audioCodec) : undefined;\n    if (audioSource) {\n      output.addAudioTrack(audioSource);\n    }\n    await output.start();\n\n    // 不指定固定帧率，避免容器把原本不同的显示时间戳量化到同一帧。\n    for (const packet of videoPackets) {\n      signal.throwIfAborted();\n      const timestamp = timeline.map(packet.timestamp);\n      const duration = timeline.map(packet.timestamp + packet.duration) - timestamp;\n      await videoSource.add(packet.clone({ timestamp, duration }), { decoderConfig: videoConfig });\n    }\n    videoSource.close();\n\n    if (audioSource && audioConfig) {\n      for (const [index, packet] of audioPackets.entries()) {\n        signal.throwIfAborted();\n        const range = audioRanges[index]!;\n        if (timeline.removes(range.start, range.end)) {\n          continue;\n        }\n        await audioSource.add(packet.clone({ timestamp: timeline.map(packet.timestamp) }), { decoderConfig: audioConfig });\n      }\n      audioSource.close();\n    }\n    signal.throwIfAborted();\n    await output.finalize();\n    if (!output.target.buffer || output.target.buffer.byteLength > RecordingProcessor.maximumBytes) {\n      throw new Error(\"Processed recording exceeds the memory limit\");\n    }\n    return new Blob([output.target.buffer], { type: output.format.mimeType });\n  }\n}\n","/**\n * 原始录制时间线上的区间，单位为秒。\n */\nexport interface RecordingTimeRange {\n  start: number;\n  end: number;\n}\n\n/**\n * 视频长帧裁剪计划。音视频共用同一映射，避免分别累计时间造成漂移。\n */\nexport class RecordingTimeline {\n  /**\n   * 长间隔判定与默认帧时长\n   */\n  private static readonly minimumGap = 0.12;\n  private static readonly gapMultiplier = 3;\n  private static readonly fallbackFrameDuration = 1 / 30;\n\n  /**\n   * 原始时长、正常帧时长与待删除区间\n   */\n  readonly frameDuration: number;\n  readonly cuts: readonly RecordingTimeRange[];\n\n  /**\n   * 从显示时间戳估计正常帧间隔，只裁掉显著超长的等待部分。\n   */\n  constructor(timestamps: readonly number[], readonly duration: number, audioPackets?: readonly RecordingTimeRange[]) {\n    if (!Number.isFinite(duration) || duration <= 0 || timestamps.length === 0 ||\n        timestamps.some(value => !Number.isFinite(value) || value < 0 || value > duration)) {\n      throw new Error(\"Invalid recording timeline\");\n    }\n\n    const sorted = [...timestamps].sort((a, b) => a - b);\n    const intervals = sorted.slice(1).map((time, index) => time - sorted[index]!)\n      .filter(value => value > 0).sort((a, b) => a - b);\n    this.frameDuration = intervals[Math.floor(intervals.length / 2)] ?? RecordingTimeline.fallbackFrameDuration;\n    const threshold = Math.max(RecordingTimeline.minimumGap, this.frameDuration * RecordingTimeline.gapMultiplier);\n\n    const cuts = sorted.flatMap((start, index) => {\n      const end = sorted[index + 1] ?? duration;\n      return end - start > threshold + 1e-6 ? [{ start: start + this.frameDuration, end }] : [];\n    });\n\n    // 只删除完全落在等待区间内的音频包；同一裁剪边界同时用于视频，避免重编码延迟。\n    this.cuts = audioPackets ? cuts.flatMap(cut => {\n      const contained = audioPackets.filter(packet => packet.end > packet.start &&\n        packet.start >= cut.start && packet.end <= cut.end);\n      if (contained.length === 0) {\n        return [];\n      }\n      return [{\n        start: Math.min(...contained.map(packet => packet.start)),\n        end: Math.max(...contained.map(packet => packet.end)),\n      }];\n    }) : cuts;\n  }\n\n  /**\n   * 将原始时间映射到裁剪后的时间；删除区间内的时刻映射到同一接缝。\n   */\n  map(time: number): number {\n    let removed = 0;\n    for (const cut of this.cuts) {\n      if (time <= cut.start) {\n        break;\n      }\n      removed += Math.min(time, cut.end) - cut.start;\n    }\n    return time - removed;\n  }\n\n  /**\n   * 判断一个音频包是否位于删除区间；区间已对齐包边界，不会切断压缩数据。\n   */\n  removes(start: number, end: number): boolean {\n    return this.cuts.some(cut => start >= cut.start && end <= cut.end);\n  }\n}\n"],"mappings":"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","names":["duration"]}

package/dist/{VideoRenderStatistics-C7zqzfuS.d.cts → TrajectoryEffectRendering-C7E2KJbV.d.cts}

@@ -212,4 +212,51 @@ interface VideoRenderStatistics {
     readonly interpolatedFrameRate: number;
 }
 
-export { CameraPosition as C, RealtimeVideoFormat as R, VideoContentMode as V, RealtimeVideoTrack as a, type VideoRenderStatistics as b, RealtimeVideoEncoderPreference as c, type RealtimeVideoFormatInit as d };
+/**
+ * 单次按下到释放期间稳定的轨迹标识，不依赖浏览器复用的 pointerId。
+ */
+type TrajectoryID = number;
+/**
+ * 供视觉效果使用的触点；location 为视口 CSS 像素，timestamp 为毫秒。
+ */
+interface TrajectoryPoint {
+    readonly id: TrajectoryID;
+    readonly location: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly normalizedLocation: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly timestamp: number;
+}
+
+/**
+ * 可替换的轨迹视觉效果；不参与触点采样、坐标转换或网络发送。
+ * 一个实例仅供一个视图使用，reset 必须释放动画和清空轨迹。
+ */
+interface TrajectoryEffectRendering {
+    /**
+     * 安装在交互层中的元素；SDK 禁用该元素的指针事件。
+     */
+    readonly element: HTMLElement;
+    /**
+     * 绘制新轨迹。
+     */
+    renderBegan(points: readonly TrajectoryPoint[]): void;
+    /**
+     * 更新已有轨迹。
+     */
+    renderMoved(points: readonly TrajectoryPoint[]): void;
+    /**
+     * 结束轨迹，可继续播放淡出效果。
+     */
+    renderEnded(identifiers: readonly TrajectoryID[]): void;
+    /**
+     * 清除全部轨迹并取消动画；实例仍可再次使用。
+     */
+    reset(): void;
+}
+
+export { CameraPosition as C, RealtimeVideoFormat as R, type TrajectoryEffectRendering as T, VideoContentMode as V, RealtimeVideoTrack as a, type VideoRenderStatistics as b, RealtimeVideoEncoderPreference as c, type RealtimeVideoFormatInit as d, type TrajectoryID as e, type TrajectoryPoint as f };

package/dist/{VideoRenderStatistics-C7zqzfuS.d.ts → TrajectoryEffectRendering-C7E2KJbV.d.ts}

@@ -212,4 +212,51 @@ interface VideoRenderStatistics {
     readonly interpolatedFrameRate: number;
 }
 
-export { CameraPosition as C, RealtimeVideoFormat as R, VideoContentMode as V, RealtimeVideoTrack as a, type VideoRenderStatistics as b, RealtimeVideoEncoderPreference as c, type RealtimeVideoFormatInit as d };
+/**
+ * 单次按下到释放期间稳定的轨迹标识，不依赖浏览器复用的 pointerId。
+ */
+type TrajectoryID = number;
+/**
+ * 供视觉效果使用的触点；location 为视口 CSS 像素，timestamp 为毫秒。
+ */
+interface TrajectoryPoint {
+    readonly id: TrajectoryID;
+    readonly location: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly normalizedLocation: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly timestamp: number;
+}
+
+/**
+ * 可替换的轨迹视觉效果；不参与触点采样、坐标转换或网络发送。
+ * 一个实例仅供一个视图使用，reset 必须释放动画和清空轨迹。
+ */
+interface TrajectoryEffectRendering {
+    /**
+     * 安装在交互层中的元素；SDK 禁用该元素的指针事件。
+     */
+    readonly element: HTMLElement;
+    /**
+     * 绘制新轨迹。
+     */
+    renderBegan(points: readonly TrajectoryPoint[]): void;
+    /**
+     * 更新已有轨迹。
+     */
+    renderMoved(points: readonly TrajectoryPoint[]): void;
+    /**
+     * 结束轨迹，可继续播放淡出效果。
+     */
+    renderEnded(identifiers: readonly TrajectoryID[]): void;
+    /**
+     * 清除全部轨迹并取消动画；实例仍可再次使用。
+     */
+    reset(): void;
+}
+
+export { CameraPosition as C, RealtimeVideoFormat as R, type TrajectoryEffectRendering as T, VideoContentMode as V, RealtimeVideoTrack as a, type VideoRenderStatistics as b, RealtimeVideoEncoderPreference as c, type RealtimeVideoFormatInit as d, type TrajectoryID as e, type TrajectoryPoint as f };

package/dist/chunk-4DE2IREA.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+
+
+exports.__publicField = __publicField;
+//# sourceMappingURL=chunk-4DE2IREA.cjs.map

package/dist/chunk-4DE2IREA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-Zggzaq/source/packages/xmax-sdk/dist/chunk-4DE2IREA.cjs"],"names":[],"mappings":"AAAA,6EAAI,UAAU,EAAE,MAAM,CAAC,cAAc;AACrC,IAAI,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK;AAC/J,IAAI,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,GAAG,EAAE,OAAO,IAAI,IAAI,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC;AAC9G;AACA;AACE;AACF,sCAAC","file":"/private/var/folders/5j/p3g3j18x2w3byrl5wtnk94tc0000gn/T/xmax-web-release-Zggzaq/source/packages/xmax-sdk/dist/chunk-4DE2IREA.cjs"}