@rongcloud/plugin-rtc 5.3.4 → 5.3.7-alpha.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /*
- * RCRTC - v5.3.4
- * CommitId - a0331c6614c5526fb301c3497945278cf0ecc69d
- * Wed Apr 06 2022 15:51:02 GMT+0800 (China Standard Time)
+ * RCRTC - v5.3.7-alpha.1
+ * CommitId - aca944e2fa79b4f5e894c21aaaec789528e8f3fc
+ * Fri Apr 15 2022 18:00:48 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
 import { EventEmitter, LogLevel, RTCMode, IRuntime, RTCPluginContext, IServerRTCRoomEntry, IReceivedMessage, ErrorCode, IJoinRTCRoomData, KVString, RTCJoinType, IRTCUserData, IRTCJoinedInfo, IPluginGenerator } from '@rongcloud/engine';
@@ -1318,6 +1318,41 @@ declare enum RCInnerCDNModel {
     STOP = 2
 }
 
+declare enum RCMixInputFilterMode {
+    /** 全合流，后续加入房间的用户会自动合流 */
+    AUDIO_VIDEO_ALL = 0,
+    /** 全不合流，后续加入本房间的用户 */
+    AUDIO_VIDEO_NO = 1,
+    /** 音频全订阅, 视频全不订阅 */
+    AUDIO_ALL_VIDEO_NO = 2,
+    /** 视频全订阅, 音频全不订阅 */
+    AUDIO_NO_VIDEO_ALL = 3,
+    /**
+     * 根据设置的音频合流列表和视频合流列表合并媒体流
+     */
+    AUDIO_VIDEO_INPUT = 4,
+    /** 音频全订阅，视频根据设置的视频合流列表 */
+    AUDIO_ALL_VIDEO_INPUT = 5,
+    /** 音频全不订阅, 视频根据input里面的视频项订阅 */
+    AUDIO_NO_VIDEO_INPUT = 6,
+    /** 视频全订阅, 音频根据input里面的音频项订阅 */
+    AUDIO_INPUT_VIDEO_ALL = 7,
+    /** 视频全不订阅, 音频根据input里面的音频项订阅 */
+    AUDIO_INPUT_VIDEO_NO = 8,
+    /** 按房间列表订阅音视频(保留当前已经订阅的, 但没在房间列表里的音视频) */
+    ROOM_AUDIO_VIDEO_APPEND = 9,
+    /** 按房间列表订阅音视频(清理当前已经订阅的, 但没在房间列表里的音视频) */
+    ROOM_AUDIO_VIDEO_NOT_APPEND = 10,
+    /** 按房间列表订阅音频, 不订阅视频(保留当前已经订阅的, 但没在房间列表里的音频) */
+    ROOM_AUDIO_APPEND = 11,
+    /** 按房间列表订阅音视, 不订阅视频(清理当前已经订阅的, 但没在房间列表里的音频) */
+    ROOM_AUDIO_NOT_APPEND = 12,
+    /** 按房间列表订阅视频, 不订阅音频(保留当前已经订阅的, 但没在房间列表里的视频) */
+    ROOM_VIDEO_APPEND = 13,
+    /** 按房间列表订阅视频, 不订阅音频(清理当前已经订阅的, 但没在房间列表里的视频) */
+    ROOM_VIDEO_NOT_APPEND = 14
+}
+
 /**
  * 合流后的 video 输出编码配置，包含分辨率、帧率、码率配置项
  */
@@ -1339,6 +1374,13 @@ interface IMCUOutputVideoAttrs {
      */
     bitrate?: number;
 }
+/**
+ * 合并入 MCU 的音频流
+ */
+interface IMCUInputAudio {
+    user_id: string;
+    stream_id: string;
+}
 /**
  * 自定义布局中的单一视频流布局
  */
@@ -1554,7 +1596,8 @@ interface IMCUConfig {
      * 自定义布局输入定义，只有在 mode 值为 `MixLayoutMode.CUSTOMIZE` 时需传值
      */
     input?: {
-        video: IMCUInputVideoLayout[];
+        video?: IMCUInputVideoLayout[];
+        audio?: IMCUInputAudio[];
     };
     /**
      * 合流后的媒体输出配置
@@ -1564,6 +1607,14 @@ interface IMCUConfig {
      * 水印配置
      */
     waterMark?: IMCUWaterMarkConfig;
+    /**
+     * 设置合流混入音频、视频的模式
+     */
+    inputFilterMode?: RCMixInputFilterMode;
+    /**
+     * MCU 混入列表中房间内的资源
+     */
+    mixRooms?: string[];
 }
 /**
  * 设置开启、停用内置 CDN 数据
@@ -2249,6 +2300,7 @@ declare class RCLivingPKHandler {
     leaveOtherRoom(room: RCLivingRoom, isQuitPK?: boolean): Promise<{
         code: RCRTCCode;
     }>;
+    private _leaveOtherRoom;
     /**
      * 获取连麦信息
      * @param roomId 连麦房间的 roomId
@@ -2273,6 +2325,11 @@ declare class RCLivingPKHandler {
     };
 }
 
+interface IPushOtherRooms {
+    roomId: string;
+    autoMix: boolean;
+    sessionId: string;
+}
 /**
  * 房间抽象基类
  */
@@ -2501,11 +2558,7 @@ declare abstract class RCAbstractRoom {
     /**
      * 获取跨房间连麦需携带参数 pushOtherRooms 的值
      */
-    protected _getPushOtherRoomsParams(): {
-        roomId: string;
-        sessionId: string;
-        autoMix: boolean;
-    }[] | undefined;
+    protected _getPushOtherRoomsParams(): IPushOtherRooms[];
     /**
      * ice 断线后，尝试重新走 exchange
      */
@@ -2798,6 +2851,34 @@ declare class RCMCUConfigBuilder {
      * 清除已添加的自定义布局中的视频流配置
      */
     clearCustomizeLayoutVideo(): RCMCUConfigBuilder;
+    /**
+     * 设置要合入 MCU 的音频
+     * @param trackIds 一组音频 trackId
+     */
+    setCustomInputAudio(trackIds: string[]): RCMCUConfigBuilder;
+    /**
+     * 清除某个已设置合入 MCU 的音频
+     * @param trackId 音频对应的 trackId
+     */
+    removeCustomInputAudio(trackId: string): RCMCUConfigBuilder;
+    /**
+     * 清除所有已设置合入 MCU 的音频
+     */
+    clearCustomInputAudio(): RCMCUConfigBuilder;
+    private _validateInputVideoParams;
+    /**
+     * 设置 MCU 混流配置
+     * @param videoList 视频输入混流列表，为 null 代表视频全混流，为空集合代表视频全不混流，否则按照输入列表进行混流
+     * @param audioList 音频输入混流列表，为 null 代表音频全混流，为空集合代表音频全不混流，否则按照输入列表进行混流
+     */
+    /**
+     * 设置 MCU 混流配置
+     * @param roomIds 混流房间列表
+     * @param mediaType 混流媒体类型
+     * @param isAppend 是否为增量混流
+     * * true 为增量混流
+     * * false 为全量覆盖混流
+     */
     /**
      * 使已修改的配置生效，在调用该方法前，所有数据只会对本地配置进行修改，不会产生实际效果
      */
@@ -2916,6 +2997,10 @@ declare class RCLivingRoom extends RCAbstractRoom {
      * 离开 PK 房间后，如果参与过连麦，pushOtherRooms 需去掉退出的连麦房间配置，重新和 mediaServer 交互
      */
     private _onLeavePKRoom;
+    /**
+     * @override
+     */
+    protected _getPushOtherRoomsParams(): IPushOtherRooms[];
     /**
      * 携带 pushOtherRooms 与 mediaServer 重新交互
      */