@tencentcloud/tuiroom-engine-electron 1.2.1 → 1.4.0-bate.0

package/index.d.ts

@@ -67,6 +67,9 @@ declare class TUIRoomEngine {
      * @param {object} options
      * @param {string} options.userName 用户名，必填
      * @param {string} options.avatarUrl 用户头像，必填
+     * @param {object=} options.customInfo 用户自定义资料
+     * App 管理员可以通过 [即时通信 IM 控制台 > 用户自定义字段](https://console.cloud.tencent.com/im/user-data) 新增自定义资料字段
+     * 用户自定义字段生效以后，用户可以调用 setSelfInfo 接口设置自定义资料
      * @returns {Promise<void>}
      *
      * @example
@@ -75,10 +78,21 @@ declare class TUIRoomEngine {
      *  userName: '',     // 填写您的新用户名
      *  avatarUrl: '',    // 填写您的新头像地址
      * })
+     *
+     * // 设置当前用户用户名, 用户头像及用户自定义消息
+     * await TUIRoomEngine.setSelfInfo({
+     *  userName: '',     // 填写您的新用户名
+     *  avatarUrl: '',    // 填写您的新头像地址
+     *  customInfo: {     // 填写用户自定义消息
+     *    Tag_Profile_Custom_Test: 'value1',
+     *    Tag_Profile_Custom_profile: 'value2,
+     *  },
+     * })
      */
     static setSelfInfo(options: {
         userName: string;
         avatarUrl: string;
+        customInfo?: Record<string, any>;
     }): Promise<void>;
     /** 获取当前用户信息接口
      * @returns {Promise<TUILoginUserInfo>} loginUserInfo
@@ -124,8 +138,6 @@ declare class TUIRoomEngine {
      * @param {number=} options.maxSeatCount 最大麦位数量 （创建房间可选参数）<br>
      * roomType 为 TUIRoomType.kConference (教育及会议场景) 时，maxSeatCount 值不做限制；
      * roomType 为 TUIRoomType.kLivingRoom (直播场景) 时，maxSeatCount 最大限制为 16；
-     * @param {boolean=} [options.enableCDNStreaming=false] 是否开启 CDN 直播流，默认值为 false
-     * @param {string=} [options.cdnStreamDomain=''] 直播推流域名，默认值为空
      * @returns {Promise<void>}
      *
      * @example
@@ -146,8 +158,6 @@ declare class TUIRoomEngine {
         isCameraDisableForAllUser?: boolean;
         isMessageDisableForAllUser?: boolean;
         maxSeatCount?: number;
-        enableCDNStreaming?: boolean;
-        cdnStreamDomain?: string;
     }): Promise<void>;
     /**
      * 进入房间接口
@@ -262,7 +272,7 @@ declare class TUIRoomEngine {
      * 设置本地流的渲染位置
      * @param {object} options 设置本地流的渲染位置的参数
      * @param {TUIVideoStreamType} options.streamType 本地流类型
-     * @param {string} options.view streamType 对应的流渲染的 div 元素的 id
+     * @param {string | Array<string>} options.view streamType 对应的流渲染的 div 元素的 id
      * @returns {Promise<void>}
      *
      * @example
@@ -282,7 +292,7 @@ declare class TUIRoomEngine {
      */
     setLocalVideoView(options: {
         streamType: TUIVideoStreamType;
-        view: string;
+        view: string | Array<string>;
     }): void;
     /**
      * 打开本地摄像头，开始视频流采集
@@ -403,7 +413,7 @@ declare class TUIRoomEngine {
      * @param {object} options 设设置远端流渲染区域的参数
      * @param {string} options.userId 用户 Id
      * @param {TUIVideoStreamType} options.streamType 用户流类型
-     * @param {string} options.view 播放远端用户流的 div 元素的 id
+     * @param {string | Array<string>} options.view 播放远端用户流的 div 元素的 id
      * @returns {Promise<void>}
      *
      * @example
@@ -426,7 +436,7 @@ declare class TUIRoomEngine {
     setRemoteVideoView(options: {
         userId: string;
         streamType: TUIVideoStreamType;
-        view: string;
+        view: string | Array<string>;
     }): Promise<void>;
     /**
      * 开始播放远端用户视频流
@@ -1143,6 +1153,18 @@ declare class TUIRoomEngine {
      * await roomEngine.stopCameraDeviceTest();
      */
     stopCameraDeviceTest(): Promise<void>;
+    /**
+     * 开始进行麦克风测试
+     * @param options
+     * @param {number} options.interval 麦克风音量的回调时间
+     */
+    startMicDeviceTest(options: {
+        interval: number;
+    }): Promise<void>;
+    /**
+     * 停止进行麦克风测试
+     */
+    stopMicDeviceTest(): Promise<void>;
     /**
      * 获取 trtcCloud 实例
      * @returns {TRTCCloud} trtcCloud