trtc-electron-sdk 12.1.608 → 12.2.701

package/liteav/trtc_define.d.ts

@@ -265,10 +265,11 @@ export declare enum TRTCLogLevel {
 export declare enum TRTCDeviceState {
     TRTCDeviceStateAdd = 0,
     TRTCDeviceStateRemove = 1,
-    TRTCDeviceStateActive = 2
+    TRTCDeviceStateActive = 2,
+    TRTCDefaultDeviceChanged = 3
 }
 export declare enum TRTCDeviceType {
-    TRTCDeviceTypeUnknow = -1,
+    TRTCDeviceTypeUnknown = -1,
     TRTCDeviceTypeMic = 0,
     TRTCDeviceTypeSpeaker = 1,
     TRTCDeviceTypeCamera = 2
@@ -836,15 +837,22 @@ export declare class TRTCRemoteStatistics {
  *                             而 30% 的丢包率则意味着服务器向 SDK 发送的每10个数据包中就会有3个会在下行传输中丢失。
  * @param {Number} appCpu    - 当前 App 的 CPU 使用率（％）
  * @param {Number} systemCpu - 当前系统的 CPU 使用率（％）
- * @param {Number} rtt       - 延迟（毫秒），代表 SDK 跟服务器一来一回之间所消耗的时间，这个值越小越好。
- *                             一般低于50ms的 rtt 是比较理想的情况，而高于100ms的 rtt 会引入较大的通话延时。
- *                             由于数据上下行共享一条网络连接，所以 local 和 remote 的 rtt 相同。
+ * @param {Number} rtt       - 从 SDK 到云端的往返延时，单位 ms。
+ *                             该数值代表从 SDK 发送一个网络包到云端，再从云端回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK=>云端=>SDK” 的总耗时。
+ *                             该数值越小越好：如果 rtt < 50ms，意味着较低的音视频通话延迟；如果 rtt > 200ms，则意味着较高的音视频通话延迟。
+ *                             需要特别解释的是，rtt 代表 “SDK=>云端=>SDK” 的总耗时，所以不需要区分 upRtt 和 downRtt。
  * @param {Number} receivedBytes - 总接收字节数（包含信令和音视频）
  * @param {Number} sentBytes     - 总发送字节总数（包含信令和音视频）
  * @param {TRTCLocalStatistics[]} localStatisticsArray - 自己本地的音视频统计信息，由于可能有大画面、小画面以及辅路画面等多路的情况，所以是一个数组
  * @param {Number} localStatisticsArraySize - 数组 localStatisticsArray 的大小
  * @param {TRTCRemoteStatistics[]} remoteStatisticsArray - 远端成员的音视频统计信息，由于可能有大画面、小画面以及辅路画面等多路的情况，所以是一个数组
  * @param {Number} remoteStatisticsArraySize - 数组 remoteStatisticsArray 的大小
+ * @param {Number} gatewayRtt - 从 SDK 到本地路由器的往返时延，单位 ms。
+ *                              该数值代表从 SDK 发送一个网络包到本地路由器网关，再从网关回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK>网关>SDK” 的总耗时。
+ *                              该数值越小越好：如果 gatewayRtt < 50ms，意味着较低的音视频通话延迟；如果 gatewayRtt > 200ms，则意味着较高的音视频通话延迟。
+ * @param {Number} systemMemoryInMB - 当前系统的内存，单位 (MB)
+ * @param {Number} systemMemoryUsageInMB - 当前系统内存占用，单位 (MB)
+ * @param {Number} appMemoryUsageInMB - 当前应用的内存占用，单位 (MB)
  *
  */
 export declare class TRTCStatistics {
@@ -859,7 +867,11 @@ export declare class TRTCStatistics {
     localStatisticsArraySize: number;
     remoteStatisticsArray: TRTCRemoteStatistics[];
     remoteStatisticsArraySize: number;
-    constructor(upLoss?: number, downLoss?: number, appCpu?: number, systemCpu?: number, rtt?: number, receivedBytes?: number, sentBytes?: number, localStatisticsArray?: TRTCLocalStatistics[], localStatisticsArraySize?: number, remoteStatisticsArray?: TRTCRemoteStatistics[], remoteStatisticsArraySize?: number);
+    gatewayRtt: number;
+    appMemoryUsageInMB: number;
+    systemMemoryUsageInMB: number;
+    systemMemoryInMB: number;
+    constructor(upLoss?: number, downLoss?: number, appCpu?: number, systemCpu?: number, rtt?: number, receivedBytes?: number, sentBytes?: number, localStatisticsArray?: TRTCLocalStatistics[], localStatisticsArraySize?: number, remoteStatisticsArray?: TRTCRemoteStatistics[], remoteStatisticsArraySize?: number, gatewayRtt?: number, appMemoryUsageInMB?: number, systemMemoryUsageInMB?: number, systemMemoryInMB?: number);
 }
 /**
  * 音乐参数
@@ -883,6 +895,15 @@ export declare class AudioMusicParam {
     endTimeMS: number;
     constructor(id?: number, path?: string, loopCount?: number, publish?: boolean, isShortFile?: boolean, startTimeMS?: number, endTimeMS?: number);
 }
+export declare type TRTCAudioMusicParam = {
+    id: number;
+    path: string;
+    loopCount: number;
+    publish: boolean;
+    isShortFile: boolean;
+    startTimeMS: number;
+    endTimeMS: number;
+};
 /**
  * 背景音乐播放事件监听器类型定义
  */
@@ -910,6 +931,20 @@ export declare type TRTCMusicPlayObserver = {
      */
     onComplete: (id: number, errCode: number) => void | null;
 };
+export declare type TRTCMusicPreloadObserver = {
+    /**
+     * 背景音乐预加载进度
+     * @param {Number} id -  背景音乐 ID
+     * @param {Number} progress -  加载进度
+     */
+    onLoadProgress: (id: number, progress: number) => void;
+    /**
+     *  背景音乐预加载出错
+     * @param {Number} id -  背景音乐 ID
+     * @param {Number} errorCode - 错误码
+     */
+    onLoadError: (id: number, errorCode: number) => void;
+};
 /**
  * 音频数据自定义回调事件监听器类型定义
  */
@@ -992,6 +1027,9 @@ export declare class VideoBufferInfo {
         pixelFormat: TRTCVideoPixelFormat;
     });
 }
+/**
+ * 构造函数参数
+ */
 export interface TRTCInitConfig {
     networkProxy?: {
         host: string;
@@ -1004,4 +1042,5 @@ export interface TRTCInitConfig {
             supportUdp: boolean;
         };
     };
+    isIPCMode?: boolean;
 }

package/liteav/trtc_define.js

@@ -111,7 +111,6 @@ var TRTCVideoResolutionMode;
     TRTCVideoResolutionMode[TRTCVideoResolutionMode["TRTCVideoResolutionModeLandscape"] = 0] = "TRTCVideoResolutionModeLandscape";
     TRTCVideoResolutionMode[TRTCVideoResolutionMode["TRTCVideoResolutionModePortrait"] = 1] = "TRTCVideoResolutionModePortrait";
 })(TRTCVideoResolutionMode = exports.TRTCVideoResolutionMode || (exports.TRTCVideoResolutionMode = {}));
-;
 /**
  * 视频流类型
  *
@@ -140,7 +139,6 @@ var TRTCVideoStreamType;
     TRTCVideoStreamType[TRTCVideoStreamType["TRTCVideoStreamTypeSmall"] = 1] = "TRTCVideoStreamTypeSmall";
     TRTCVideoStreamType[TRTCVideoStreamType["TRTCVideoStreamTypeSub"] = 2] = "TRTCVideoStreamTypeSub";
 })(TRTCVideoStreamType = exports.TRTCVideoStreamType || (exports.TRTCVideoStreamType = {}));
-;
 /**
  * 画质级别
  *
@@ -174,7 +172,6 @@ var TRTCQuality;
     TRTCQuality[TRTCQuality["TRTCQuality_Vbad"] = 5] = "TRTCQuality_Vbad";
     TRTCQuality[TRTCQuality["TRTCQuality_Down"] = 6] = "TRTCQuality_Down";
 })(TRTCQuality = exports.TRTCQuality || (exports.TRTCQuality = {}));
-;
 /**
  * 视频画面填充模式
  *
@@ -195,7 +192,6 @@ var TRTCVideoFillMode;
     TRTCVideoFillMode[TRTCVideoFillMode["TRTCVideoFillMode_Fill"] = 0] = "TRTCVideoFillMode_Fill";
     TRTCVideoFillMode[TRTCVideoFillMode["TRTCVideoFillMode_Fit"] = 1] = "TRTCVideoFillMode_Fit";
 })(TRTCVideoFillMode = exports.TRTCVideoFillMode || (exports.TRTCVideoFillMode = {}));
-;
 /**
  * 视频画面旋转方向
  *
@@ -220,7 +216,6 @@ var TRTCVideoRotation;
     TRTCVideoRotation[TRTCVideoRotation["TRTCVideoRotation180"] = 2] = "TRTCVideoRotation180";
     TRTCVideoRotation[TRTCVideoRotation["TRTCVideoRotation270"] = 3] = "TRTCVideoRotation270";
 })(TRTCVideoRotation = exports.TRTCVideoRotation || (exports.TRTCVideoRotation = {}));
-;
 /**
  * 美颜（磨皮）算法
  *
@@ -240,7 +235,6 @@ var TRTCBeautyStyle;
     TRTCBeautyStyle[TRTCBeautyStyle["TRTCBeautyStyleSmooth"] = 0] = "TRTCBeautyStyleSmooth";
     TRTCBeautyStyle[TRTCBeautyStyle["TRTCBeautyStyleNature"] = 1] = "TRTCBeautyStyleNature";
 })(TRTCBeautyStyle = exports.TRTCBeautyStyle || (exports.TRTCBeautyStyle = {}));
-;
 /**
  * 视频像素格式
  *
@@ -271,7 +265,6 @@ var TRTCVideoPixelFormat;
     TRTCVideoPixelFormat[TRTCVideoPixelFormat["TRTCVideoPixelFormat_RGBA32"] = 5] = "TRTCVideoPixelFormat_RGBA32";
     TRTCVideoPixelFormat[TRTCVideoPixelFormat["TRTCVideoPixelFormat_H264"] = 6] = "TRTCVideoPixelFormat_H264";
 })(TRTCVideoPixelFormat = exports.TRTCVideoPixelFormat || (exports.TRTCVideoPixelFormat = {}));
-;
 /**
  * 视频数据包装格式
  *
@@ -400,7 +393,6 @@ var TRTCAppScene;
     TRTCAppScene[TRTCAppScene["TRTCAppSceneAudioCall"] = 2] = "TRTCAppSceneAudioCall";
     TRTCAppScene[TRTCAppScene["TRTCAppSceneVoiceChatRoom"] = 3] = "TRTCAppSceneVoiceChatRoom";
 })(TRTCAppScene = exports.TRTCAppScene || (exports.TRTCAppScene = {}));
-;
 /**
  * 角色，仅适用于直播场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）
  *
@@ -423,7 +415,6 @@ var TRTCRoleType;
     TRTCRoleType[TRTCRoleType["TRTCRoleAnchor"] = 20] = "TRTCRoleAnchor";
     TRTCRoleType[TRTCRoleType["TRTCRoleAudience"] = 21] = "TRTCRoleAudience";
 })(TRTCRoleType = exports.TRTCRoleType || (exports.TRTCRoleType = {}));
-;
 /**
  * 流控模式
  *
@@ -448,7 +439,6 @@ var TRTCQosControlMode;
     TRTCQosControlMode[TRTCQosControlMode["TRTCQosControlModeClient"] = 0] = "TRTCQosControlModeClient";
     TRTCQosControlMode[TRTCQosControlMode["TRTCQosControlModeServer"] = 1] = "TRTCQosControlModeServer";
 })(TRTCQosControlMode = exports.TRTCQosControlMode || (exports.TRTCQosControlMode = {}));
-;
 /**
  * 画质偏好
  *
@@ -471,7 +461,6 @@ var TRTCVideoQosPreference;
     TRTCVideoQosPreference[TRTCVideoQosPreference["TRTCVideoQosPreferenceSmooth"] = 1] = "TRTCVideoQosPreferenceSmooth";
     TRTCVideoQosPreference[TRTCVideoQosPreference["TRTCVideoQosPreferenceClear"] = 2] = "TRTCVideoQosPreferenceClear";
 })(TRTCVideoQosPreference = exports.TRTCVideoQosPreference || (exports.TRTCVideoQosPreference = {}));
-;
 /////////////////////////////////////////////////////////////////////////////////
 //
 //                    【（三）继承 TXLiteAVBase 的定义】
@@ -494,7 +483,6 @@ var TRTCAudioFrameFormat;
     TRTCAudioFrameFormat[TRTCAudioFrameFormat["TRTCAudioFrameFormatNone"] = 0] = "TRTCAudioFrameFormatNone";
     TRTCAudioFrameFormat[TRTCAudioFrameFormat["TRTCAudioFrameFormatPCM"] = 1] = "TRTCAudioFrameFormatPCM";
 })(TRTCAudioFrameFormat = exports.TRTCAudioFrameFormat || (exports.TRTCAudioFrameFormat = {}));
-;
 /**
  * 屏幕分享目标信息
  *
@@ -518,7 +506,6 @@ var TRTCScreenCaptureSourceType;
     TRTCScreenCaptureSourceType[TRTCScreenCaptureSourceType["TRTCScreenCaptureSourceTypeScreen"] = 1] = "TRTCScreenCaptureSourceTypeScreen";
     TRTCScreenCaptureSourceType[TRTCScreenCaptureSourceType["TRTCScreenCaptureSourceTypeCustom"] = 2] = "TRTCScreenCaptureSourceTypeCustom";
 })(TRTCScreenCaptureSourceType = exports.TRTCScreenCaptureSourceType || (exports.TRTCScreenCaptureSourceType = {}));
-;
 /**
  * 音频质量
  *
@@ -557,7 +544,6 @@ class TRTCImageBuffer {
     }
 }
 exports.TRTCImageBuffer = TRTCImageBuffer;
-;
 /**
  * 屏幕采集源信息
  *
@@ -588,7 +574,6 @@ class TRTCScreenCaptureSourceInfo {
     }
 }
 exports.TRTCScreenCaptureSourceInfo = TRTCScreenCaptureSourceInfo;
-;
 /**
  * 屏幕分享的进阶控制参数
  *
@@ -634,7 +619,6 @@ class TRTCDeviceInfo {
     }
 }
 exports.TRTCDeviceInfo = TRTCDeviceInfo;
-;
 /**
  * 视频帧数据
  *
@@ -663,7 +647,6 @@ class TRTCVideoFrame {
     }
 }
 exports.TRTCVideoFrame = TRTCVideoFrame;
-;
 /**
  * 音频帧数据
  *
@@ -689,7 +672,6 @@ class TRTCAudioFrame {
     }
 }
 exports.TRTCAudioFrame = TRTCAudioFrame;
-;
 /////////////////////////////////////////////////////////////////////////////////
 //
 //                    【（四）更多枚举值定义】
@@ -727,7 +709,6 @@ var TRTCLogLevel;
     TRTCLogLevel[TRTCLogLevel["TRTCLogLevelFatal"] = 5] = "TRTCLogLevelFatal";
     TRTCLogLevel[TRTCLogLevel["TRTCLogLevelNone"] = 6] = "TRTCLogLevelNone";
 })(TRTCLogLevel = exports.TRTCLogLevel || (exports.TRTCLogLevel = {}));
-;
 /**
  * 设备操作
  *
@@ -741,14 +722,16 @@ const TRTCDeviceState_HACK_JSDOC = {
     TRTCDeviceStateRemove: 1,
     /** 设备已启用 */
     TRTCDeviceStateActive: 2,
+    /** 系统默认设备变更 */
+    TRTCDefaultDeviceChanged: 3,
 };
 var TRTCDeviceState;
 (function (TRTCDeviceState) {
     TRTCDeviceState[TRTCDeviceState["TRTCDeviceStateAdd"] = 0] = "TRTCDeviceStateAdd";
     TRTCDeviceState[TRTCDeviceState["TRTCDeviceStateRemove"] = 1] = "TRTCDeviceStateRemove";
     TRTCDeviceState[TRTCDeviceState["TRTCDeviceStateActive"] = 2] = "TRTCDeviceStateActive";
+    TRTCDeviceState[TRTCDeviceState["TRTCDefaultDeviceChanged"] = 3] = "TRTCDefaultDeviceChanged";
 })(TRTCDeviceState = exports.TRTCDeviceState || (exports.TRTCDeviceState = {}));
-;
 /**
  * 设备类型
  *
@@ -757,7 +740,7 @@ var TRTCDeviceState;
  */
 const TRTCDeviceType_HACK_JSDOC = {
     /** 未知类型 */
-    TRTCDeviceTypeUnknow: -1,
+    TRTCDeviceTypeUnknown: -1,
     /** 麦克风 */
     TRTCDeviceTypeMic: 0,
     /** 扬声器 */
@@ -767,12 +750,11 @@ const TRTCDeviceType_HACK_JSDOC = {
 };
 var TRTCDeviceType;
 (function (TRTCDeviceType) {
-    TRTCDeviceType[TRTCDeviceType["TRTCDeviceTypeUnknow"] = -1] = "TRTCDeviceTypeUnknow";
+    TRTCDeviceType[TRTCDeviceType["TRTCDeviceTypeUnknown"] = -1] = "TRTCDeviceTypeUnknown";
     TRTCDeviceType[TRTCDeviceType["TRTCDeviceTypeMic"] = 0] = "TRTCDeviceTypeMic";
     TRTCDeviceType[TRTCDeviceType["TRTCDeviceTypeSpeaker"] = 1] = "TRTCDeviceTypeSpeaker";
     TRTCDeviceType[TRTCDeviceType["TRTCDeviceTypeCamera"] = 2] = "TRTCDeviceTypeCamera";
 })(TRTCDeviceType = exports.TRTCDeviceType || (exports.TRTCDeviceType = {}));
-;
 /**
  * 摄像头采集偏好
  *
@@ -828,7 +810,6 @@ var TRTCWaterMarkSrcType;
     TRTCWaterMarkSrcType[TRTCWaterMarkSrcType["TRTCWaterMarkSrcTypeBGRA32"] = 1] = "TRTCWaterMarkSrcTypeBGRA32";
     TRTCWaterMarkSrcType[TRTCWaterMarkSrcType["TRTCWaterMarkSrcTypeRGBA32"] = 2] = "TRTCWaterMarkSrcTypeRGBA32";
 })(TRTCWaterMarkSrcType = exports.TRTCWaterMarkSrcType || (exports.TRTCWaterMarkSrcType = {}));
-;
 /////////////////////////////////////////////////////////////////////////////////
 //
 //                      【（五）TRTC 核心类型定义】
@@ -878,7 +859,6 @@ class TRTCParams {
     }
 }
 exports.TRTCParams = TRTCParams;
-;
 /**
  * 视频编码参数
  *
@@ -924,7 +904,6 @@ class TRTCVideoEncParam {
     }
 }
 exports.TRTCVideoEncParam = TRTCVideoEncParam;
-;
 /**
  * 画面渲染参数
  *
@@ -966,7 +945,6 @@ class TRTCNetworkQosParam {
     }
 }
 exports.TRTCNetworkQosParam = TRTCNetworkQosParam;
-;
 /**
  * 视频质量
  *
@@ -983,7 +961,6 @@ class TRTCQualityInfo {
     }
 }
 exports.TRTCQualityInfo = TRTCQualityInfo;
-;
 /**
  * 音量大小
  *
@@ -1009,7 +986,6 @@ class TRTCVolumeInfo {
     }
 }
 exports.TRTCVolumeInfo = TRTCVolumeInfo;
-;
 /**
  * 测速参数
  *
@@ -1072,7 +1048,6 @@ class TRTCSpeedTestResult {
     }
 }
 exports.TRTCSpeedTestResult = TRTCSpeedTestResult;
-;
 /**
  * 记录矩形的四个点坐标
  *
@@ -1091,7 +1066,6 @@ class Rect {
     }
 }
 exports.Rect = Rect;
-;
 /**
  * 云端混流中每一路子画面的位置信息
  *
@@ -1126,7 +1100,6 @@ class TRTCMixUser {
     }
 }
 exports.TRTCMixUser = TRTCMixUser;
-;
 /**
  * 混流参数配置模式
  *
@@ -1185,7 +1158,6 @@ var TRTCTranscodingConfigMode;
     TRTCTranscodingConfigMode[TRTCTranscodingConfigMode["TRTC_TranscodingConfigMode_Template_PresetLayout"] = 8] = "TRTC_TranscodingConfigMode_Template_PresetLayout";
     TRTCTranscodingConfigMode[TRTCTranscodingConfigMode["TRTC_TranscodingConfigMode_Template_ScreenSharing"] = 9] = "TRTC_TranscodingConfigMode_Template_ScreenSharing";
 })(TRTCTranscodingConfigMode = exports.TRTCTranscodingConfigMode || (exports.TRTCTranscodingConfigMode = {}));
-;
 /**
  * 混流输入类型
  *
@@ -1440,7 +1412,6 @@ class TRTCTranscodingConfig {
     }
 }
 exports.TRTCTranscodingConfig = TRTCTranscodingConfig;
-;
 /**
  * CDN 旁路推流参数
  *
@@ -1459,7 +1430,6 @@ class TRTCPublishCDNParam {
     }
 }
 exports.TRTCPublishCDNParam = TRTCPublishCDNParam;
-;
 /**
  * 录音参数
  *
@@ -1479,7 +1449,6 @@ class TRTCAudioRecordingParams {
     }
 }
 exports.TRTCAudioRecordingParams = TRTCAudioRecordingParams;
-;
 /**
  * 音效
  *
@@ -1503,7 +1472,6 @@ class TRTCAudioEffectParam {
     }
 }
 exports.TRTCAudioEffectParam = TRTCAudioEffectParam;
-;
 /**
  * 本地的音视频统计信息
  *
@@ -1528,7 +1496,6 @@ class TRTCLocalStatistics {
     }
 }
 exports.TRTCLocalStatistics = TRTCLocalStatistics;
-;
 /**
  * 远端成员的音视频统计信息
  *
@@ -1592,7 +1559,6 @@ class TRTCRemoteStatistics {
     }
 }
 exports.TRTCRemoteStatistics = TRTCRemoteStatistics;
-;
 /**
  * 统计数据
  *
@@ -1602,19 +1568,26 @@ exports.TRTCRemoteStatistics = TRTCRemoteStatistics;
  *                             而 30% 的丢包率则意味着服务器向 SDK 发送的每10个数据包中就会有3个会在下行传输中丢失。
  * @param {Number} appCpu    - 当前 App 的 CPU 使用率（％）
  * @param {Number} systemCpu - 当前系统的 CPU 使用率（％）
- * @param {Number} rtt       - 延迟（毫秒），代表 SDK 跟服务器一来一回之间所消耗的时间，这个值越小越好。
- *                             一般低于50ms的 rtt 是比较理想的情况，而高于100ms的 rtt 会引入较大的通话延时。
- *                             由于数据上下行共享一条网络连接，所以 local 和 remote 的 rtt 相同。
+ * @param {Number} rtt       - 从 SDK 到云端的往返延时，单位 ms。
+ *                             该数值代表从 SDK 发送一个网络包到云端，再从云端回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK=>云端=>SDK” 的总耗时。
+ *                             该数值越小越好：如果 rtt < 50ms，意味着较低的音视频通话延迟；如果 rtt > 200ms，则意味着较高的音视频通话延迟。
+ *                             需要特别解释的是，rtt 代表 “SDK=>云端=>SDK” 的总耗时，所以不需要区分 upRtt 和 downRtt。
  * @param {Number} receivedBytes - 总接收字节数（包含信令和音视频）
  * @param {Number} sentBytes     - 总发送字节总数（包含信令和音视频）
  * @param {TRTCLocalStatistics[]} localStatisticsArray - 自己本地的音视频统计信息，由于可能有大画面、小画面以及辅路画面等多路的情况，所以是一个数组
  * @param {Number} localStatisticsArraySize - 数组 localStatisticsArray 的大小
  * @param {TRTCRemoteStatistics[]} remoteStatisticsArray - 远端成员的音视频统计信息，由于可能有大画面、小画面以及辅路画面等多路的情况，所以是一个数组
  * @param {Number} remoteStatisticsArraySize - 数组 remoteStatisticsArray 的大小
+ * @param {Number} gatewayRtt - 从 SDK 到本地路由器的往返时延，单位 ms。
+ *                              该数值代表从 SDK 发送一个网络包到本地路由器网关，再从网关回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK>网关>SDK” 的总耗时。
+ *                              该数值越小越好：如果 gatewayRtt < 50ms，意味着较低的音视频通话延迟；如果 gatewayRtt > 200ms，则意味着较高的音视频通话延迟。
+ * @param {Number} systemMemoryInMB - 当前系统的内存，单位 (MB)
+ * @param {Number} systemMemoryUsageInMB - 当前系统内存占用，单位 (MB)
+ * @param {Number} appMemoryUsageInMB - 当前应用的内存占用，单位 (MB)
  *
  */
 class TRTCStatistics {
-    constructor(upLoss = 0, downLoss = 0, appCpu = 0, systemCpu = 0, rtt = 0, receivedBytes = 0, sentBytes = 0, localStatisticsArray = [], localStatisticsArraySize = 0, remoteStatisticsArray = [], remoteStatisticsArraySize = 0) {
+    constructor(upLoss = 0, downLoss = 0, appCpu = 0, systemCpu = 0, rtt = 0, receivedBytes = 0, sentBytes = 0, localStatisticsArray = [], localStatisticsArraySize = 0, remoteStatisticsArray = [], remoteStatisticsArraySize = 0, gatewayRtt = 0, appMemoryUsageInMB = 0, systemMemoryUsageInMB = 0, systemMemoryInMB = 0) {
         this.upLoss = upLoss;
         this.downLoss = downLoss;
         this.appCpu = appCpu;
@@ -1626,10 +1599,13 @@ class TRTCStatistics {
         this.localStatisticsArraySize = localStatisticsArraySize;
         this.remoteStatisticsArray = remoteStatisticsArray;
         this.remoteStatisticsArraySize = remoteStatisticsArraySize;
+        this.gatewayRtt = gatewayRtt;
+        this.appMemoryUsageInMB = appMemoryUsageInMB;
+        this.systemMemoryUsageInMB = systemMemoryUsageInMB;
+        this.systemMemoryInMB = systemMemoryInMB;
     }
 }
 exports.TRTCStatistics = TRTCStatistics;
-;
 /**
  * 音乐参数
  *
@@ -1661,19 +1637,36 @@ exports.AudioMusicParam = AudioMusicParam;
  */
 /**
  * @callback TRTCMusicEvent~onStart
- * @param {number} [id] - 背景音乐 ID
- * @param {number} [errCode] - 错误码。0: 开始播放成功；-4001: 打开文件失败，如音频文件格式不支持，本地音频文件不存在，网络音频文件无法访问等。
+ * @param {Number} [id] - 背景音乐 ID
+ * @param {Number} [errCode] - 错误码。0: 开始播放成功；-4001: 打开文件失败，如音频文件格式不支持，本地音频文件不存在，网络音频文件无法访问等。
  */
 /**
  * @callback TRTCMusicEvent~onPlayProgress
- * @param {number} [id] - 背景音乐 ID
+ * @param {Number} [id] - 背景音乐 ID
  * @param {Number} [curPtsMS] - 背景音乐当前播放时间戳
  * @param {Number} [durationMS] - 背景音乐时长
  */
 /**
  * @callback TRTCMusicEvent~onComplete
- * @param {number} [id] - 背景音乐 ID
- * @param {number} [errCode] - 错误码。0: 播放结束；-4002: 解码失败，如音频文件损坏，网络音频文件服务器无法访问等。
+ * @param {Number} [id] - 背景音乐 ID
+ * @param {Number} [errCode] - 错误码。0: 播放结束；-4002: 解码失败，如音频文件损坏，网络音频文件服务器无法访问等。
+ */
+/**
+ * @callback TRTCMusicEvent~onLoadProgress
+ * @param {Number} [id] - 背景音乐 ID
+ * @param {Number} [progress] - 加载进度
+ */
+/**
+ * @callback TRTCMusicEvent~onLoadError
+ * @param {Number} [id] - 背景音乐 ID
+ * @param {Number} [errorCode] - errorCode
+ *  - -4001:打开文件失败，如音频数据无效，FFMPEG 协议未找到等；
+ *  - -4002:解码失败，如音频文件损坏，网络音频文件服务器无法访问等；
+ *  - -4003:预加载数量超上限，请先调用 stopPlayMusic 释放无用的预加载；
+ *  - -4005:非法路径导致打开文件失败，请检查您传入的路径参数是否指向一个合法的音乐文件；
+ *  - -4006:非法URL导致打开文件失败，请用浏览器检查您传入的 URL 地址是否可以下载到期望的音乐文件；
+ *  - -4007:无音频流导致打开文件失败，请确认您传入的文件是否是合法的音频文件，以及文件是否被损坏；
+ *  - -4008:格式不支持导致打开文件失败，请确认您传入的文件格式是否是支持的文件格式，移动端支持【mp3，aac，m4a，wav，ogg，mp4，mkv】，桌面端支持【mp3，aac，m4a，wav，mp4，mkv】。
  */
 /**
  * 背景音乐播放事件回调
@@ -1684,6 +1677,14 @@ exports.AudioMusicParam = AudioMusicParam;
  * @property {TRTCMusicEvent~onComplete|null} onComplete - 背景音乐播放完毕事件。
  */
 const TRTCMusicPlayObserver_HACK_JSDOC = null;
+/**
+ * 背景音乐预加载事件回调
+ *
+ * @typedef {Object} TRTCMusicPreloadObserver
+ * @property {TRTCMusicEvent~onLoadProgress|null} onLoadProgress - 背景音乐预加载进度
+ * @property {TRTCMusicEvent~onLoadError|null} onLoadError - 背景音乐预加载出错
+ */
+const TRTCMusicPreloadObserver_HACK_JSDOC = null;
 /**
  * 音频数据自定义回调
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "12.1.608",
+  "version": "12.2.701",
   "description": "trtc electron sdk",
   "main": "./liteav/trtc.js",
   "types": "./liteav/trtc.d.ts",