trtc-electron-sdk 13.4.800-alpha.0 → 13.4.802-beta.0

package/README.md

@@ -11,13 +11,13 @@ Tencent Real-Time Communication (TRTC) is a set of low-latency, high-quality rea
 - ⬆️ [Publishing to CSS CDN](https://www.tencentcloud.com/document/product/647/47858#)
 
 ## 💻 Environment Support
-- 🍎 Support macOS x64 and arm64（**Electron 11+**）
-- ⚙️ Support Windows ia32 and x64
+- 🍎 macOS **11.0 (Big Sur)** and above, x64 and arm64 (**Electron 11+**)
+- 🪟 Windows 7 SP1 and above, ia32 and x64
 - 🌈 Electron: 8.5.0 and above
 
-|    macOS     |   Windows   |    Electron    |
-| :----------: | :---------: | :------------: |
-| x64 \| arm64 | ia32 \| x64 | 8.5.0 and above |
+|         macOS          |   Windows   |    Electron    |
+| :--------------------: | :---------: | :------------: |
+| 11.0+ (x64 \| arm64)   | ia32 \| x64 | 8.5.0 and above |
 
 
 ## ⏬ Install

package/liteav/Renderer/yuv-buffer.d.ts

@@ -25,28 +25,28 @@ export interface YUVFormat {
     displayHeight?: number;
 }
 /**
- * Represents underlying image data for a single luma or chroma plane.
- * Cannot be interpreted without the format data from a frame buffer.
- * @typedef {Object} YUVPlane
- * @property {Uint8Array} bytes - typed array containing image data bytes
- * @property {number} stride - byte distance between rows in data
- */
+  * Represents underlying image data for a single luma or chroma plane.
+  * Cannot be interpreted without the format data from a frame buffer.
+  * @typedef {Object} YUVPlane
+  * @property {Uint8Array} bytes - typed array containing image data bytes
+  * @property {number} stride - byte distance between rows in data
+  */
 export interface YUVPlane {
     bytes: Uint8Array;
     stride: number;
 }
 /**
- * Represents a YUV image frame buffer, with enough format information
- * to interpret the data usefully. Buffer objects use generic objects
- * under the hood and can be transferred between worker threads using
- * the structured clone algorithm.
- *
- * @typedef {Object} YUVFrame
- * @property {YUVFormat} format
- * @property {YUVPlane} y
- * @property {YUVPlane} u
- * @property {YUVPlane} v
- */
+  * Represents a YUV image frame buffer, with enough format information
+  * to interpret the data usefully. Buffer objects use generic objects
+  * under the hood and can be transferred between worker threads using
+  * the structured clone algorithm.
+  *
+  * @typedef {Object} YUVFrame
+  * @property {YUVFormat} format
+  * @property {YUVPlane} y
+  * @property {YUVPlane} u
+  * @property {YUVPlane} v
+  */
 export interface YUVFrame {
     format: YUVFormat;
     y: YUVPlane;

package/liteav/Renderer/yuv-buffer.js

@@ -166,12 +166,12 @@ var YUVBuffer = {
         stride = stride || this.suitableStride(width);
         this.validateDimension(stride);
         if (stride < width) {
-            throw "Invalid input stride for YUV plane; must be larger than width";
+            throw 'Invalid input stride for YUV plane; must be larger than width';
         }
         size = stride * height;
         if (source) {
             if (source.length - offset < size) {
-                throw "Invalid input buffer for YUV plane; must be large enough for stride times height";
+                throw 'Invalid input buffer for YUV plane; must be large enough for stride times height';
             }
             bytes = source; // source.slice(offset, offset + size);
         }

package/liteav/extensions/MediaMixingManager/MediaMixingManager.d.ts

@@ -54,6 +54,8 @@ export declare enum TRTCMediaMixingEvent {
     onError = "onError",
     /**
      * @description 设备插入事件
+     * @deprecated
+     * @private
      *
      * @event TRTCMediaMixingEvent#onSourcePlugged
      * @param {TRTCPhoneMirrorParam} source 投屏手机状态信息
@@ -62,6 +64,8 @@ export declare enum TRTCMediaMixingEvent {
     onSourcePlugged = "onSourcePlugged",
     /**
      * @description 设备链接事件
+     * @deprecated
+     * @private
      *
      * @event TRTCMediaMixingEvent#onSourceConnected
      * @param {TRTCPhoneMirrorParam} source 投屏手机状态信息
@@ -70,6 +74,8 @@ export declare enum TRTCMediaMixingEvent {
     onSourceConnected = "onSourceConnected",
     /**
      * @description 设备断开链接事件
+     * @deprecated
+     * @private
      *
      * @event TRTCMediaMixingEvent#onSourceDisconnected
      * @param {TRTCPhoneMirrorParam} source 投屏手机状态信息
@@ -78,6 +84,8 @@ export declare enum TRTCMediaMixingEvent {
     onSourceDisconnected = "onSourceDisconnected",
     /**
      * @description 设备拔出事件
+     * @deprecated
+     * @private
      *
      * @event TRTCMediaMixingEvent#onSourceUnplugged
      * @param {TRTCPhoneMirrorParam} source 投屏手机状态信息
@@ -95,6 +103,13 @@ export declare enum TRTCMediaMixingEvent {
      * @param {Number} size.height 媒体源最新高度
      */
     onMediaSourceSizeChanged = "onMediaSourceSizeChanged",
+    /**
+     * @description 本地混流服务丢失事件
+     * @deprecated
+     * @private
+     *
+     * @event TRTCMediaMixingEvent#onMediaMixingServerLost
+     */
     onMediaMixingServerLost = "onMediaMixingServerLost"
 }
 declare enum TRTCMediaMixingServerMode {
@@ -128,6 +143,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
     private autoControlServer;
     private serverStatus;
     private serverMode;
+    private addMediaSourceTimers;
     private webRenderer;
     private pixelFormat;
     private pixelLength;
@@ -240,6 +256,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * @returns {Promise<void>}
      */
     addMediaSource(mediaSource: TRTCMediaSource): Promise<void>;
+    private getAddMediaSourceTimeoutMs;
     /**
      * 删除本地混流媒体源
      * @param mediaSource {TRTCMediaSource} - 媒体源信息
@@ -256,12 +273,17 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
     updateMediaSource(mediaSource: TRTCMediaSource): Promise<void>;
     /**
      * 设置摄像头采集参数
+     *
+     * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     *
      * @param cameraID {string} - 摄像头 ID
      * @param params {TRTCCameraCaptureParams} - 摄像头采集参数
      */
     setCameraCaptureParam(cameraID: string, params: TRTCCameraCaptureParams): void;
     /**
      * 设置手机投屏参数
+     *
+     * @deprecated
      * @private
      * @param phoneMirrorSourceId {string} - 手机投屏媒体源 ID
      * @param param {TRTCPhoneMirrorParam} - 手机投屏参数
@@ -269,18 +291,27 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
     setPhoneMirrorParam(phoneMirrorSourceId: string, param: TRTCPhoneMirrorParam): void;
     /**
      * 设置屏幕采集参数
+     *
+     * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     *
      * @param screenOrWindowID {String} - 屏幕 ID 或 窗口 ID
      * @param property {TRTCScreenCaptureProperty} - 屏幕采集属性
      */
     setScreenCaptureProperty(screenOrWindowID: string, property: TRTCScreenCaptureProperty): void;
     /**
      * 设置在线视频源播放参数
+     *
+     * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     *
      * @param url {string} - 在线视频源 URL
      * @param param {TRTCOnlineVideoParam} - 在线视频源播放参数
      */
     setOnlineVideoParam(url: string, param: TRTCOnlineVideoParam): void;
     /**
      * 设置视频文件播放参数
+     *
+     * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     *
      * @param videoFilePath {string} - 视频文件路径
      * @param param {TRTCVideoFileParam} - 视频文件播放参数
      */
@@ -449,6 +480,58 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
     private onCallExperimentalAPIFinish;
     private recoverMediaMixingServer;
     private onDevicePixelRatioChange;
+    /**
+     * @private
+     * Apply camera capture params BEFORE native addMediaSource.
+     *
+     * Calling setCameraCaptureParam after the camera has already been added
+     * triggers an extra camera restart (the camera first starts with default
+     * params and then restarts with the new ones). To avoid this we set
+     * camera params up-front for the add path. For all other source types
+     * the corresponding setters are dispatched in the post-add callback
+     * (`onMediaSourceAdded` -> `_applyMediaSourceParams`).
+     */
+    private _applyCameraParamsBeforeAdd;
+    /**
+     * @private
+     * Apply capture params from TRTCMediaSource to the native plugin.
+     *
+     * This method is called after media source is added or updated. To avoid
+     * costly side-effects of native setters (e.g. setCameraCaptureParam will
+     * restart the camera), the setter is invoked only when params are actually
+     * provided AND differ from the previous value carried by `oldMediaSource`.
+     *
+     * Camera handling differs by phase:
+     *   - Add path (oldMediaSource is undefined): camera params have been set
+     *     before native addMediaSource via `_applyCameraParamsBeforeAdd`, so
+     *     this method skips kCamera to avoid duplicate setter invocation.
+     *   - Update path (oldMediaSource is provided): kCamera goes through the
+     *     same diff check as other types and is dispatched only when changed.
+     *
+     * @param mediaSource - The new media source carrying capture params.
+     * @param oldMediaSource - The previous media source (omit for the add path
+     *                         where no previous params exist; in that case the
+     *                         setter is always invoked when params are present).
+     */
+    private _applyMediaSourceParams;
+    /**
+     * @private
+     * Shallow-but-stable equality check on capture param objects via JSON.
+     *
+     * Returns true when both sides represent the "same" params, false otherwise.
+     * Semantics:
+     *   - both empty (undefined / null) → true (no change requested)
+     *   - exactly one side empty → false (first-time apply or transition)
+     *   - both non-empty → byte-equal after JSON.stringify
+     *
+     * Note: JSON.stringify is sensitive to key ordering. Capture param objects
+     * carried by `TRTCMediaSource` are constructed by the SDK via
+     * `JSON.parse(JSON.stringify(...))` flow, so key order is stable in
+     * practice; for caller-supplied literal objects with unstable key order,
+     * the comparison may yield a false-negative and trigger an unnecessary
+     * setter call.
+     */
+    private _isSameCaptureParams;
     private previewInNativeWindow;
     private previewInWebElement;
     private previewInNone;