@rongcloud/plugin-rtc 5.2.0 → 5.3.0-rtc-roompk.1

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /*
- * RCRTC - v5.2.0
- * CommitId - 27226fbbbef2026b2edca09abaac95119171062e
- * Fri Oct 22 2021 16:15:52 GMT+0800 (China Standard Time)
+ * RCRTC - v5.3.0-rtc-roompk.1
+ * CommitId - 381b45b74bd1cee88cf1e6e79108809734bb17ea
+ * Sat Dec 25 2021 01:21:26 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
-import { EventEmitter, LogLevel, RTCMode, IRuntime, RTCPluginContext, IServerRTCRoomEntry, IJoinRTCRoomData, IReceivedMessage, KVString, RTCJoinType, IRTCJoinedInfo, IPluginGenerator } from '@rongcloud/engine';
+import { EventEmitter, LogLevel, RTCMode, IRuntime, RTCPluginContext, IServerRTCRoomEntry, IReceivedMessage, IJoinRTCRoomData, KVString, RTCJoinType, IRTCJoinedInfo, IPluginGenerator } from '@rongcloud/engine';
 export { RTCJoinType } from '@rongcloud/engine';
 
 /**
@@ -84,7 +84,9 @@ declare enum RCRTCCode {
     /** 加入 RTC 房间 joinTYype 为 1 时，当前有其他端在房间时的应答码 */
     SIGNAL_JOIN_RTC_ROOM_REFUSED = 53028,
     /** 设置音频输出设备时，无权限使用请求的设备 */
-    NO_PERMISSION_TO_USE_REQUESTED_DEVICE = 53029
+    NO_PERMISSION_TO_USE_REQUESTED_DEVICE = 53029,
+    /** 方法在 PK 房间上不可用 */
+    THE_FUNCTION_IS_DISABLED_IN_PKROOM = 53030
 }
 
 /**
@@ -910,6 +912,70 @@ interface IAudioLevelChangeHandler {
 declare type RoomData = {
     [userId: string]: IPublishedResource[];
 };
+interface IReqRoomPKOptions {
+    autoMix?: boolean;
+    extra?: string;
+}
+interface IPKInviterBaseInfo {
+    /**
+     * 邀请者房间 ID
+     */
+    inviterRoomId: string;
+    /**
+     * 邀请者用户 ID
+     */
+    inviterUserId: string;
+}
+interface IPKInviteeBaseInfo {
+    /**
+     * 被邀请者房间 ID
+     */
+    inviteeRoomId: string;
+    /**
+     * 被邀请者用户 ID
+     */
+    inviteeUserId: string;
+}
+interface IPKInviteInfo extends IPKInviterBaseInfo {
+    /**
+     * 邀请额外信息
+     */
+    extra?: string;
+}
+interface IPKInviteAnswerInfo extends IPKInviterBaseInfo, IPKInviteeBaseInfo {
+    /**
+     * 是否同意邀请
+     */
+    agree: boolean;
+    /**
+     * 响应额外信息
+     */
+    extra?: string;
+}
+interface IPKEndInfo {
+    /**
+     * 发起结束的房间 ID
+     */
+    endRoomId: string;
+    /**
+     * 发起结束的用户 ID
+     */
+    endUserId: string;
+}
+/**
+ * 观众加房间返回给客户的数据
+ */
+interface IAudienceJoinRoomResInfo {
+    remoteUserIds: string[];
+    remoteRTCTracks: RCRemoteTrack[];
+    remoteMCUTracks: RCRemoteTrack[];
+    remoteTracks: RCRemoteTrack[];
+    CDNUris: {
+        resolution?: RCResolution;
+        fps?: RCFrameRate;
+        CDNEnable?: boolean;
+    };
+}
 
 declare enum RCInnerCDNPushMode {
     AUTOMATIC = 0,
@@ -999,7 +1065,7 @@ interface IExchangeReqBody {
         /**
          * 是否默认合流
          */
-        automix: boolean;
+        autoMix: boolean;
         /**
          * 房间 Id 对应的 SessionId
          */
@@ -1076,6 +1142,15 @@ interface IExchangeResponse extends IRTCResponse {
      * 主播发布为具体资源，会议模式为空数组
      */
     mcuPublishList?: IResource[];
+    /**
+     * 订阅成功的资源
+     */
+    subscribedList?: {
+        mediaType: RCMediaType.AUDIO_ONLY | RCMediaType.VIDEO_ONLY;
+        msid: string;
+        userId: string;
+        simulcast?: RCStreamType;
+    }[];
 }
 interface IBroadcastSubReqBody {
     /**
@@ -1677,9 +1752,21 @@ declare class RCAudienceLivingRoom {
     private readonly _joinResData;
     readonly _livingType: RCLivingType;
     private readonly _service;
+    /**
+     * 主播列表
+     */
     private _roomAnchorList;
+    /**
+     * 合流、分流资源
+     */
     private _roomRes;
+    /**
+     * 主播分流资源
+     */
     private _roomAnchorRes;
+    /**
+     * 合流、分流 remoteTracks
+     */
     private _remoteTracks;
     private _appListener;
     private _pc;
@@ -1700,8 +1787,12 @@ declare class RCAudienceLivingRoom {
     private _CDNUris;
     constructor(_context: RTCPluginContext, _runtime: IRuntime, _initOptions: IRCRTCInitOptions, _roomId: string, _joinResData: {
         token: string;
-        kvEntries?: IServerRTCRoomEntry[];
+        kvEntries: IServerRTCRoomEntry[];
     }, _livingType: RCLivingType);
+    /**
+     * 解析服务端返回的 KV 数据，赋值 room 内数据
+     */
+    private _setInitData;
     protected _assertRoomDestroyed(): RCRTCCode | undefined;
     /**
      * @description 信令数据处理
@@ -1760,8 +1851,7 @@ declare class RCAudienceLivingRoom {
     private _diffCDNUris;
     /**
      * 获取 CDN 资源对应的拉流地址
-     * 首次获取 CDNPlayUrl 时，需传入 url，
-     * 业务层调用时使用内存中 _CDNUris 的 url，无 _CDNUris 时说明观众端未赋值过 _CDNUris
+     * _CDNUris 无 url 时，说明未开启 CDN 推送
      * @returns CDNPlayUrl
      */
     private _getCDNPlayUrl;
@@ -1779,6 +1869,7 @@ declare class RCAudienceLivingRoom {
      */
     subscribe(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     private __unsubscribe;
     /**
@@ -1787,6 +1878,7 @@ declare class RCAudienceLivingRoom {
      */
     unsubscribe(tracks: RCRemoteTrack[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     /**
      * 退出房间并销毁当前房间实例，退出后该房间的所有方法将不可用
@@ -1853,6 +1945,26 @@ declare class RCAudienceLivingRoom {
      * @returns
      */
     getRemoteTracks(): RCRemoteTrack[];
+    /**
+     * 获取远端 RTC tracks
+     */
+    getRemoteRTCTracks(): RCRemoteTrack[];
+    /**
+     * 获取远端 MCU tracks
+     */
+    getRemoteMCUTracks(): RCRemoteTrack[];
+    /**
+     * 获取房间内 CDN 信息
+     */
+    getCDNInfo(): {
+        resolution: RCResolution;
+        fps: RCFrameRate;
+        CDNEnable: boolean | undefined;
+    } | {
+        CDNEnable: boolean;
+        resolution?: undefined;
+        fps?: undefined;
+    };
 }
 
 /**
@@ -1973,6 +2085,149 @@ declare class RCRTCPeerConnection extends EventEmitter {
     clearReTryExchangeTimer(): void;
 }
 
+declare type IOnRecvPKMsg = (msg: IReceivedMessage) => void;
+interface IRoomPKEventListener {
+    /**
+     * 收到连麦 PK 邀请
+     */
+    onRequestJoinOtherRoom: (info: IPKInviteInfo) => {};
+    /**
+     * 收到连麦 PK 邀请取消
+     */
+    onCancelRequestOtherRoom: (info: IPKInviteInfo) => {};
+    /**
+     * 收到连麦 PK 请求响应结果
+     */
+    onResponseJoinOtherRoom: (info: IPKInviteAnswerInfo) => {};
+    /**
+     * 收到 PK 结束
+     */
+    onFinishOtherRoom: (info: IPKEndInfo) => {};
+}
+declare class RCLivingPKHandler {
+    private readonly _context;
+    private readonly _runtime;
+    private readonly _service;
+    private readonly _initOptions;
+    /**
+     * 主直播房间
+     */
+    private readonly _mainLivingRoom;
+    private readonly _registerPKMsgListener;
+    /**
+     * 加入 PK 房间回调
+     */
+    private readonly _onJoinedPKRoom;
+    /**
+     * 退出 PK 房间回调
+     */
+    private readonly _onLeavePKRoom;
+    /**
+     * PK 邀请超时时间
+     */
+    private readonly _inviteTimeout;
+    /**
+     * PK 房间信息
+     */
+    private _PKInfo;
+    private _appListener;
+    private _mainRoomId;
+    /**
+     * 跨房间连麦加入的 PK 房间
+     */
+    private _joinedPKRooms;
+    constructor(_context: RTCPluginContext, _runtime: IRuntime, _service: RCMediaService, _initOptions: IRCRTCInitOptions, 
+    /**
+     * 主直播房间
+     */
+    _mainLivingRoom: RCLivingRoom, _registerPKMsgListener: (listener: IOnRecvPKMsg) => void, 
+    /**
+     * 加入 PK 房间回调
+     */
+    _onJoinedPKRoom: (roomId: string, room: RCLivingRoom) => void, 
+    /**
+     * 退出 PK 房间回调
+     */
+    _onLeavePKRoom: (roomId: string) => void);
+    private _callAppListener;
+    private _onInvite;
+    private _onCancelInvite;
+    private _onInviteTimeout;
+    private _onInviteAnswer;
+    private _onPKEnd;
+    /**
+     * 处理跨房间连麦相关消息
+     */
+    private _onRecvPKMsg;
+    /**
+     * 跨房间连麦 PK 事件注册
+     */
+    registerRoomPKEventListener(listener: IRoomPKEventListener): void;
+    /**
+     * 发起跨房间连麦请求
+     * @param inviteeRoomId 被邀请者所处的房间 ID
+     * @param inviteeUserId 被邀请者 ID
+     * @param options.autoMix 被邀请者的发布的资源在服务侧是否自动合流
+     * @param options.extra 拓展字段，用于邀请数据透传
+     */
+    requestJoinOtherRoom(inviteeRoomId: string, inviteeUserId: string, options?: IReqRoomPKOptions): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 取消跨房间连麦 PK 请求
+     */
+    cancelRequestJoinOtherRoom(inviteeRoomId: string, inviteeUserId: string, extra?: string): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 跨房间连麦 PK 响应
+     */
+    responseJoinOtherRoom(inviterRoomId: string, inviterUserId: string, agree: boolean, options?: IReqRoomPKOptions): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 结束跨房间连麦 PK
+     * @param roomId 需要退出 PK 的房间 ID
+     */
+    private _quitRoomPK;
+    private _relaseCrtRoom;
+    /**
+     * 加入 PK 直播房间
+     * @roomId PK 房间 ID
+     */
+    joinOtherRoom(roomId: string): Promise<{
+        code: RCRTCCode;
+        room?: RCLivingRoom;
+        userIds?: string[];
+        tracks?: RCRemoteTrack[];
+        CDNEnable?: boolean;
+    }>;
+    /**
+     * 退出 PK 直播房间房间
+     * @param room 要离开的 PK 房间 room 实例
+     */
+    leaveOtherRoom(room: RCLivingRoom, isQuitPK?: boolean): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 获取 _PKInfo
+     */
+    getPKInfo(roomId: string): {
+        inviteSessionId: string;
+        inviterRoomId: string;
+        inviterUserId: string;
+        inviterUserAutoMix?: boolean | undefined;
+        inviteeRoomId: string;
+        inviteeUserAutoMix?: boolean | undefined;
+    };
+    /**
+     * 获取已加入的 PK 房间
+     */
+    getJoinedPKRooms(): {
+        [roomId: string]: RCLivingRoom;
+    };
+}
+
 /**
  * 房间抽象基类
  */
@@ -1984,6 +2239,7 @@ declare abstract class RCAbstractRoom {
     protected readonly _service: RCMediaService;
     protected readonly _initOptions: IRCRTCInitOptions;
     private readonly _ntfClearRoomItem;
+    protected _isMainRoom?: boolean | undefined;
     /**
      * 房间资源数据
      */
@@ -1995,7 +2251,7 @@ declare abstract class RCAbstractRoom {
     /**
      * 已订阅参数
      */
-    private readonly _subscribedList;
+    protected readonly _subscribedList: ISubscribeAttr[];
     /**
      * 房间保活 rtcPing
      */
@@ -2011,7 +2267,7 @@ declare abstract class RCAbstractRoom {
     /**
      * PeerConnection 连接实例
      */
-    private readonly _pc;
+    protected readonly _pc: RCRTCPeerConnection;
     private _destroyed;
     /**
      * 北极星上报实例
@@ -2021,7 +2277,7 @@ declare abstract class RCAbstractRoom {
      * 音量上报实例
      */
     private _audioLevelReport;
-    constructor(_context: RTCPluginContext, _runtime: IRuntime, _roomId: string, data: IJoinRTCRoomData, _roomMode: RTCMode, _service: RCMediaService, _initOptions: IRCRTCInitOptions, _ntfClearRoomItem: Function, isUpgrade?: boolean);
+    constructor(_context: RTCPluginContext, _runtime: IRuntime, _roomId: string, data: IJoinRTCRoomData, _roomMode: RTCMode, _service: RCMediaService, _initOptions: IRCRTCInitOptions, _ntfClearRoomItem: Function, isUpgrade?: boolean, _isMainRoom?: boolean | undefined);
     private _initRemoteTracks;
     private _handlePingResult;
     /**
@@ -2241,6 +2497,7 @@ declare abstract class RCAbstractRoom {
      */
     subscribe(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     private __subscribe;
     /**
@@ -2249,6 +2506,7 @@ declare abstract class RCAbstractRoom {
      */
     unsubscribe(tracks: RCRemoteTrack[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     private __unsubscribe;
     protected _assertRoomDestroyed(): RCRTCCode | undefined;
@@ -2311,6 +2569,15 @@ declare abstract class RCAbstractRoom {
      * 销毁远端资源
      */
     private _removeRemoteTracks;
+    private _onRecvPKMsg;
+    /**
+     * 注册 PK 业务监听方法
+     */
+    protected _registerPKMsgListener(listener: IOnRecvPKMsg): void;
+    /**
+     * 退出 PK 房间
+     */
+    protected _quitPKRoom(): void;
 }
 
 /**
@@ -2488,13 +2755,25 @@ declare class RCMCUConfigBuilder {
  */
 declare class RCLivingRoom extends RCAbstractRoom {
     private _livingType;
+    /**
+     * 是否是主房间
+     */
+    protected _isMainRoom: boolean;
     readonly _mcuConfigBuilder: RCMCUConfigBuilder;
     /**
      * cdn_uris 信令扩散数据
      */
     private _CDNUris;
     private _CDNEnable;
-    constructor(context: RTCPluginContext, runtime: IRuntime, roomId: string, data: IJoinRTCRoomData, service: RCMediaService, initOptions: IRCRTCInitOptions, clientEvent: Function, _livingType: RCLivingType, isUpgrage?: boolean);
+    /**
+     * 跨房间连麦管理器
+     */
+    private readonly _roomPKHandler;
+    constructor(context: RTCPluginContext, runtime: IRuntime, roomId: string, data: IJoinRTCRoomData, service: RCMediaService, initOptions: IRCRTCInitOptions, clientEvent: Function, _livingType: RCLivingType, isUpgrage: boolean | undefined, 
+    /**
+     * 是否是主房间
+     */
+    _isMainRoom: boolean);
     getLivingType(): RCLivingType;
     /**
      * 获取 MCU 配置构建对象
@@ -2566,6 +2845,27 @@ declare class RCLivingRoom extends RCAbstractRoom {
      * @returns boolean
      */
     __getCDNPushMode(): RCInnerCDNPushMode | undefined;
+    /**
+     * 加入 PK 房间回调
+     */
+    private _onJoinedPKRoom;
+    private _onLeavePKRoom;
+    /**
+     * 携带 pushOtherRooms 与 mediaServer 重新交互
+     * @param roomId 副房间 roomId
+     */
+    private _exchangeWithPushOtherRoom;
+    /**
+     * 获取 PK 业务处理器
+     */
+    getRoomPKHandler(): {
+        code: RCRTCCode;
+        roomPKHandler?: RCLivingPKHandler;
+    };
+    /**
+     * 退出 PK 房间
+     */
+    protected _quitPKRoom(): void;
 }
 
 /**
@@ -2687,6 +2987,7 @@ declare class RCRTCClient {
      * 获取直播观众客户端
      */
     getAudienceClient(): RCAudienceClient;
+    private _getJoinedPKRooms;
     private _onIMStatusChange;
     private _onIMDisconnect;
     private _onIMUninit;
@@ -2797,6 +3098,7 @@ declare class RCRTCClient {
     joinLivingRoomAsAudience(roomId: string, livingType: RCLivingType): Promise<{
         room?: RCAudienceLivingRoom;
         code: RCRTCCode;
+        remoteInfo?: IAudienceJoinRoomResInfo;
     }>;
     /**
      * 观众退出并销毁当前房间实例，退出后该房间的所有方法将不可用
@@ -2819,13 +3121,13 @@ declare class RCRTCClient {
     downgradeToAudienceRoom(room: RCLivingRoom): Promise<{
         room?: RCAudienceLivingRoom;
         code: RCRTCCode;
+        remoteInfo?: IAudienceJoinRoomResInfo;
     }>;
     /**
      * 获取在房间内用户信息
-     * 当前仅能查自己
-     * @since version 5.1.5
+     * @since version 5.2.1
      */
-    getJoinedUserInfo(userId: string): Promise<{
+    getJoinedRoomInfo(): Promise<{
         code: RCRTCCode;
         data?: IRTCJoinedInfo[];
     }>;
@@ -2878,4 +3180,4 @@ declare const helper: {
     ifSupportScreenShare: typeof ifSupportScreenShare;
 };
 
-export { BackgroundPictureFillMode, ICameraVideoProfile, IMCUOutputConfig, IMCUOutputVideoConfig, IMicphoneAudioProfile, IPublishAttrs, IPublishedResource, IRCCandidatePairStat, IRCRTCInitOptions, IRCRTCReportListener, IRCRTCStateReport, IRCTrackStat, IRoomEventListener, ISubscribeAttr, IVideoProfile, MixLayoutMode, MixVideoRenderMode, RCAbstractRoom, RCAudienceClient, RCAudienceLivingRoom, RCCameraVideoTrack, RCFrameRate, RCInnerCDNPullIsHttps, RCInnerCDNPullKind, RCKickReason, RCLivingRoom, RCLivingType, RCLocalAudioTrack, RCLocalFileAudioTrack, RCLocalFileTrack, RCLocalFileVideoTrack, RCLocalTrack, RCLocalVideoTrack, RCMCUConfigBuilder, RCMediaType, RCMicphoneAudioTrack, RCRTCClient, RCRTCCode, RCRTCLiveRole, RCRTCPingResult, RCRTCRoom, RCRemoteAudioTrack, RCRemoteTrack, RCRemoteVideoTrack, RCResolution, RCScreenVideoTrack, RCTag, RCTrack, device, helper, installer };
+export { BackgroundPictureFillMode, ICameraVideoProfile, IMCUOutputConfig, IMCUOutputVideoConfig, IMicphoneAudioProfile, IPKEndInfo, IPKInviteAnswerInfo, IPKInviteInfo, IPublishAttrs, IPublishedResource, IRCCandidatePairStat, IRCRTCInitOptions, IRCRTCReportListener, IRCRTCStateReport, IRCTrackStat, IRoomEventListener, IRoomPKEventListener, ISubscribeAttr, IVideoProfile, MixLayoutMode, MixVideoRenderMode, RCAbstractRoom, RCAudienceClient, RCAudienceLivingRoom, RCCameraVideoTrack, RCFrameRate, RCInnerCDNPullIsHttps, RCInnerCDNPullKind, RCKickReason, RCLivingRoom, RCLivingType, RCLocalAudioTrack, RCLocalFileAudioTrack, RCLocalFileTrack, RCLocalFileVideoTrack, RCLocalTrack, RCLocalVideoTrack, RCMCUConfigBuilder, RCMediaType, RCMicphoneAudioTrack, RCRTCClient, RCRTCCode, RCRTCLiveRole, RCRTCPingResult, RCRTCRoom, RCRemoteAudioTrack, RCRemoteTrack, RCRemoteVideoTrack, RCResolution, RCScreenVideoTrack, RCTag, RCTrack, device, helper, installer };