trtc-electron-sdk 9.3.111-beta.0 → 9.3.201

package/liteav/trtc.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo, TRTCSpeedTestParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCAudioRecordingParams } from './trtc_define';
 export * from './trtc_define';
 export * from './trtc_code';
 /**
@@ -16,7 +16,6 @@ export * from './trtc_code';
  *
  */
 declare class TRTCCloud extends EventEmitter {
-    private rtcCloud;
     private streams;
     private firstVideoFrameList;
     private playStreamType;
@@ -39,7 +38,7 @@ declare class TRTCCloud extends EventEmitter {
     private audioQuality;
     private bgmId;
     private playAudioEffectIdList;
-    private isStartLocalPreview;
+    private isLocalPreviewStarted;
     constructor();
     /**
      * 创建 TRTCCloud 对象单例
@@ -85,7 +84,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码
      * @param {String} errMsg  - 错误信息
      */
-    handleOnError(errCode: number, errMsg: string): void;
+    bindOnError(): void;
     /**
      * 1.2 警告回调：用于告知您一些非严重性问题，例如出现了卡顿或者可恢复的解码失败。
      *
@@ -93,7 +92,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} warningCode - 警告码
      * @param {String} warningMsg  - 警告信息
      */
-    handleOnWarning(warningCode: number, warningMsg: string): void;
+    bindOnWarning(): void;
     /**
      * 2.1 已加入房间的回调
      *
@@ -109,7 +108,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onEnterRoom
      * @param {Number} result - result > 0 时为进房耗时（ms），result < 0 时为进房错误码。
      */
-    handleOnEnterRoom(result: number): void;
+    bindOnEnterRoom(): void;
     /**
      * 2.2 退出房间的事件回调
      *
@@ -122,7 +121,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onExitRoom
      * @param {Number} reason - 离开房间原因，0：主动调用 exitRoom 退房；1：被服务器踢出当前房间；2：当前房间整个被解散。
      */
-    handleOnExitRoom(reason: number): void;
+    bindOnExitRoom(): void;
     /**
      * 2.3 切换房间的事件回调
      *
@@ -130,7 +129,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。
      * @param {String} errMsg  - 错误信息。
      */
-    handleOnSwitchRoom(errCode: number, errMsg: string): void;
+    bindOnSwitchRoom(): void;
     /**
      * 2.4 切换角色的事件回调
      *
@@ -141,7 +140,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。
      * @param {String} errMsg  - 错误信息。
      */
-    handleOnSwitchRole(errCode: number, errMsg: string): void;
+    bindOnSwitchRole(): void;
     /**
      * 2.5 请求跨房连麦（主播跨房 PK）的结果回调
      *
@@ -154,7 +153,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。
      * @param {String} errMsg  - 错误信息。
      */
-    handleOnConnectOtherRoom(userId: string, errCode: number, errMsg: string): void;
+    bindOnConnectOtherRoom(): void;
     /**
      * 2.6 关闭跨房连麦（主播跨房 PK）的结果回调
      *
@@ -162,7 +161,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码，ERR_NULL 代表切换成功，其他请参见 [错误码](https://cloud.tencent.com/document/product/647/32257)。
      * @param {String} errMsg  - 错误信息。
      */
-    handleOnDisconnectOtherRoom(errCode: number, errMsg: string): void;
+    bindOnDisconnectOtherRoom(): void;
     /**
      * 3.1 有用户加入当前房间
      *
@@ -175,7 +174,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onRemoteUserEnterRoom
      * @param {String} userId - 用户标识
      */
-    handleOnRemoteUserEnterRoom(userId: string): void;
+    bindOnRemoteUserEnterRoom(): void;
     /**
      * 3.2 有用户离开当前房间
      *
@@ -187,7 +186,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {String} userId - 用户标识
      * @param {Number} reason - 离开原因，0表示用户主动退出房间，1表示用户超时退出，2表示被踢出房间。
      */
-    handleOnRemoteUserLeaveRoom(userId: string, reason: number): void;
+    bindOnRemoteUserLeaveRoom(): void;
     /**
      * 3.3 用户是否开启摄像头视频
      *
@@ -202,7 +201,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {String}  userId    - 用户标识
      * @param {Number} available - 画面是否开启
      */
-    handleOnUserVideoAvailable(userId: string, available: number): void;
+    bindOnUserVideoAvailable(): void;
     /**
      * 3.4 用户是否开启了辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）
      *
@@ -212,7 +211,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {String}  userId    - 用户标识
      * @param {Number} available - 辅路画面是否开启
      */
-    handleOnUserSubStreamAvailable(userId: string, available: number): void;
+    bindOnUserSubStreamAvailable(): void;
     /**
      * 3.5 用户是否开启音频上行
      *
@@ -220,7 +219,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {String}  userId    - 用户标识
      * @param {Number} available - 声音是否开启
      */
-    handleOnUserAudioAvailable(userId: string, available: number): void;
+    bindOnUserAudioAvailable(): void;
     /**
      * 3.6 开始渲染本地或远程用户的首帧画面
      *
@@ -235,14 +234,14 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} width      - 画面宽度
      * @param {Number} height     - 画面高度
      */
-    handleOnFirstVideoFrame(userId: string, streamType: number, width: number, height: number): void;
+    bindOnFirstVideoFrame(): void;
     /**
      * 3.7 开始播放远程用户的首帧音频（本地声音暂不通知）
      *
      * @event TRTCCallback#onFirstAudioFrame
      * @param {String} userId - 远程用户 ID。
      */
-    handleOnFirstAudioFrame(userId: string): void;
+    bindOnFirstAudioFrame(): void;
     /**
      * 3.8 首帧本地视频数据已经被送出
      *
@@ -252,7 +251,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onSendFirstLocalVideoFrame
      * @param {Number} streamType - - 视频流类型，TRTCVideoStreamTypeBig：主路画面，一般用于摄像头；TRTCVideoStreamTypeSub：辅路画面，一般用于屏幕分享。
      */
-    handleOnSendFirstLocalVideoFrame(streamType: number): void;
+    bindOnSendFirstLocalVideoFrame(): void;
     /**
      * 3.9 首帧本地音频数据已经被送出
      *
@@ -261,7 +260,7 @@ declare class TRTCCloud extends EventEmitter {
      *
      * @event TRTCCallback#onSendFirstLocalAudioFrame
      */
-    handleOnSendFirstLocalAudioFrame(): void;
+    bindOnSendFirstLocalAudioFrame(): void;
     /**
      * 3.10 废弃事件：有主播加入当前房间
      *
@@ -271,7 +270,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onUserEnter
      * @param {String} userId - 用户标识
      */
-    handleOnUserEnter(userId: string): void;
+    bindOnUserEnter(): void;
     /**
      * 3.11 废弃事件：有主播离开当前房间
      *
@@ -282,7 +281,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {String} userId - 用户标识
      * @param {Number} reason - 离开原因代码，区分用户是正常离开，还是由于网络断线等原因离开。
      */
-    handleOnUserExit(userId: string, reason: number): void;
+    bindOnUserExit(): void;
     /**
      * 4.1 网络质量：该回调每2秒触发一次，统计当前网络的上行和下行质量
      *
@@ -310,21 +309,23 @@ declare class TRTCCloud extends EventEmitter {
      *
      * @event TRTCCallback#onConnectionLost
      */
-    handleOnConnectionLost(): void;
+    bindOnConnectionLost(): void;
     /**
      * 5.2 SDK 尝试重新连接到服务器
      *
      * @event TRTCCallback#onTryToReconnect
      */
-    handleOnTryToReconnect(): void;
+    bindOnTryToReconnect(): void;
     /**
      * 5.3 SDK 跟服务器的连接恢复
      *
      * @event TRTCCallback#onConnectionRecovery
      */
-    handleOnConnectionRecovery(): void;
+    bindOnConnectionRecovery(): void;
     /**
-     * 5.4 服务器测速的回调，SDK 对多个服务器 IP 做测速，每个 IP 的测速结果通过这个回调通知
+     * 5.4 废弃事件： 服务器测速的回调，SDK 对多个服务器 IP 做测速，每个 IP 的测速结果通过这个回调通知
+     *
+     * @deprecated 从 TRTCSDK 9.3 后该接口已被废弃，不会抛出该事件, 请采用 onSpeedTestResult 事件代替
      *
      * @event TRTCCallback#onSpeedTest
      * @param {TRTCSpeedTestResult} currentResult - 当前完成的测速结果
@@ -332,18 +333,27 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} totalCount    - 需要测速的服务器总数量
      */
     bindOnSpeedTest(): void;
+    /**
+     * 5.5 网速测试的结果回调
+     *
+     * 该统计回调由 startSpeedTest 触发。
+     *
+     * @event TRTCCallback#onSpeedTestResult
+     * @param {TRTCSpeedTestResult} result 网速测试数据数据，包括丢包、往返延迟、上下行的带宽速率。
+     */
+    bindOnSpeedTestResult(): void;
     /**
      * 6.1 摄像头准备就绪
      *
      * @event TRTCCallback#onCameraDidReady
      */
-    handleOnCameraDidReady(): void;
+    bindOnCameraDidReady(): void;
     /**
      * 6.2 麦克风准备就绪
      *
      * @event TRTCCallback#onMicDidReady
      */
-    handleOnMicDidReady(): void;
+    bindOnMicDidReady(): void;
     /**
      * 6.3 userId 对应的成员语音音量
      *
@@ -365,7 +375,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {TRTCDeviceType} type     - 设备类型
      * @param {TRTCDeviceState} state    - 事件类型
      */
-    handleOnDeviceChange(deviceId: string, type: TRTCDeviceType, state: TRTCDeviceState): void;
+    bindOnDeviceChange(): void;
     /**
      * 6.5 麦克风测试音量回调
      *
@@ -374,7 +384,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onTestMicVolume
      * @param {Number} volume - 音量值，取值范围0 - 100
      */
-    handleOnTestMicVolume(volume: number): void;
+    bindOnTestMicVolume(): void;
     /**
      * 6.6 扬声器测试音量回调
      *
@@ -383,7 +393,7 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onTestSpeakerVolume
      * @param {Number} volume - 音量值，取值范围0 - 100
      */
-    handleOnTestSpeakerVolume(volume: number): void;
+    bindOnTestSpeakerVolume(): void;
     /**
      * 6.7 当前音频采集设备音量变化回调
      *
@@ -393,7 +403,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} volume - 音量值，取值范围0 - 100
      * @param {Boolean} muted - 当前采集音频设备是否被静音
      */
-    handleOnAudioDeviceCaptureVolumeChanged(volume: number, muted: number): void;
+    bindOnAudioDeviceCaptureVolumeChanged(): void;
     /**
      * 6.8 当前音频播放设备音量变化回调
      *
@@ -403,7 +413,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} volume - 音量值，取值范围0 - 100
      * @param {Boolean} muted - 当前音频播放设备是否被静音
      */
-    handleOnAudioDevicePlayoutVolumeChanged(volume: number, muted: number): void;
+    bindOnAudioDevicePlayoutVolumeChanged(): void;
     /**
      * 7.1 收到自定义消息回调
      *
@@ -448,7 +458,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 0表示成功，其余值表示失败
      * @param {String} errMsg  - 具体错误原因
      */
-    handleOnStartPublishing(errCode: number, errMsg: string): void;
+    bindOnStartPublishing(): void;
     /**
      * 8.2 停止向腾讯云的直播 CDN 推流的回调，对应于 TRTCCloud 中的 [stopPublishing()]{@link TRTCCloud#stopPublishing} 接口
      *
@@ -456,7 +466,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 0表示成功，其余值表示失败
      * @param {String} errMsg  - 具体错误原因
      */
-    handleOnStopPublishing(errCode: number, errMsg: string): void;
+    bindOnStopPublishing(): void;
     /**
      * 8.3 旁路推流到 CDN 的回调
      *
@@ -468,7 +478,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码
      * @param {String} errMsg  - 错误详细信息
      */
-    handleOnStartPublishCDNStream(errCode: number, errMsg: string): void;
+    bindOnStartPublishCDNStream(): void;
     /**
      * 8.4 停止旁路推流到 CDN 的回调
      *
@@ -478,7 +488,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码
      * @param {String} errMsg  - 错误详细信息
      */
-    handleOnStopPublishCDNStream(errCode: number, errMsg: string): void;
+    bindOnStopPublishCDNStream(): void;
     /**
      * 8.5 设置云端的混流转码参数的回调
      *
@@ -488,7 +498,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} errCode - 错误码
      * @param {String} errMsg  - 错误详细信息
      */
-    handleOnSetMixTranscodingConfig(errCode: number, errMsg: string): void;
+    bindOnSetMixTranscodingConfig(): void;
     /**
      * 9.1 废弃事件： 播放音效结束回调
      *
@@ -498,40 +508,40 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} effectId - 音效 ID
      * @param {Number} code     - 0表示播放正常结束；其他表示异常结束
      */
-    handleOnAudioEffectFinished(effectId: number, code: number): void;
+    bindOnAudioEffectFinished(): void;
     /**
      * 10.1 当屏幕分享窗口被遮挡无法正常捕获时，SDK 会通过此回调通知，可在此回调里通知用户移开遮挡窗口
      *
      * @event TRTCCallback#onScreenCaptureCovered
      */
-    handleOnScreenCaptureCovered(): void;
+    bindOnScreenCaptureCovered(): void;
     /**
      * 10.2 当屏幕分享开始时，SDK 会通过此回调通知
      *
      * @event TRTCCallback#onScreenCaptureStarted
      */
-    handleOnScreenCaptureStarted(): void;
+    bindOnScreenCaptureStarted(): void;
     /**
      * 10.3 当屏幕分享暂停时，SDK 会通过此回调通知
      *
      * @event TRTCCallback#onScreenCapturePaused
      * @param {Number} reason - 停止原因，0：表示用户主动暂停；1：表示设置屏幕分享参数导致的暂停；2：表示屏幕分享窗口被最小化导致的暂停；3：表示屏幕分享窗口被隐藏导致的暂停
      */
-    handleOnScreenCapturePaused(reason: number): void;
+    bindOnScreenCapturePaused(): void;
     /**
      * 10.4 当屏幕分享恢复时，SDK 会通过此回调通知
      *
      * @event TRTCCallback#onScreenCaptureResumed
      * @param {Number} reason - 停止原因，0：表示用户主动恢复，1：表示屏幕分享参数设置完毕后自动恢复；2：表示屏幕分享窗口从最小化被恢复；3：表示屏幕分享窗口从隐藏被恢复
      */
-    handleOnScreenCaptureResumed(reason: number): void;
+    bindOnScreenCaptureResumed(): void;
     /**
      * 10.5 当屏幕分享停止时，SDK 会通过此回调通知
      *
      * @event TRTCCallback#onScreenCaptureStopped
      * @param {Number} reason - 停止原因，0：表示用户主动停止；1：表示屏幕分享窗口被关闭
      */
-    handleOnScreenCaptureStopped(reason: number): void;
+    bindOnScreenCaptureStopped(): void;
     /**
      * 11.1 截图完成时回调
      *
@@ -543,7 +553,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} width  - 截图画面的宽度
      * @param {Number} height - 截图画面的高度
      */
-    handleOnSnapshotComplete(userId: string, type: TRTCVideoStreamType, buffer: ArrayBuffer, width: number, height: number): void;
+    bindOnSnapshotComplete(): void;
     /**
      * 12.1 废弃事件： 开始播放背景音乐
      *
@@ -552,7 +562,8 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onPlayBGMBegin
      * @param {Number} errCode - 错误码
      */
-    handleOnPlayBGMBegin(errCode: number): void;
+    bindOnPlayBGMBegin(): void;
+    bindOnMusicStart(): void;
     /**
      * 12.2 废弃事件： 播放背景音乐的进度
      *
@@ -562,7 +573,8 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} progressMS - 已播放时间
      * @param {Number} durationMS - 总时间
      */
-    handleOnPlayBGMProgress(progressMS: number, durationMS: number): void;
+    bindOnPlayBGMProgress(): void;
+    bindOnMusicPlayProgress(): void;
     /**
      * 12.3 废弃事件： 播放背景音乐结束
      *
@@ -571,7 +583,8 @@ declare class TRTCCloud extends EventEmitter {
      * @event TRTCCallback#onPlayBGMComplete
      * @param {Number} errCode - 错误码
      */
-    handleOnPlayBGMComplete(errCode: number): void;
+    bindOnPlayBGMComplete(): void;
+    bindOnMusicComplete(): void;
     /**
      * 13.1 系统音频采集回调
      *
@@ -583,7 +596,7 @@ declare class TRTCCloud extends EventEmitter {
      * - ERR_AUDIO_PLUGIN_INSTALL_NOT_AUTHORIZED (-1331) ：未授权安装音频驱动插件
      * - ERR_AUDIO_PLUGIN_INSTALL_FAILED (-1332) ：安装音频驱动插件失败
      */
-    handleOnSystemAudioLoopbackError(errCode: number): void;
+    bindOnSystemAudioLoopbackError(): void;
     /**
      * 1.1 进入房间
      *
@@ -794,6 +807,8 @@ declare class TRTCCloud extends EventEmitter {
      *
      * 参考文档：[云端混流转码](https://cloud.tencent.com/document/product/647/16827)。
      *
+     * 注意：混流转码为收费功能，调用接口将产生云端混流转码费用，详见 [云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。
+     *
      * @note 关于云端混流的注意事项：
      *  - 云端转码会引入一定的 CDN 观看延时，大概会增加1 - 2秒。
      *  - 调用该函数的用户，会将连麦中的多路画面混合到自己当前这路画面中。
@@ -840,12 +855,19 @@ declare class TRTCCloud extends EventEmitter {
      */
     stopLocalPreview(): void;
     /**
-     * 3.3 是否屏蔽自己的视频画面
+     * 3.3 暂停/恢复发布本地的视频流
      *
-     * 当屏蔽本地视频后，房间里的其它成员将会收到 onUserVideoAvailable 回调通知
-     * @param {Boolean} mute - true：屏蔽；false：开启，默认值：false
+     * 该接口可以暂停（或恢复）发布本地的视频画面，暂停之后，同一房间中的其他用户将无法继续看到自己画面。
+     * 该接口在指定 TRTCVideoStreamTypeBig 时等效于 start/stopLocalPreview 这两个接口，但具有更好的响应速度。
+     * 因为 start/stopLocalPreview 需要打开和关闭摄像头，而打开和关闭摄像头都是硬件设备相关的操作，非常耗时。
+     * 相比之下，muteLocalVideo 只需要在软件层面对数据流进行暂停或者放行即可，因此效率更高，也更适合需要频繁打开关闭的场景。
+     * 当暂停/恢复发布指定 TRTCVideoStreamTypeBig 后，同一房间中的其他用户将会收到 onUserVideoAvailable 回调通知。
+     * 当暂停/恢复发布指定 TRTCVideoStreamTypeSub 后，同一房间中的其他用户将会收到 onUserSubStreamAvailable 回调通知。
+     *
+     * @param {Boolean}             mute        - true：屏蔽；false：开启，默认值：false
+     * @param {TRTCVideoStreamType} streamType  - 要暂停/恢复的视频流类型, 仅支持 TRTCVideoStreamTypeBig 和 TRTCVideoStreamTypeSub
      */
-    muteLocalVideo(mute: boolean): void;
+    muteLocalVideo(mute: boolean, streamType?: TRTCVideoStreamType): void;
     /**
      * 3.4 开始显示远端视频画面
      *
@@ -881,8 +903,9 @@ declare class TRTCCloud extends EventEmitter {
      *
      * @param {String}  userId - 对方的用户标识
      * @param {Boolean} mute   - 是否停止接收
+     * @param {TRTCVideoStreamType} streamType   - 视频流类型
      */
-    muteRemoteVideoStream(userId: string, mute: boolean): void;
+    muteRemoteVideoStream(userId: string, mute: boolean, streamType?: TRTCVideoStreamType): void;
     /**
      * 3.8 停止接收所有远端视频流
      *
@@ -1161,10 +1184,15 @@ declare class TRTCCloud extends EventEmitter {
      * 注意：录音文件路径需精确到文件名及格式后缀，格式后缀决定录制文件的格式。
      * 例如：指定路径为 path/to/audio.aac，则会生成一个 AAC 格式的文件。目前支持的格式有 PCM, WAV, AAC
      *
-     * @param {String} path - 录音文件路径（必填），录音文件的保存路径，该路径需要用户自行指定，请确保路径存在且可写。
+     * @params {TRTCAudioRecordingParams} params                            - 录音参数。
+     * @params {String} params.filePath                                     - 文件路径（必填），录音文件的保存路径。该路径需要用户自行指定，请确保路径存在且可写
+     * @params {TRTCAudioRecordingContent} params.recordingContent          - 音频录制内容类型
      * @return {Number} 0：成功；-1：录音已开始；-2：文件或目录创建失败；-3：后缀指定的音频格式不支持
+     *
+     * 注意：
+     *     - 在 9.3 之前的版本，params 为 string 代表 录音文件路径（必填）, 9.3 以及以后同时支持 string 类型和 TRTCAudioRecordingParams。
      */
-    startAudioRecording(path: string): number;
+    startAudioRecording(params: TRTCAudioRecordingParams | string): number;
     /**
      * 4.13 停止录音
      *
@@ -1188,7 +1216,7 @@ declare class TRTCCloud extends EventEmitter {
      * 5.1 获取摄像头设备列表
      *
      * @example
-     * var cameralist = this.rtcCloud.getCameraDevicesList();
+     * var cameralist = rtcCloud.getCameraDevicesList();
      * for (i=0;i<cameralist.length;i++) {
      *    var camera = cameralist[i];
      *    console.info("camera deviceName: " + camera.deviceName + " deviceId:" + camera.deviceId);
@@ -1212,7 +1240,7 @@ declare class TRTCCloud extends EventEmitter {
      * 6.1 获取麦克风设备列表
      *
      * @example
-     *   var miclist = this.rtcCloud.getMicDevicesList();
+     *   var miclist = rtcCloud.getMicDevicesList();
      *   for (i=0;i<miclist.length;i++) {
      *     var mic = miclist[i];
      *     console.info("mic deviceName: " + mic.deviceName + " deviceId:" + mic.deviceId);
@@ -1264,7 +1292,7 @@ declare class TRTCCloud extends EventEmitter {
      * 6.8 获取扬声器设备列表
      *
      * @example
-     *   var speakerlist = this.rtcCloud.getSpeakerDevicesList();
+     *   var speakerlist = rtcCloud.getSpeakerDevicesList();
      *   for (i=0;i<speakerlist.length;i++) {
      *     var speaker = speakerlist[i];
      *     console.info("mic deviceName: " + speaker.deviceName + " deviceId:" + speaker.deviceId);
@@ -1429,6 +1457,11 @@ declare class TRTCCloud extends EventEmitter {
      * - 共享整个窗口：sourceInfoList 中 type 为 Window 的 source，captureRect 设为 { 0, 0, 0, 0 }
      * - 共享窗口区域：sourceInfoList 中 type 为 Window 的 source，captureRect 设为非 NULL，例如 { 100, 100, 300, 300 }
      *
+     * @param {TRTCScreenCaptureSourceInfo} source - 指定分享源，详情参考TRTCScreenCaptureSourceInfo 定义
+     * @param {Rect} captureRect    - 指定捕获的区域
+     * @param {TRTCScreenCaptureProperty} property  - 指定屏幕分享目标的属性，包括捕获鼠标，高亮捕获窗口等，详情参考TRTCScreenCaptureProperty 定义
+     *
+     * 废弃参数使用方法(针对 9.3 以下版本):
      * @param {TRTCScreenCaptureSourceType} type - 采集源类型
      * - TRTCScreenCaptureSourceTypeWindow: 该分享目标是某一个Windows窗口
      * - TRTCScreenCaptureSourceTypeScreen: 该分享目标是整个Windows桌面
@@ -1443,9 +1476,9 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Boolean} captureMouse    - 指定是否捕获鼠标指针
      * @param {Boolean} highlightWindow - 指定是否高亮正在共享的窗口，以及当捕获图像被遮挡时高亮遮挡窗口提示用户移走遮挡
      */
-    selectScreenCaptureTarget(type: number, sourceId: string, sourcename: string, captureRect: Rect, captureMouse: boolean, highlightWindow: boolean): any;
+    selectScreenCaptureTarget(source: TRTCScreenCaptureSourceInfo | number, captureRect: Rect | string, property: TRTCScreenCaptureProperty | string, deprecatedCaptureRect?: Rect, captureMouse?: boolean, highlightWindow?: boolean): any;
     /**
-     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。（暂不支持 mac 平台预览界面）
+     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。
      *
      * 注意:
      * 一个用户同时最多只能上传一条主路（TRTCVideoStreamTypeBig）画面和一条辅路（TRTCVideoStreamTypeSub）画面，
@@ -1840,13 +1873,21 @@ declare class TRTCCloud extends EventEmitter {
      * 测速结果将会用于优化 SDK 接下来的服务器选择策略，因此推荐您在用户首次通话前先进行一次测速，这将有助于我们选择最佳的服务器。
      * 同时，如果测试结果非常不理想，您可以通过醒目的 UI 提示用户选择更好的网络。
      *
-     * 注意：测速本身会消耗一定的流量，所以也会产生少量额外的流量费用。
+     * 注意：
+     * 1. 测速过程将产生少量的基础服务费用，详见 [计费概述 > 基础服务](https://cloud.tencent.com/document/product/647/17157#.E5.9F.BA.E7.A1.80.E6.9C.8D.E5.8A.A1) 文档说明。
+     * 2. 请在进入房间前进行网速测试，在房间中网速测试会影响正常的音视频传输效果，而且由于干扰过多，网速测试结果也不准确。
+     * 3. 同一时间只允许一项网速测试任务运行。
+     *
+     * @param {TRTCSpeedTestParams} params - 测速参数
+     * @param {Number} params.sdkAppId     - 应用标识
+     * @param {String} params.userId       - 用户标识
+     * @param {String} params.userSig      - 用户签名
+     * @param {Number} params.expectedUpBandwidth - 预期的上行带宽（kbps，取值范围： 10 ～ 5000，为 0 时不测试）。
+     * @param {Number} params.expectedDownBandwidth - 预期的下行带宽（kbps，取值范围： 10 ～ 5000，为 0 时不测试）。
      *
-     * @param {Number} sdkAppId - 应用标识
-     * @param {String} userId   - 用户标识
-     * @param {String} userSig  - 用户签名
+     * @return 接口调用结果，< 0：失败
      */
-    startSpeedTest(sdkAppId: number, userId: string, userSig: string): void;
+    startSpeedTest(params: TRTCSpeedTestParams | number, userId?: string, userSig?: string): any;
     /**
      * 13.2 停止网络测速
      */
@@ -1976,7 +2017,6 @@ declare class TRTCCloud extends EventEmitter {
     removePlugin(id: string): void;
     getPluginList(): PluginInfo[];
     createPlugin(pluginId: string): PluginInfo;
-    setPluginCallback(pluginCb: (pluginId: string, errorCode: number, msg: string) => void): void;
     getKey(uid: string, type: TRTCVideoStreamType): string;
     /**
      * 判断是否支持webGL