trtc-electron-sdk 11.3.502-beta.5 → 11.3.502-beta.7

package/liteav/trtc.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
 import { VodPlayer } from './vod_player';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCAudioFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams } from './trtc_define';
 export * from './trtc_define';
 export * from './trtc_code';
 export * from './vod_player';
@@ -12,7 +12,7 @@ export * from './vod_player';
  * @example
  * // 创建/使用/销毁 TRTCCloud 对象的示例代码：
  * import TRTCCloud from 'trtc-electron-sdk';
- * this.rtcCloud = new TRTCCloud();
+ * this.rtcCloud = TRTCCloud.getTRTCShareInstance();
  * // 获取 SDK 版本号
  * let version = this.rtcCloud.getSDKVersion();
  *
@@ -66,7 +66,7 @@ declare class TRTCCloud extends EventEmitter {
      * @example
      * // Enable 'debug' mode
      * const TRTCCloud = require('trtc-electron-sdk');
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      * rtcCloud.getConfigObject().setDebugMode(true);
      *
      * @returns {TRTCConfig}
@@ -84,7 +84,7 @@ declare class TRTCCloud extends EventEmitter {
      * @example
      * // 创建/使用/销毁 TRTCCloud 对象的示例代码：
      * import TRTCCloud from 'trtc-electron-sdk';
-     * this.rtcCloud = new TRTCCloud();
+     * this.rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * // 注册回调的方法，事件关键字详见下方"通用事件回调"
      * subscribeEvents = (rtcCloud) => {
@@ -1208,6 +1208,12 @@ declare class TRTCCloud extends EventEmitter {
      * 如果录制任务在退出房间前尚未通过本接口停止，则退出房间后录音任务会自动被停止。
      */
     stopLocalRecording(): void;
+    /**
+    * 设置远端音频流智能并发播放策略
+    *
+    * @param {TRTCAudioParallelParams} - 指定用户必定能并发播放。
+    */
+    setRemoteAudioParallelParams(param: TRTCAudioParallelParams): void;
     /**
      * 开启本地音频的采集和上行
      *
@@ -1612,7 +1618,7 @@ declare class TRTCCloud extends EventEmitter {
      *  TRTCScreenCaptureProperty
      * } from 'trtc-electron-sdk';
      *
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
      *
@@ -1639,7 +1645,7 @@ declare class TRTCCloud extends EventEmitter {
      * // 示例2: 选择要分享的窗口或屏幕，9.3 及之前版本只能使用此方式
      * import TRTCCloud, { Rect } from 'trtc-electron-sdk';
      *
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
      *
@@ -1677,7 +1683,7 @@ declare class TRTCCloud extends EventEmitter {
      *  TRTCVideoResolutionMode
      * } from 'trtc-electron-sdk';
      *
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
      *
@@ -1779,6 +1785,90 @@ declare class TRTCCloud extends EventEmitter {
      * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeScreen 时生效，即分享屏幕时生效
      */
     removeAllExcludedShareWindow(): void;
+    /**
+     * 启用音频自定义采集模式
+     *
+     * 开启该模式后，SDK 不在运行原有的音频采集流程，即不再继续从麦克风采集音频数据，而是只保留音频编码和发送能力。
+     * 您需要通过 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 不断地向 SDK 塞入自己采集的音频数据。
+     *
+     * 注意：
+     *  - 音频自定义采集与 SDK 默认的麦克疯音频采集互斥。因此，调用 `enableCustomAudioCapture(true)` 开启音频自定义采集前，需要先调用 [stopLocalAudio]{@link TRTCCloud#stopLocalAudio} 接口关闭默认的麦克风音频上行，否则不生效；调用 `enableCustomAudioCapture(false)` 关闭自定义采集后，要调用 [startLocalAudio]{@link TRTCCloud#startLocalAudio} 接口才能开启 SDK 默认的麦克风音频采集。
+     *  - 由于回声抵消（AEC）需要严格的控制声音采集和播放的时间，所以开启自定义音频采集后，AEC 能力可能会失效。
+     *
+     * @param {Boolean} enable - 是否启用，默认值：false。
+     */
+    enableCustomAudioCapture(enable: boolean): void;
+    /**
+     * 向 SDK 投送自己采集的音频数据
+     *
+     * 参数 {@link TRTCAudioFrame} 推荐下列填写方式（其他字段不需要填写）：
+     * - audioFormat：音频数据格式，仅支持 TRTCAudioFrameFormatPCM。
+     * - data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持[5ms ~ 100ms]帧长，推荐使用 20ms 帧长，长度计算方法：【48000采样率、单声道的帧长度：48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
+     * - sampleRate：采样率，支持：16000、24000、32000、44100、48000。
+     * - channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+     * - timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在采集到一帧音频帧之后，通过调用 [generateCustomPTS]{@link TRTCCloud#generateCustomPTS} 获取时间戳）。
+     *
+     * 注意：请您精准地按每帧时长的间隔调用本接口，数据投送间隔不均匀时极易触发声音卡顿。
+     *
+     * @param {TRTCAudioFrame} frame - 音频数据
+     */
+    sendCustomAudioData(frame: TRTCAudioFrame): void;
+    /**
+     * 启用/关闭自定义音轨
+     *
+     * 开启后，您可以通过本接口向 SDK 混入一条自定义的音轨。通过两个布尔型参数，您可以控制该音轨是否要在远端和本地播放。
+     *
+     * 注意： 如果您指定参数 enablePublish 和 enablePlayout 均为 false，代表完全关闭您的自定义音轨。
+     * @param {Boolean} enablePublish - 控制混入的音轨是否要在远端播放，默认值：false。
+     * @param {Boolean} enablePlayout - 控制混入的音轨是否要在本地播放，默认值：false。
+     *
+     */
+    enableMixExternalAudioFrame(enablePublish: boolean, enablePlayout: boolean): void;
+    /**
+     * 向 SDK 混入自定义音轨
+     *
+     * * 调用该接口之前，您需要先通过 [enableMixExternalAudioFrame]{@link TRTCCloud#enableMixExternalAudioFrame} 开启自定义音轨，之后就可以通过本接口将自己的音轨以 PCM 格式混入到 SDK 中。
+     * 理想情况下，我们期望您的代码能够以非常均匀的速度向 SDK 提供音轨数据。但我们也非常清楚，完美的调用间隔是一个巨大的挑战。
+     * 所以 SDK 内部会开启一个音轨数据的缓冲区，该缓冲区的作用类似一个“蓄水池”，它能够暂存您传入的音轨数据，平抑由于接口调用间隔的抖动问题。
+     * 本接口的返回值代表这个音轨缓冲区的大小，单位是毫秒（ms），比如：如果该接口返回 50，则代表当前的音轨缓冲区有 50ms 的音轨数据。因此只要您在 50ms 内再次调用本接口，SDK 就能保证您混入的音轨数据是连续的。
+     * 当您调用该接口后，如果发现返回值 > 100ms，则可以等待一帧音频帧的播放时间之后再次调用；如果返回值 < 100ms，则代表缓冲区比较小，您可以再次混入一些音轨数据以确保音轨缓冲区的大小维持在“安全水位”以上。
+     * 参数 {@link TRTCAudioFrame} 推荐下列填写方式（其他字段不需要填写）：
+     * - data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持[5ms ~ 100ms]帧长，推荐使用 20ms 帧长，长度计算方法：【48000采样率、单声道的帧长度：48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
+     * - sampleRate：采样率，支持：16000、24000、32000、44100、48000。
+     * - channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+     * - timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在获得一帧音频帧之后，通过调用 [generateCustomPTS]{@link TRTCCloud#generateCustomPTS} 获得时间戳）。
+     *
+     * 注意：
+     *  - 混入自定义音轨，需要有上行音频流驱动，支持的上行音频流包括：
+     *    - SDK 默认采集的麦克风音频流，调用 [startLocalAudio]{@link TRTCCloud#startLocalAudio} 接口开启。
+     *    - 开启了自定义音频流，并有自定义音频数据上行，分别调用 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 和 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 接口。
+     *    - 开启了背景音乐，调用接口 [startPlayMusic]{@link TRTCCloud#startPlayMusic}。
+     *  - 请您精准地按每帧时长的间隔调用本接口，数据投送间隔不均匀时极易触发声音卡顿。
+     *
+     * @param {TRTCAudioFrame} frame - 音频数据
+     * @returns {Number} - 音频缓冲时长，单位：ms。< 0 错误（-1 未启用 mixExternalAudioFrame）
+     */
+    mixExternalAudioFrame(frame: TRTCAudioFrame): number;
+    /**
+     * 设置推流时混入外部音频的推流音量和播放音量
+     *
+     * @param {Number} publishVolume - 设置的推流音量大小，范围0 - 100，-1表示不改变。
+     * @param {Number} playoutVolume - 设置的播放音量大小，范围0 - 100，-1表示不改变。
+     */
+    setMixExternalAudioVolume(publishVolume: number, playoutVolume: number): void;
+    /**
+     * 生成自定义采集时的时间戳
+     *
+     * 本接口仅适用于自定义采集模式，用于解决音视频帧的采集时间（capture time）和投送时间（send time）不一致所导致的音画不同步问题。
+     * 当您通过 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 等接口进行自定义视频或音频采集时，请按照如下操作使用该接口：
+     *  1. 首先，在采集到一帧视频或音频帧时，通过调用本接口获得当时的 PTS 时间戳。
+     *  2. 之后可以将该视频或音频帧送入您使用的前处理模块（如第三方美颜组件，或第三方音效组件）。
+     *  3. 在真正调用 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 进行投送时，请将该帧在采集时记录的 PTS 时间戳赋值给 {@link TRTCVideoFrame} 或 {@link TRTCAudioFrame} 中的 timestamp 字段。
+     *
+     *
+     * @returns {Number} - 时间戳（单位：ms）
+     */
+    generateCustomPTS(): number;
     /**
      * @private
      * 设置本地视频自定义渲染（Electron 平台下不可用）
@@ -1953,7 +2043,7 @@ declare class TRTCCloud extends EventEmitter {
      * @example
      * // 音乐播放
      * import TRTCCloud, { AudioMusicParam } from 'trtc-electron-sdk';
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const params = new AudioMusicParam();
      * params.id = 1;

package/liteav/trtc.js

@@ -144,7 +144,7 @@ let oriRtcCloud = null;
  * @example
  * // 创建/使用/销毁 TRTCCloud 对象的示例代码：
  * import TRTCCloud from 'trtc-electron-sdk';
- * this.rtcCloud = new TRTCCloud();
+ * this.rtcCloud = TRTCCloud.getTRTCShareInstance();
  * // 获取 SDK 版本号
  * let version = this.rtcCloud.getSDKVersion();
  *
@@ -225,7 +225,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @example
      * // Enable 'debug' mode
      * const TRTCCloud = require('trtc-electron-sdk');
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      * rtcCloud.getConfigObject().setDebugMode(true);
      *
      * @returns {TRTCConfig}
@@ -267,7 +267,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @example
      * // 创建/使用/销毁 TRTCCloud 对象的示例代码：
      * import TRTCCloud from 'trtc-electron-sdk';
-     * this.rtcCloud = new TRTCCloud();
+     * this.rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * // 注册回调的方法，事件关键字详见下方"通用事件回调"
      * subscribeEvents = (rtcCloud) => {
@@ -2367,6 +2367,28 @@ class TRTCCloud extends events_1.EventEmitter {
     stopLocalRecording() {
         this.rtcCloud.stopLocalRecording();
     }
+    /**
+    * 设置远端音频流智能并发播放策略
+    *
+    * @param {TRTCAudioParallelParams} - 指定用户必定能并发播放。
+    */
+    setRemoteAudioParallelParams(param) {
+        if (param.maxCount < 0) {
+            throw new Error("maxCount must be greater or equal 0");
+        }
+        if (Array.isArray(param.includeUsers) && param.includeUsers.length >= 1) {
+            const includeUsersFilterArray = param.includeUsers.filter(item => {
+                return typeof item === 'string';
+            });
+            this.rtcCloud.setRemoteAudioParallelParams({
+                maxCount: param.maxCount,
+                includeUsers: includeUsersFilterArray
+            });
+        }
+        else {
+            throw new Error('includeUsers must be Array<String> type and not empty');
+        }
+    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （四）音频相关接口函数
@@ -2922,7 +2944,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *  TRTCScreenCaptureProperty
      * } from 'trtc-electron-sdk';
      *
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
      *
@@ -2949,7 +2971,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * // 示例2: 选择要分享的窗口或屏幕，9.3 及之前版本只能使用此方式
      * import TRTCCloud, { Rect } from 'trtc-electron-sdk';
      *
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
      *
@@ -3005,7 +3027,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *  TRTCVideoResolutionMode
      * } from 'trtc-electron-sdk';
      *
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
      *
@@ -3172,11 +3194,102 @@ class TRTCCloud extends events_1.EventEmitter {
     //                      （九）自定义采集和渲染
     //
     /////////////////////////////////////////////////////////////////////////////////
-    //TODO:暂时未完成
-    // | [enableCustomVideoCapture] | 启用视频自定义采集模式 |
-    // | [sendCustomVideoData] | 向 SDK 投送自己采集的视频数据 |
-    // | [enableCustomAudioCapture] | 向 SDK 投送自己采集的音频数据 |
-    // | [setAudioFrameCallback] | 设置音频数据回调 |
+    /**
+     * 启用音频自定义采集模式
+     *
+     * 开启该模式后，SDK 不在运行原有的音频采集流程，即不再继续从麦克风采集音频数据，而是只保留音频编码和发送能力。
+     * 您需要通过 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 不断地向 SDK 塞入自己采集的音频数据。
+     *
+     * 注意：
+     *  - 音频自定义采集与 SDK 默认的麦克疯音频采集互斥。因此，调用 `enableCustomAudioCapture(true)` 开启音频自定义采集前，需要先调用 [stopLocalAudio]{@link TRTCCloud#stopLocalAudio} 接口关闭默认的麦克风音频上行，否则不生效；调用 `enableCustomAudioCapture(false)` 关闭自定义采集后，要调用 [startLocalAudio]{@link TRTCCloud#startLocalAudio} 接口才能开启 SDK 默认的麦克风音频采集。
+     *  - 由于回声抵消（AEC）需要严格的控制声音采集和播放的时间，所以开启自定义音频采集后，AEC 能力可能会失效。
+     *
+     * @param {Boolean} enable - 是否启用，默认值：false。
+     */
+    enableCustomAudioCapture(enable) {
+        this.rtcCloud.enableCustomAudioCapture(enable);
+    }
+    /**
+     * 向 SDK 投送自己采集的音频数据
+     *
+     * 参数 {@link TRTCAudioFrame} 推荐下列填写方式（其他字段不需要填写）：
+     * - audioFormat：音频数据格式，仅支持 TRTCAudioFrameFormatPCM。
+     * - data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持[5ms ~ 100ms]帧长，推荐使用 20ms 帧长，长度计算方法：【48000采样率、单声道的帧长度：48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
+     * - sampleRate：采样率，支持：16000、24000、32000、44100、48000。
+     * - channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+     * - timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在采集到一帧音频帧之后，通过调用 [generateCustomPTS]{@link TRTCCloud#generateCustomPTS} 获取时间戳）。
+     *
+     * 注意：请您精准地按每帧时长的间隔调用本接口，数据投送间隔不均匀时极易触发声音卡顿。
+     *
+     * @param {TRTCAudioFrame} frame - 音频数据
+     */
+    sendCustomAudioData(frame) {
+        this.rtcCloud.sendCustomAudioData(frame);
+    }
+    /**
+     * 启用/关闭自定义音轨
+     *
+     * 开启后，您可以通过本接口向 SDK 混入一条自定义的音轨。通过两个布尔型参数，您可以控制该音轨是否要在远端和本地播放。
+     *
+     * 注意： 如果您指定参数 enablePublish 和 enablePlayout 均为 false，代表完全关闭您的自定义音轨。
+     * @param {Boolean} enablePublish - 控制混入的音轨是否要在远端播放，默认值：false。
+     * @param {Boolean} enablePlayout - 控制混入的音轨是否要在本地播放，默认值：false。
+     *
+     */
+    enableMixExternalAudioFrame(enablePublish, enablePlayout) {
+        this.rtcCloud.enableMixExternalAudioFrame(enablePublish, enablePlayout);
+    }
+    /**
+     * 向 SDK 混入自定义音轨
+     *
+     * * 调用该接口之前，您需要先通过 [enableMixExternalAudioFrame]{@link TRTCCloud#enableMixExternalAudioFrame} 开启自定义音轨，之后就可以通过本接口将自己的音轨以 PCM 格式混入到 SDK 中。
+     * 理想情况下，我们期望您的代码能够以非常均匀的速度向 SDK 提供音轨数据。但我们也非常清楚，完美的调用间隔是一个巨大的挑战。
+     * 所以 SDK 内部会开启一个音轨数据的缓冲区，该缓冲区的作用类似一个“蓄水池”，它能够暂存您传入的音轨数据，平抑由于接口调用间隔的抖动问题。
+     * 本接口的返回值代表这个音轨缓冲区的大小，单位是毫秒（ms），比如：如果该接口返回 50，则代表当前的音轨缓冲区有 50ms 的音轨数据。因此只要您在 50ms 内再次调用本接口，SDK 就能保证您混入的音轨数据是连续的。
+     * 当您调用该接口后，如果发现返回值 > 100ms，则可以等待一帧音频帧的播放时间之后再次调用；如果返回值 < 100ms，则代表缓冲区比较小，您可以再次混入一些音轨数据以确保音轨缓冲区的大小维持在“安全水位”以上。
+     * 参数 {@link TRTCAudioFrame} 推荐下列填写方式（其他字段不需要填写）：
+     * - data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持[5ms ~ 100ms]帧长，推荐使用 20ms 帧长，长度计算方法：【48000采样率、单声道的帧长度：48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
+     * - sampleRate：采样率，支持：16000、24000、32000、44100、48000。
+     * - channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+     * - timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在获得一帧音频帧之后，通过调用 [generateCustomPTS]{@link TRTCCloud#generateCustomPTS} 获得时间戳）。
+     *
+     * 注意：
+     *  - 混入自定义音轨，需要有上行音频流驱动，支持的上行音频流包括：
+     *    - SDK 默认采集的麦克风音频流，调用 [startLocalAudio]{@link TRTCCloud#startLocalAudio} 接口开启。
+     *    - 开启了自定义音频流，并有自定义音频数据上行，分别调用 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 和 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 接口。
+     *    - 开启了背景音乐，调用接口 [startPlayMusic]{@link TRTCCloud#startPlayMusic}。
+     *  - 请您精准地按每帧时长的间隔调用本接口，数据投送间隔不均匀时极易触发声音卡顿。
+     *
+     * @param {TRTCAudioFrame} frame - 音频数据
+     * @returns {Number} - 音频缓冲时长，单位：ms。< 0 错误（-1 未启用 mixExternalAudioFrame）
+     */
+    mixExternalAudioFrame(frame) {
+        return this.rtcCloud.mixExternalAudioFrame(frame);
+    }
+    /**
+     * 设置推流时混入外部音频的推流音量和播放音量
+     *
+     * @param {Number} publishVolume - 设置的推流音量大小，范围0 - 100，-1表示不改变。
+     * @param {Number} playoutVolume - 设置的播放音量大小，范围0 - 100，-1表示不改变。
+     */
+    setMixExternalAudioVolume(publishVolume, playoutVolume) {
+        this.rtcCloud.setMixExternalAudioVolume(publishVolume, playoutVolume);
+    }
+    /**
+     * 生成自定义采集时的时间戳
+     *
+     * 本接口仅适用于自定义采集模式，用于解决音视频帧的采集时间（capture time）和投送时间（send time）不一致所导致的音画不同步问题。
+     * 当您通过 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 等接口进行自定义视频或音频采集时，请按照如下操作使用该接口：
+     *  1. 首先，在采集到一帧视频或音频帧时，通过调用本接口获得当时的 PTS 时间戳。
+     *  2. 之后可以将该视频或音频帧送入您使用的前处理模块（如第三方美颜组件，或第三方音效组件）。
+     *  3. 在真正调用 [sendCustomAudioData]{@link TRTCCloud#sendCustomAudioData} 进行投送时，请将该帧在采集时记录的 PTS 时间戳赋值给 {@link TRTCVideoFrame} 或 {@link TRTCAudioFrame} 中的 timestamp 字段。
+     *
+     *
+     * @returns {Number} - 时间戳（单位：ms）
+     */
+    generateCustomPTS() {
+        return this.rtcCloud.generateCustomPTS();
+    }
     /**
      * @private
      * 设置本地视频自定义渲染（Electron 平台下不可用）
@@ -3433,7 +3546,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @example
      * // 音乐播放
      * import TRTCCloud, { AudioMusicParam } from 'trtc-electron-sdk';
-     * const rtcCloud = new TRTCCloud();
+     * const rtcCloud = TRTCCloud.getTRTCShareInstance();
      *
      * const params = new AudioMusicParam();
      * params.id = 1;

package/liteav/trtc_define.d.ts

@@ -84,6 +84,12 @@ export declare enum TRTCRecordType {
     /** 同时录制音频、视频 */
     TRTCRecordTypeBoth = 2
 }
+export type TRTCAudioParallelParams = {
+    /** 最大并发播放数。默认值：0 */
+    maxCount: number;
+    /** 指定用户必定能并发播放 */
+    includeUsers: Array<string>;
+};
 export declare enum TRTCAppScene {
     TRTCAppSceneVideoCall = 0,
     TRTCAppSceneLIVE = 1,
@@ -226,6 +232,29 @@ export declare class TRTCVideoFrame {
     rotation: number;
     constructor(videoFormat?: TRTCVideoPixelFormat, bufferType?: TRTCVideoBufferType, data?: null | ArrayBuffer, textureId?: number, length?: number, width?: number, height?: number, timestamp?: number, rotation?: number);
 }
+/**
+ * 音频帧数据
+ *
+ * @param {TRTCAudioFrameFormat} audioFormat - 音频帧的格式
+ * @param {ArrayBuffer} data - 音频数据
+ * @param {Number} length - 音频数据的长度
+ * @param {Number} sampleRate - 采样率
+ * @param {Number} channel - 声道数
+ * @param {Number} timestamp - 时间戳，单位ms
+ * @param {ArrayBuffer|null} extraData - 音频额外数据，远端用户通过 `onLocalProcessedAudioFrame` 写入的数据会通过该字段回调
+ * @param {Number} extraDataLength - 音频消息数据的长度
+ */
+export declare class TRTCAudioFrame {
+    audioFormat: TRTCAudioFrameFormat;
+    data: ArrayBuffer | null;
+    length: number;
+    sampleRate: number;
+    channel: number;
+    timestamp: number;
+    extraData: ArrayBuffer | null;
+    extraDataLength: number;
+    constructor(audioFormat?: TRTCAudioFrameFormat, data?: any, length?: number, sampleRate?: number, channel?: number, timestamp?: number, extraData?: any, extraDataLength?: number);
+}
 export declare enum TRTCLogLevel {
     TRTCLogLevelNone = 0,
     TRTCLogLevelVerbose = 1,

package/liteav/trtc_define.js

@@ -6,8 +6,8 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCAudioRecordingContent = exports.TRTCMixInputType = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCSpeedTestParams = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCCameraCaptureMode = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureProperty = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCRecordType = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
-exports.VideoBufferInfo = void 0;
+exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCAudioRecordingContent = exports.TRTCMixInputType = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCSpeedTestParams = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCCameraCaptureMode = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCAudioFrame = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureProperty = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCRecordType = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
+exports.VideoBufferInfo = exports.TRTCSwitchRoomParam = void 0;
 const util_1 = require("./Renderer/util");
 /////////////////////////////////////////////////////////////////////////////////
 //
@@ -338,6 +338,15 @@ var TRTCRecordType;
     /** 同时录制音频、视频 */
     TRTCRecordType[TRTCRecordType["TRTCRecordTypeBoth"] = 2] = "TRTCRecordTypeBoth";
 })(TRTCRecordType = exports.TRTCRecordType || (exports.TRTCRecordType = {}));
+/**
+* 设置远端音频流智能并发播放策略
+*
+* @typedef {Object} TRTCAudioParallelParam
+* @property {Number} maxCount - 最大并发播放数
+* @property {Array<String>} includeUsers - 指定用户必定能并发播放
+*
+*/
+const TRTCAudioParallelParams_HACK_JSDOC = null;
 /////////////////////////////////////////////////////////////////////////////////
 //
 //                    【（二）网络相关枚举值定义】
@@ -648,6 +657,32 @@ class TRTCVideoFrame {
 }
 exports.TRTCVideoFrame = TRTCVideoFrame;
 ;
+/**
+ * 音频帧数据
+ *
+ * @param {TRTCAudioFrameFormat} audioFormat - 音频帧的格式
+ * @param {ArrayBuffer} data - 音频数据
+ * @param {Number} length - 音频数据的长度
+ * @param {Number} sampleRate - 采样率
+ * @param {Number} channel - 声道数
+ * @param {Number} timestamp - 时间戳，单位ms
+ * @param {ArrayBuffer|null} extraData - 音频额外数据，远端用户通过 `onLocalProcessedAudioFrame` 写入的数据会通过该字段回调
+ * @param {Number} extraDataLength - 音频消息数据的长度
+ */
+class TRTCAudioFrame {
+    constructor(audioFormat = TRTCAudioFrameFormat.TRTCAudioFrameFormatNone, data = null, length = 0, sampleRate = 48000, channel = 1, timestamp = 0, extraData = null, extraDataLength = 0) {
+        this.audioFormat = audioFormat;
+        this.data = data;
+        this.length = length;
+        this.sampleRate = sampleRate;
+        this.channel = channel;
+        this.timestamp = timestamp;
+        this.extraData = extraData;
+        this.extraDataLength = extraDataLength;
+    }
+}
+exports.TRTCAudioFrame = TRTCAudioFrame;
+;
 /////////////////////////////////////////////////////////////////////////////////
 //
 //                    【（四）更多枚举值定义】

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "11.3.502-beta.5",
+  "version": "11.3.502-beta.7",
   "description": "trtc electron sdk",
   "main": "./liteav/trtc.js",
   "types": "./liteav/trtc.d.ts",
@@ -18,6 +18,9 @@
     "yuv-canvas": "^1.2.6",
     "hpagent": "^1.2.0"
   },
+  "peerDependencies": {
+    "electron": ">=4.0.0"
+  },
   "devDependencies": {
     "@babel/cli": "^7.11.6",
     "@babel/core": "^7.11.6",
@@ -37,6 +40,7 @@
   "scripts": {
     "download": "node ./scripts/download.js",
     "install": "npm run download",
+    "postinstall": "node ./scripts/postinstall.js",
     "build": "npm run build:types && npm run build:js && npm run copy:types",
     "build:types": "rimraf ./types && tsc -p dtsconfig.json",
     "build:js": "rimraf ./liteav && tsc -p tsconfig.json",

package/scripts/download.js

@@ -142,9 +142,6 @@ const main = () => {
                         );
                         signale.success(`copy success! - mac ${anotherArch}`);
 
-                        // Mac 下完成文件下载后，执行该命令，同步文件到 Electron 目录下
-                        exec(`rsync -a ../../node_modules/trtc-electron-sdk/build/mac-framework/${archType}/ ../../node_modules/electron/dist/Electron.app/Contents/Frameworks`);
-
                         rimraf.sync(outputDir);
                     })
                     .catch(err => {

package/scripts/postinstall.js

@@ -0,0 +1,46 @@
+const { exec } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const { arch, platform } = process;
+
+let retryCount = 0;
+const retryInterval = 5000; // ms
+const maxRetryCount = 60;
+
+function rsync() {
+  if (platform === 'darwin') {
+    const sourcePath = path.join(__dirname, `../../trtc-electron-sdk/build/mac-framework/${arch}/`);
+    const targetPath = path.join(__dirname, '../../electron/dist/Electron.app/Contents/Frameworks');
+
+    if (targetPath.indexOf("node_modules") === -1) {
+      // SDK 本身安装，不用同步动态库，直接退出
+      console.warn(`trtc-electron-sdk self install do not need 'rsync'`);
+      return;
+    }
+
+    retryCount++;
+    if (fs.existsSync(targetPath)) {
+      const command = `rsync -a ${sourcePath} ${targetPath}`;
+      console.log(command);
+      exec(command);
+    } else {
+      if (retryCount <= maxRetryCount) {
+        setTimeout(rsync, retryInterval);
+      } else {
+        const errorMessage = `
+        'trtc-electron-sdk' 安装失败，请先确认 'Electron' 已安装，再执行 'npm install trtc-electron-sdk' 命令重新安装一次。
+        Failed to install trtc-electron-sdk correctly, please make sure that 'Electron' has been installed, then run 'npm install trtc-electron-sdk' command to try again.
+
+        more detail:
+        trtc-electron-sdk postinstall cwd: ${process.cwd()} 
+        __dirname: ${__dirname}
+        sourcePath: ${sourcePath}
+        targetPath: ${targetPath}
+        `;
+        console.error(errorMessage);
+      }
+    } 
+  }
+}
+
+rsync();