@rongcloud/plugin-rtc 5.4.3 → 5.4.4

package/dist/core/room/RCAudienceLivingRoom.d.ts

@@ -221,6 +221,10 @@ export default class RCAudienceLivingRoom {
         code: RCRTCCode;
         failedList?: ISubscribeAttr[];
     }>;
+    addSubscribeTask(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
     private __unsubscribe;
     /**
      * 取消订阅资源
@@ -230,6 +234,10 @@ export default class RCAudienceLivingRoom {
         code: RCRTCCode;
         failedList?: ISubscribeAttr[];
     }>;
+    addUnsubscribeTask(tracks: RCRemoteTrack[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
     /**
      * 退出房间并销毁当前房间实例，退出后该房间的所有方法将不可用
      */

package/dist/core/tracks/RC3AnoiseTrack.d.ts

@@ -0,0 +1,27 @@
+export default class RC3AnoiseTrack {
+    static workletModule: string;
+    static workletWasm: string;
+    static isOpen: boolean;
+    /**
+     * 该函数接受一个布尔值作为参数，如果没有传递参数，该函数将默认为 true
+     * @param {boolean} [isOpen=true] - 轨道是否开放。
+     */
+    static setStatus(isOpen?: boolean): void;
+    /**
+     * 它设置 worklet 模块和 wasm。
+     * @param {string} module - 将用于创建工作集的模块的名称。
+     * @param {string} wasm - Rust 编译器生成的 wasm 文件。
+     */
+    static setWroklet(module: string, wasm: string): void;
+    /**
+     * 它创建一个 AudioContext，从输入流创建一个 MediaStreamSource，
+     * 创建一个 MediaStreamDestination，创建一个 AudioWorkletNode，并将节点连接在一起。
+     * @param {MediaStream} audioStream - 媒体流
+     * @returns 一个媒体流对象。
+     */
+    static transformStreamTrack(audioStream: MediaStream): Promise<{
+        track: MediaStreamTrack;
+        stop: Function;
+    }>;
+}
+//# sourceMappingURL=RC3AnoiseTrack.d.ts.map

package/dist/core/tracks/RCLocalTrack.d.ts

@@ -61,6 +61,13 @@ export declare class RCLocalAudioTrack extends RCLocalTrack {
      * @param {number[]} args - [分钟，开始]
      */
     setBitrate(max: number, ...args: number[]): void;
+    protected _stopProcess: Function;
+    /**
+     * @override __innerSetMediaStreamTrack
+     * @params {track} MediaStreamTrack 添加音频流
+     * @params {track} undefined        销毁音频流
+     */
+    __innerSetMediaStreamTrack(track: MediaStreamTrack | undefined): void;
 }
 export declare class RCLocalVideoTrack extends RCLocalTrack {
     private _isTiny;
@@ -109,6 +116,13 @@ export declare class RCLocalFileAudioTrack extends RCLocalFileTrack {
     play(): Promise<{
         code: RCRTCCode;
     }>;
+    protected _stopProcess: Function;
+    /**
+     * @override __innerSetMediaStreamTrack
+     * @params {track} MediaStreamTrack 添加音频流
+     * @params {track} undefined        销毁音频流
+     */
+    __innerSetMediaStreamTrack(track: MediaStreamTrack | undefined): void;
 }
 export declare class RCMicphoneAudioTrack extends RCLocalAudioTrack {
 }

package/dist/core/tracks/RCRemoteTrack.d.ts

@@ -19,5 +19,11 @@ export declare class RCRemoteAudioTrack extends RCRemoteTrack {
 }
 export declare class RCRemoteVideoTrack extends RCRemoteTrack {
     constructor(tag: string, userId: string, roomId?: string);
+    private _isSubTiny;
+    __innerSetIsTinyTrack(bool: boolean): void;
+    /**
+     * 是否订阅的小流
+     */
+    isSubTiny(): boolean;
 }
 //# sourceMappingURL=RCRemoteTrack.d.ts.map

package/dist/core/tracks/RCTrack.d.ts

@@ -28,6 +28,11 @@ export declare abstract class RCTrack extends EventEmitter {
      */
     getUserId(): string;
     __innerGetMediaStreamTrack(): MediaStreamTrack | undefined;
+    /**
+     * 它返回 MediaStreamTrack 对象。
+     * @returns 表示媒体源的 MediaStreamTrack 对象。
+     */
+    get streamTrack(): (MediaStreamTrack | undefined);
     /**
      * 获取数据标识
      * @returns
@@ -72,7 +77,6 @@ export declare abstract class RCTrack extends EventEmitter {
     play(element?: HTMLVideoElement, options?: {
         volume?: number;
         audioDeviceId?: string;
-        autoplay: boolean;
     }): Promise<{
         code: RCRTCCode;
     }>;

package/dist/core/webrtc/RCRTCPeerCManager.d.ts

@@ -74,6 +74,8 @@ export default class RCRTCPeerCManager {
     private _createOnePeerCItem;
     /**
      * 创建一组 peerC
+     * 为了适应多 peerConnection 的场景做出的冗余设计，对单 peerConnection 进行数组进行封装
+     * 提示：useMutilPeerC 用户自定义的，没有明确场景，必须使用多 peerConnection
      * @param pcName
      * @returns
      */

package/dist/core/webrtc/RCRTCPeerConnection.d.ts

@@ -32,6 +32,7 @@ export default class RCRTCPeerConnection extends EventEmitter {
     private _reTryExchangeTimer;
     private _reportStatsTimer;
     private _reportR3R4ToPolarisTimer;
+    private _isDestroyed;
     constructor(
     /**
      * peerConnection 对应名称
@@ -106,5 +107,6 @@ export default class RCRTCPeerConnection extends EventEmitter {
     getRTCPeerConn(): RTCPeerConnection;
     destroy(): void;
     clearReTryExchangeTimer(): void;
+    isDestroyed(): boolean;
 }
 //# sourceMappingURL=RCRTCPeerConnection.d.ts.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /*
- * RCRTC - v5.4.3
- * CommitId - 14f0acc9bca79c93547703c573d297dbd301594c
- * Tue Aug 02 2022 09:57:21 GMT+0800 (China Standard Time)
+ * RCRTC - v5.4.4
+ * CommitId - bc1f8f530851278c199d53868ad7c199d465f45e
+ * Tue Aug 09 2022 15:25:48 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
 import { EventEmitter, RTCMode, IRuntime, RTCPluginContext, IJoinRTCRoomData, IReceivedMessage, ErrorCode, RTCJoinType, IRTCUserData, KVString, IServerRTCRoomEntry, LogLevel, IRTCJoinedInfo, IPluginGenerator } from '@rongcloud/engine';
@@ -50,7 +50,7 @@ declare enum RCRTCCode {
     /** 获取屏幕共享流失败 */
     GET_DISPLAY_MEDIA_FAILED = 53011,
     /** 权限问题导致获取媒体流被拒绝 */
-    PERMISSION_DENIED = 53012,
+    BROWSER_PERMISSION_DENIED = 53012,
     /** 创建自定义流失败 */
     CREATE_CUSTOM_TRACK_FAILED = 53013,
     /** 无效的 TAG 定义 */
@@ -90,7 +90,9 @@ declare enum RCRTCCode {
     /** 资源没有全部发成功 */
     SOME_TRACKS_PUBLISH_FAILED = 53031,
     /** electron 中 mac 系统暂不支持屏幕共享采集声音 */
-    MAC_IN_ELECTRON_NOT_SUPPORT_SCREEN_SHARE_WITH_AUDIO = 53032
+    MAC_IN_ELECTRON_NOT_SUPPORT_SCREEN_SHARE_WITH_AUDIO = 53032,
+    /** 获取媒体资源时，无系统权限 */
+    SYSTEM_PERMISSION_DENIED = 53033
 }
 
 /**
@@ -172,6 +174,11 @@ declare abstract class RCTrack extends EventEmitter {
      */
     getUserId(): string;
     __innerGetMediaStreamTrack(): MediaStreamTrack | undefined;
+    /**
+     * 它返回 MediaStreamTrack 对象。
+     * @returns 表示媒体源的 MediaStreamTrack 对象。
+     */
+    get streamTrack(): (MediaStreamTrack | undefined);
     /**
      * 获取数据标识
      * @returns
@@ -216,7 +223,6 @@ declare abstract class RCTrack extends EventEmitter {
     play(element?: HTMLVideoElement, options?: {
         volume?: number;
         audioDeviceId?: string;
-        autoplay: boolean;
     }): Promise<{
         code: RCRTCCode;
     }>;
@@ -333,6 +339,13 @@ declare class RCLocalAudioTrack extends RCLocalTrack {
      * @param {number[]} args - [分钟，开始]
      */
     setBitrate(max: number, ...args: number[]): void;
+    protected _stopProcess: Function;
+    /**
+     * @override __innerSetMediaStreamTrack
+     * @params {track} MediaStreamTrack 添加音频流
+     * @params {track} undefined        销毁音频流
+     */
+    __innerSetMediaStreamTrack(track: MediaStreamTrack | undefined): void;
 }
 declare class RCLocalVideoTrack extends RCLocalTrack {
     private _isTiny;
@@ -381,6 +394,13 @@ declare class RCLocalFileAudioTrack extends RCLocalFileTrack {
     play(): Promise<{
         code: RCRTCCode;
     }>;
+    protected _stopProcess: Function;
+    /**
+     * @override __innerSetMediaStreamTrack
+     * @params {track} MediaStreamTrack 添加音频流
+     * @params {track} undefined        销毁音频流
+     */
+    __innerSetMediaStreamTrack(track: MediaStreamTrack | undefined): void;
 }
 declare class RCMicphoneAudioTrack extends RCLocalAudioTrack {
 }
@@ -411,6 +431,12 @@ declare class RCRemoteAudioTrack extends RCRemoteTrack {
 }
 declare class RCRemoteVideoTrack extends RCRemoteTrack {
     constructor(tag: string, userId: string, roomId?: string);
+    private _isSubTiny;
+    __innerSetIsTinyTrack(bool: boolean): void;
+    /**
+     * 是否订阅的小流
+     */
+    isSubTiny(): boolean;
 }
 
 /**
@@ -566,7 +592,11 @@ declare enum RCRTCMessageType {
     /**
      * 连麦的房间不再了或离线了，主直播房间会收到的消息通知
      */
-    OTHER_ROOM_OFFLINE = "RCRTC:otherRoomOffline"
+    OTHER_ROOM_OFFLINE = "RCRTC:otherRoomOffline",
+    /**
+     * 订阅、取消订阅动作成功
+     */
+    ROOM_TASK_FINISH = "RCRTC:roomTaskFinish"
 }
 
 declare enum RCInnerCDNPushMode {
@@ -1248,6 +1278,18 @@ declare enum RCLivingType {
     AUDIO = 1
 }
 
+declare enum RCCommandKind {
+    Unknow = 0,
+    Publish = 1,
+    UnPublish = 2,
+    JoinRoom = 3,
+    LeaveRoom = 4,
+    UpdateSubscribeTask = 5,
+    SubscribedTask = 6,
+    UnSubscribedTask = 7,
+    AsyncCommand = "AsyncCommand"
+}
+
 declare class RCRTCPeerCManager {
     /**
      * 是否使用多 peerConnection
@@ -1321,6 +1363,8 @@ declare class RCRTCPeerCManager {
     private _createOnePeerCItem;
     /**
      * 创建一组 peerC
+     * 为了适应多 peerConnection 的场景做出的冗余设计，对单 peerConnection 进行数组进行封装
+     * 提示：useMutilPeerC 用户自定义的，没有明确场景，必须使用多 peerConnection
      * @param pcName
      * @returns
      */
@@ -1422,12 +1466,13 @@ declare abstract class ReadableStore {
      * 远端 track
      */
     protected _remoteTracks: {
-        [trackId: string]: RCRemoteTrack;
+        [trackId: string]: RCRemoteAudioTrack | RCRemoteVideoTrack;
     };
     /**
      * 已订阅参数
      */
-    protected readonly _subscribedList: ISubscribeAttr[];
+    protected _subscribedList: ISubscribeAttr[];
+    protected _collectSubscribeList: ISubscribeAttr[];
     /**
      * 与 MediaServer 交互需要的 token 信息
      */
@@ -1448,12 +1493,13 @@ declare abstract class ReadableStore {
     getRemoteTrack(trackId: string): RCRemoteTrack | undefined;
     getRemoteTracksByUserId(userId: string): RCRemoteTrack[];
     getRemoteTracks(): {
-        [trackId: string]: RCRemoteTrack;
+        [trackId: string]: RCRemoteAudioTrack | RCRemoteVideoTrack;
     };
     getSessionId(): string;
     getAllUserIds(): string[];
     getRemoteUserIds(): string[];
     getSubscribedList(): ISubscribeAttr[];
+    getCollectSubscribeList(): ISubscribeAttr[];
     getPublishedResourceByTrackId(trackId: string): IPublishedResource | undefined;
     getToken(): string;
     getLocalTrack(trackId: string): RCLocalTrack | null;
@@ -1473,6 +1519,8 @@ declare class Store extends ReadableStore {
     removeRemoteTracks(): void;
     setCDNEnabel(bool: boolean): void;
     setCDNUris(uris: ICDNUris | null): void;
+    resetSubscribedList(subscribeList: ISubscribeAttr[]): void;
+    resetCollectSubscribeList(collectSubscribeList: ISubscribeAttr[]): void;
 }
 
 declare enum CommandPriority {
@@ -1493,6 +1541,11 @@ declare abstract class BaseCommand<RES, STORE = Store> {
      * 获取指令优先级，必要时可 override 此函数
      */
     get priority(): CommandPriority;
+    /**
+     * 它返回命令的种类。
+     * @returns 命令的种类。
+     */
+    get kind(): RCCommandKind;
 }
 
 declare class BaseInvoker<STORE> {
@@ -1519,6 +1572,14 @@ declare class BaseInvoker<STORE> {
     private _execute;
     push<R>(command: BaseCommand<R, STORE>): Promise<R>;
     private _isDestroyed;
+    /**
+     * 查找出 RCCommandKind.AsyncCommand 类型的 Command，并将其从队列中删除
+     * 并使用最新的一次 Command 接管它的 resolve & reject
+     * @param resolve
+     * @param reject
+     * @returns 具有两个属性的对象，resolve 和 reject。
+     */
+    private commandOffset;
     isDestroyed(): boolean;
     destroy(): void;
 }
@@ -1944,6 +2005,12 @@ declare abstract class RCAbstractRoom extends EventEmitter {
         code: RCRTCCode;
         failedList?: ISubscribeAttr[];
     }>;
+    /**
+     * 它将订阅任务添加到队列中。
+     * @param {(RCRemoteTrack | ISubscribeAttr)[]} tracks - (RCRemoteTrack | ISubscribeAttr)[]
+     * @returns 一个用代码和失败列表解析为对象的承诺。
+     */
+    addSubscribeTask(tracks: (RCRemoteTrack | ISubscribeAttr)[]): void;
     /**
      * 取消订阅资源
      * @param tracks 预取消远端资源
@@ -1952,6 +2019,27 @@ declare abstract class RCAbstractRoom extends EventEmitter {
         code: RCRTCCode;
         failedList?: ISubscribeAttr[];
     }>;
+    /**
+     * 它将取消订阅任务添加到队列中。
+     * @param {RCRemoteTrack[]} tracks - 要取消订阅的曲目。
+     * @returns 一个用代码和失败列表解析为对象的承诺。
+     */
+    addUnsubscribeTask(tracks: RCRemoteTrack[]): void;
+    /**
+     * 强制修改订阅列表，仅订阅数组中的资源，取消订阅其他已订阅资源。
+     * 当参数为 `[]` 时，意味着不再订阅任何资源
+     * @param tracks 变更的资源列表
+     */
+    updateSubList(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
+    /**
+     * 将任务添加到任务队列的函数。
+     * @param {(RCRemoteTrack | ISubscribeAttr)[]} tracks - (RCRemoteTrack | ISubscribeAttr)[]
+     */
+    addUpdateSubscribeListTask(tracks: (RCRemoteTrack | ISubscribeAttr)[]): void;
+    private _onTaskCompleted;
     /**
      * 获取已发布的本地资源
      * @param trackId
@@ -1969,14 +2057,10 @@ declare abstract class RCAbstractRoom extends EventEmitter {
      */
     getRemoteTrack(trackId: string): RCRemoteTrack | null;
     /**
-     * 强制修改订阅列表，仅订阅数组中的资源，取消订阅其他已订阅资源。
-     * 当参数为 `[]` 时，意味着不再订阅任何资源
-     * @param tracks 变更的资源列表
+     * 获取当前已经订阅的全量资源
+     * returns subscribedTracks ISubscribeAttr[]
      */
-    updateSubList(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
-        code: RCRTCCode;
-        failedList?: ISubscribeAttr[];
-    }>;
+    get subscribedTracks(): ISubscribeAttr[];
     private _appListener;
     /**
      * 注册事件监听器，多次注册会导致后者覆盖前者，可以通过使用 `registerRoomEventListener(null)` 取消注册
@@ -2239,6 +2323,10 @@ declare class RCAudienceLivingRoom {
         code: RCRTCCode;
         failedList?: ISubscribeAttr[];
     }>;
+    addSubscribeTask(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
     private __unsubscribe;
     /**
      * 取消订阅资源
@@ -2248,6 +2336,10 @@ declare class RCAudienceLivingRoom {
         code: RCRTCCode;
         failedList?: ISubscribeAttr[];
     }>;
+    addUnsubscribeTask(tracks: RCRemoteTrack[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
     /**
      * 退出房间并销毁当前房间实例，退出后该房间的所有方法将不可用
      */
@@ -2409,6 +2501,7 @@ declare class RCRTCPeerConnection extends EventEmitter {
     private _reTryExchangeTimer;
     private _reportStatsTimer;
     private _reportR3R4ToPolarisTimer;
+    private _isDestroyed;
     constructor(
     /**
      * peerConnection 对应名称
@@ -2483,6 +2576,7 @@ declare class RCRTCPeerConnection extends EventEmitter {
     getRTCPeerConn(): RTCPeerConnection;
     destroy(): void;
     clearReTryExchangeTimer(): void;
+    isDestroyed(): boolean;
 }
 
 interface IRCTrackBitrate {
@@ -2879,6 +2973,14 @@ interface IRoomEventListener extends IRCRTCTrackEventListener {
      * 主播和观众切换身份通知
      */
     onSwitchRole?(userId: string, role: RCRTCLiveRole): void;
+    /**
+     * 房间任务完成时调用的函数。
+     * @param code 任务完成后的状态
+     * @param subscribe 订阅成功的列表
+     * @param unsubscribe 取消订阅成功的列表
+     * @param failedList 订阅失败的列表
+     */
+    onTaskCompleted?(code: RCRTCCode, subscribe: ISubscribeAttr[], unsubscribe: ISubscribeAttr[], failedList: ISubscribeAttr[]): void;
 }
 /**
  * RTCClient 初始化配置
@@ -2926,6 +3028,17 @@ interface IRCRTCInitOptions {
      * 观众拉内置 CDN 资源时是否使用 https，默认为 RCInnerCDNPullIsHttps.HTTPS
      */
     pullInnerCDNUseHttps?: RCInnerCDNPullIsHttps;
+    /**
+     * 音频降噪处理
+     * - workletModule 默认值为 https://cdn.ronghub.com/plugin-rtc/wasm/5.0.0-alpha.1/process-worklet.js
+     * - workletWasm 默认值为 https://cdn.ronghub.com/plugin-rtc/wasm/5.0.0-alpha.1/AudioProcessing.wasm
+     * - isOpen 默认值为 false
+     */
+    audio?: {
+        workletModule?: string;
+        workletWasm?: string;
+        isOpen?: boolean;
+    };
 }
 interface ICameraVideoProfile extends IVideoProfile {
     cameraId?: string;