@tencentcloud/tuiroom-engine-js 3.4.3-beta.2 → 3.4.3

package/index.d.ts

@@ -297,6 +297,11 @@ type TUISeatInfo = {
     isVideoLocked: boolean;
     isAudioLocked: boolean;
 };
+declare enum TUIMoveSeatPolicy {
+    kAbortWhenOccupied = 0,
+    kForceReplace = 1,
+    kSwapPosition = 2
+}
 type TUIRequest = {
     requestAction: TUIRequestAction;
     timestamp: number;
@@ -1226,6 +1231,25 @@ type TUILiveInfo = {
     readonly lebEncrypted?: string;
     readonly lebSignature?: string;
 };
+type StartLiveOptions = {
+    roomId: string;
+    roomType?: TUIRoomType;
+    name: string;
+    notice?: string;
+    isMessageDisableForAllUser?: boolean;
+    isGiftEnabled?: boolean;
+    isLikeEnabled?: boolean;
+    isPublicVisible?: boolean;
+    isSeatEnabled?: boolean;
+    keepOwnerOnSeat?: boolean;
+    seatLayoutTemplateId?: number;
+    maxSeatCount?: number;
+    seatMode?: TUISeatMode;
+    coverUrl?: string;
+    backgroundUrl?: string;
+    categoryList?: Array<number>;
+    activityStatus?: number;
+};
 /**
  * 直播连线用户信息
  */
@@ -2318,7 +2342,7 @@ declare class TUILiveListManager {
      *
      * @description 创建并开始一个新的直播间，房主调用此接口来启动直播
      * @since 3.3.0
-     * @param {TUILiveInfo} liveInfo 直播间信息，包含房间ID、名称、公告等配置
+     * @param {StartLiveOptions | TUILiveInfo} liveInfo 直播间信息，包含房间ID、名称、公告等配置
      * @returns {Promise<TUILiveInfo>} 返回创建成功后的直播间完整信息，包含CDN流地址等
      * @throws {TUIError} 可能抛出的错误：
      *   - ERR_ALREADY_ROOM_OWNER: 用户已经是房间所有者
@@ -2350,7 +2374,7 @@ declare class TUILiveListManager {
      * console.log('直播开始成功，CDN流地址：', resultLiveInfo.cdnStreamUrl);
      * ```
      */
-    startLive(liveInfo: TUILiveInfo): Promise<TUILiveInfo>;
+    startLive(liveInfo: StartLiveOptions | TUILiveInfo): Promise<TUILiveInfo>;
     /**
      * 停止直播
      *
@@ -2980,10 +3004,18 @@ declare class TUIRoomEngine {
     /**
      * @private
      * 调用 TUIRoomEngineWASM 的 CallAPI 方法
+     * 该接口废弃，后续逐步替换为 JSCallNativeCallAPIPromiseNew 方法
      * @param funcName
      * @param jsonString
      */
     private JSCallNativeCallAPIPromise;
+    /**
+     * 调用 roomEngineWASM 的 CallAPI 方法
+     * @param funcName 函数名
+     * @param args 参数
+     * @returns Promise
+     */
+    private JSCallNativeCallAPIPromiseNew;
     /**
      * 登录 TUIRoomEngine
      *
@@ -3476,7 +3508,7 @@ declare class TUIRoomEngine {
      */
     stopPushLocalVideo(): Promise<void>;
     /**
-     * 开始向远端推本地音频流
+     * 停止向远端推本地音频流
      * @returns {Promise<void>}
      *
      * @example
@@ -3486,7 +3518,7 @@ declare class TUIRoomEngine {
      */
     muteLocalAudio(): Promise<void>;
     /**
-     * 停止向远端推本地音频流
+     * 开始向远端推本地音频流
      * @returns {Promise<void>}
      *
      * @example
@@ -3951,6 +3983,23 @@ declare class TUIRoomEngine {
     moveToSeat(options: {
         targetSeatIndex: number;
     }): Promise<void>;
+    /**
+     * 移动麦上的用户（仅支持房主或者管理员使用此接口）
+     * @since v3.4.3
+     * @note 当目标麦位有人时，支持三种移麦策略：
+     * - 目标麦位有人时放弃移动（默认）
+     * - 强制替换 - 将原麦位用户踢下麦
+     * - 交换位置 - 互换两个用户的麦位
+     * @param {string} options.userId 待移动的麦上用户
+     * @param {number} options.targetSeatIndex 移麦目标麦位 index, 移麦成功后您将会在此麦位上。
+     * @param {TUIMoveSeatPolicy} options.policy 移动麦上用户时的策略, 默认为目标麦位有人时放弃移动
+     * @returns {Promise<void>}
+     */
+    moveUserToSeatByAdmin(options: {
+        userId: string;
+        targetSeatIndex: number;
+        policy: TUIMoveSeatPolicy;
+    }): Promise<void>;
     /**
      * 邀请其他人上麦（仅房间主持人和管理员可调用此方法）
      * @param {object} options 邀请其他人上麦的参数
@@ -4454,5 +4503,5 @@ declare class TUIRoomEngine {
     private static handleSetFramework;
 }
 
-export { TRTCRole, TUIAudioQuality, TUIAudioRoute, TUIBattleCode, TUIBattleStoppedReason, TUICaptureSourceType, TUIChangeReason, TUIConferenceCancelReason, TUIConferenceInvitationManager, TUIConferenceInvitationManagerEvents, TUIConferenceListManager, TUIConferenceListManagerEvents, TUIConferenceStatus, TUIConnectionCode, TUIDeviceStatus, TUIErrorCode, TUIInvitationCode, TUIInvitationRejectedReason, TUIInvitationStatus, TUIKickedOutOfRoomReason, TUILiveBattleManagerEvents, TUILiveConnectionManagerEvents, TUILiveLayoutManager, TUILiveLayoutManagerEvents, TUILiveListManager, TUILiveListManagerEvents, TUILiveModifyFlag, TUIMediaDevice, TUIMediaDeviceState, TUIMediaDeviceType, TUINetworkQuality, TUIRenderMode, TUIRequestAction, TUIRequestCallbackType, TUIResolutionMode, TUIRole, TUIRoomDeviceManager, TUIRoomDeviceMangerEvents, TUIRoomDismissedReason, TUIRoomEvents, TUIRoomType, TUISeatMode, TUIVideoQuality, TUIVideoStreamType, TUIRoomEngine as default };
-export type { TUIAutoPlayCallbackInfo, TUIBattleConfig, TUIBattleInfo, TUIBattleUser, TUIConferenceInfo, TUIConferenceModifyInfo, TUIDeviceInfo, TUIEnterRoomOptions, TUIInvitation, TUILiveConnectionUser, TUILiveInfo, TUILiveListResult, TUILiveModifyInfo, TUILiveStatisticsData, TUILoginUserInfo, TUIMessage, TUINetwork, TUIRequest, TUIRequestCallback, TUIRoomInfo, TUISeatInfo, TUISeatLayout, TUISeatLockParams, TUISeatRegion, TUIUserInfo, TUIVideoEncoderParams };
+export { TRTCRole, TUIAudioQuality, TUIAudioRoute, TUIBattleCode, TUIBattleStoppedReason, TUICaptureSourceType, TUIChangeReason, TUIConferenceCancelReason, TUIConferenceInvitationManager, TUIConferenceInvitationManagerEvents, TUIConferenceListManager, TUIConferenceListManagerEvents, TUIConferenceStatus, TUIConnectionCode, TUIDeviceStatus, TUIErrorCode, TUIInvitationCode, TUIInvitationRejectedReason, TUIInvitationStatus, TUIKickedOutOfRoomReason, TUILiveBattleManagerEvents, TUILiveConnectionManagerEvents, TUILiveLayoutManager, TUILiveLayoutManagerEvents, TUILiveListManager, TUILiveListManagerEvents, TUILiveModifyFlag, TUIMediaDevice, TUIMediaDeviceState, TUIMediaDeviceType, TUIMoveSeatPolicy, TUINetworkQuality, TUIRenderMode, TUIRequestAction, TUIRequestCallbackType, TUIResolutionMode, TUIRole, TUIRoomDeviceManager, TUIRoomDeviceMangerEvents, TUIRoomDismissedReason, TUIRoomEvents, TUIRoomType, TUISeatMode, TUIVideoQuality, TUIVideoStreamType, TUIRoomEngine as default };
+export type { StartLiveOptions, TUIAutoPlayCallbackInfo, TUIBattleConfig, TUIBattleInfo, TUIBattleUser, TUIConferenceInfo, TUIConferenceModifyInfo, TUIDeviceInfo, TUIEnterRoomOptions, TUIInvitation, TUILiveConnectionUser, TUILiveInfo, TUILiveListResult, TUILiveModifyInfo, TUILiveStatisticsData, TUILoginUserInfo, TUIMessage, TUINetwork, TUIRequest, TUIRequestCallback, TUIRoomInfo, TUISeatInfo, TUISeatLayout, TUISeatLockParams, TUISeatRegion, TUIUserInfo, TUIVideoEncoderParams };