@rongcloud/plugin-rtc 5.6.11 → 5.6.12

package/dist/index.d.ts

@@ -236,7 +236,7 @@ declare abstract class RCTrack extends EventEmitter {
      * 发布者是否已禁用该轨道数据，在 RCLocalTrack 实例中，则其值始终等于 `isLocalMuted()`
      */
     isOwnerMuted(): boolean;
-    private _element?;
+    protected _element?: HTMLMediaElement;
     /**
      * 播放
      * @param element 用于承载媒体流的元素标签，音频流可传空
@@ -441,7 +441,7 @@ declare class RCScreenVideoTrack extends RCLocalVideoTrack {
 declare class RCScreenAudioTrack extends RCLocalAudioTrack {
 }
 
-declare class RCRemoteTrack extends RCTrack {
+declare abstract class RCRemoteTrack extends RCTrack {
     constructor(logger: BasicLogger, tag: string, userId: string, kind: 'audio' | 'video', roomId?: string);
     /**
      * 根据房间数据更新状态
@@ -458,6 +458,12 @@ declare class RCRemoteTrack extends RCTrack {
 }
 declare class RCRemoteAudioTrack extends RCRemoteTrack {
     constructor(logger: BasicLogger, tag: string, userId: string, roomId?: string);
+    /**
+     * 获取播放时指定的输出音量。若当前未播放，则返回 0。
+     * 注意：该音量为对媒体输出设备设定的输出音量，与当前音频内容的 audioLevel 是不同概念。
+     * @since - v5.6.12
+     */
+    getVolume(): number;
 }
 declare class RCRemoteVideoTrack extends RCRemoteTrack {
     constructor(logger: BasicLogger, tag: string, userId: string, roomId?: string);
@@ -1065,8 +1071,8 @@ declare abstract class ReadableStore {
     protected _roomStatusVersion: number;
     constructor(_logger: BasicLogger, clientSessionId: string, appkey: string, roomId: string, crtUserId: string, roomMode: RTCMode, isUpgrade?: boolean | undefined, isMainRoom?: boolean | undefined);
     getResourcesByUserId(userId: string): IPublishedResource[] | undefined;
-    getRemoteTrack(trackId: string): RCRemoteTrack | undefined;
-    getRemoteTracksByUserId(userId: string): RCRemoteTrack[];
+    getRemoteTrack(trackId: string): RCRemoteAudioTrack | RCRemoteVideoTrack | undefined;
+    getRemoteTracksByUserId(userId: string): (RCRemoteAudioTrack | RCRemoteVideoTrack)[];
     getRemoteTracks(): {
         [trackId: string]: RCRemoteAudioTrack | RCRemoteVideoTrack;
     };
@@ -1095,7 +1101,7 @@ declare class Store extends ReadableStore {
     setResourcesByUserId(userId: string, arr: IPublishedResource[]): void;
     removeRemoteTrack(trackId: string): void;
     removeResourcesByUserId(userId: string): void;
-    addRemoteTrack(track: RCRemoteTrack): void;
+    addRemoteTrack(track: RCRemoteAudioTrack | RCRemoteVideoTrack): void;
     removeRemoteTracks(): void;
     setCDNEnabel(bool: boolean): void;
     setCDNUris(uris: ICDNUris | null): void;
@@ -3697,7 +3703,7 @@ declare class RCLivingPKHandler {
      * 发起跨房间连麦请求
      * @param inviteeRoomId 被邀请者所处的房间 roomId
      * @param inviteeUserId 被邀请者 userId
-     * @param options.autoMix 是否要把邀请者发布的资源，合并到被邀请者房间内的 MCU 流中
+     * @param options.autoMix 是否将本房间资源合并到被邀请者所处房间的 MCU 合流中
      * @param options.extra 拓展字段，可随邀请连麦消息透传给被邀请者
      */
     requestJoinOtherRoom(inviteeRoomId: string, inviteeUserId: string, options?: IReqResPKOptions): Promise<{
@@ -3717,7 +3723,7 @@ declare class RCLivingPKHandler {
      * @param inviterRoomId 邀请者所处的房间 roomId
      * @param inviterUserId 邀请者 userId
      * @param agree 是否同意连麦
-     * @param options.autoMix 是否要把被邀请者发布的资源，合并到邀请者房间内的 MCU 流中
+     * @param options.autoMix 是否将本房间资源合并到邀请者所处房间的 MCU 合流中
      * @param options.extra 附加信息，可随响应连麦消息透传给邀请者
      */
     responseJoinOtherRoom(inviterRoomId: string, inviterUserId: string, agree: boolean, options?: IReqResPKOptions): Promise<{
@@ -4053,7 +4059,7 @@ declare abstract class RCAbstractRoom extends EventEmitter {
      * @param trackId
      * @returns
      */
-    getRemoteTrack(trackId: string): RCRemoteTrack | null;
+    getRemoteTrack(trackId: string): RCRemoteAudioTrack | RCRemoteVideoTrack | null;
     /**
      * 获取当前已经订阅的全量资源
      * returns subscribedTracks ISubscribeAttr[]
@@ -4073,8 +4079,8 @@ declare abstract class RCAbstractRoom extends EventEmitter {
     registerReportListener(listener: IRCRTCReportListener | null): void;
     /**
      * 音量上报
-     * @param handler 业务端传入的音量上报事件
-     * @param _ - 参数已废弃~~上报时间间隔~~
+     * @param handler 音量事件监听函数
+     * @param _ - 参数已废弃，SDK 默认以每秒一次进行回调~~上报时间间隔~~
      */
     onAudioLevelChange(handler: IAudioLevelChangeHandler | null, _?: number): void;
     /**