@rongcloud/plugin-rtc 5.2.1 → 5.2.4

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /*
- * RCRTC - v5.2.1
- * CommitId - 39edcf1817086fcfcede93a3d4c3f2a35fd21932
- * Thu Nov 04 2021 18:37:16 GMT+0800 (China Standard Time)
+ * RCRTC - v5.2.4
+ * CommitId - d2c309074e678b96ebd403c0967994360e8b389c
+ * Fri Jan 28 2022 10:39:56 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';
@@ -910,6 +910,14 @@ interface IAudioLevelChangeHandler {
 declare type RoomData = {
     [userId: string]: IPublishedResource[];
 };
+/**
+ * 观众加房间返回给客户的 CDN 信息
+ */
+interface IJoinResCDNInfo {
+    resolution?: RCResolution;
+    fps?: RCFrameRate;
+    CDNEnable?: boolean;
+}
 
 declare enum RCInnerCDNPushMode {
     AUTOMATIC = 0,
@@ -1076,6 +1084,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 +1694,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 +1729,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 +1793,7 @@ declare class RCAudienceLivingRoom {
     private _diffCDNUris;
     /**
      * 获取 CDN 资源对应的拉流地址
-     * 首次获取 CDNPlayUrl 时，需传入 url，
-     * 业务层调用时使用内存中 _CDNUris 的 url，无 _CDNUris 时说明观众端未赋值过 _CDNUris
+     * _CDNUris 无 url 时，说明未开启 CDN 推送
      * @returns CDNPlayUrl
      */
     private _getCDNPlayUrl;
@@ -1779,6 +1811,7 @@ declare class RCAudienceLivingRoom {
      */
     subscribe(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     private __unsubscribe;
     /**
@@ -1787,6 +1820,7 @@ declare class RCAudienceLivingRoom {
      */
     unsubscribe(tracks: RCRemoteTrack[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     /**
      * 退出房间并销毁当前房间实例，退出后该房间的所有方法将不可用
@@ -1853,6 +1887,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;
+    };
 }
 
 /**
@@ -2241,6 +2295,7 @@ declare abstract class RCAbstractRoom {
      */
     subscribe(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     private __subscribe;
     /**
@@ -2249,6 +2304,7 @@ declare abstract class RCAbstractRoom {
      */
     unsubscribe(tracks: RCRemoteTrack[]): Promise<{
         code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
     }>;
     private __unsubscribe;
     protected _assertRoomDestroyed(): RCRTCCode | undefined;
@@ -2797,6 +2853,10 @@ declare class RCRTCClient {
     joinLivingRoomAsAudience(roomId: string, livingType: RCLivingType): Promise<{
         room?: RCAudienceLivingRoom;
         code: RCRTCCode;
+        userIds?: string[];
+        RTCTracks?: RCRemoteTrack[];
+        MCUTracks?: RCRemoteTrack[];
+        CDNUris?: IJoinResCDNInfo;
     }>;
     /**
      * 观众退出并销毁当前房间实例，退出后该房间的所有方法将不可用
@@ -2819,6 +2879,10 @@ declare class RCRTCClient {
     downgradeToAudienceRoom(room: RCLivingRoom): Promise<{
         room?: RCAudienceLivingRoom;
         code: RCRTCCode;
+        userIds?: string[];
+        RTCTracks?: RCRemoteTrack[];
+        MCUTracks?: RCRemoteTrack[];
+        CDNUris?: IJoinResCDNInfo;
     }>;
     /**
      * 获取在房间内用户信息