@rongcloud/plugin-rtc 5.7.5-alpha.4 → 5.7.7-alpha.1

package/dist/index.d.ts

@@ -348,10 +348,6 @@ declare abstract class RCLocalTrack extends RCTrack {
      * 本地流已销毁
      */
     static __INNER_EVENT_DESTROY__: string;
-    /**
-     * 内部发送两秒视频
-     */
-    static __INNER_SEND_TWO_SECONDS_VIDEO__: string;
     /**
      * track 是否被销毁
      */
@@ -506,6 +502,7 @@ declare abstract class RCRemoteTrack extends RCTrack {
 }
 declare class RCRemoteAudioTrack extends RCRemoteTrack {
     constructor(logger: BasicLogger, tag: string, userId: string, roomId?: string);
+    protected _setLocalMuted(bool: boolean): Promise<RCRTCCode>;
     /**
      * 获取播放时指定的输出音量。若当前未播放，则返回 0。
      * 注意：该音量为对媒体输出设备设定的输出音量，与当前音频内容的 audioLevel 是不同概念。
@@ -696,6 +693,10 @@ interface IExchangeReqBody {
      * server 根据网络动态切换大小流开关，默认为 `false`
      */
     switchstream: boolean;
+    /**
+     * 是否支持 ipv6
+     */
+    ipType: number;
 }
 interface ILiveUrls {
     /**
@@ -1247,17 +1248,28 @@ declare enum PullRoomStatusEvent {
     RESOURCECHANGE = 3
 }
 
-declare type RTCEncodedFrame = RTCEncodedAudioFrame | RTCEncodedVideoFrame;
-declare type RCEncryptFunction<T extends RTCEncodedFrame> = (data: T) => T;
+declare type RCEncryptFunction = (data: Uint8Array) => Uint8Array;
 interface IRCEncryptorHooks {
     /**
-     * 加密回调，用于接收待加密的 opus 音频和 h.264 视频帧数据
+     * @since 5.7.3
+     * 加密回调，用于接收待加密的音频二进制数据的 Uint8Array 类型数组
      */
-    decode: RCEncryptFunction<RTCEncodedFrame>;
+    decodeAudio: RCEncryptFunction;
     /**
-     * 解密回调，用于接收待解密的 opus 音频和 h.264 视频帧数据
+     * @since 5.7.3
+     * 加密回调，用于接收待加密的视频二进制数据的 Uint8Array 类型数组
      */
-    encode: RCEncryptFunction<RTCEncodedFrame>;
+    decodeVideo: RCEncryptFunction;
+    /**
+     * @since 5.7.3
+     * 解密回调，用于接收待解密的音频二进制数据的 Uint8Array 类型数组
+     */
+    encodeAudio: RCEncryptFunction;
+    /**
+     * @since 5.7.3
+     * 解密回调，用于接收待解密的视频二进制数据的 Uint8Array 类型数组
+     */
+    encodeVideo: RCEncryptFunction;
 }
 
 interface IRCTrackBitrate {
@@ -1511,10 +1523,6 @@ interface ISendTrackState extends IRCTrackStat {
      * 流状态(0:不可用, 1:可用)
      */
     trackState: TrackState;
-    /**
-     * 发送帧数
-     */
-    framesSent?: number;
 }
 /**
  * receive track 所有字段
@@ -1891,10 +1899,14 @@ interface IRoomEventListener extends IRCRTCTrackEventListener {
      */
     onUserJoin?(userIds: string[]): void;
     /**
-     * 人员退出
+     * 人员正常退出
      * @param userIds
      */
     onUserLeave?(userIds: string[]): void;
+    /**
+     * 人员离线退出
+     */
+    onUserOffline?(userIds: string[]): void;
     /**
      * 主播开启、停止推 CDN 状态通知
      */
@@ -1975,10 +1987,6 @@ interface IRCRTCInitOptions {
      * 加密机创建参数
      */
     encryptor?: IRCEncryptorHooks;
-    /**
-     * 是否开启 WebRTC 问题检测器，默认为 `false`
-     */
-    isOpenWebRTCIssueDetector?: boolean;
 }
 interface ICameraVideoProfile extends IVideoProfile {
     cameraId?: string;
@@ -2702,10 +2710,6 @@ declare class RCMediaService {
      * 请求超时时长
      */
     private readonly _timeout;
-    /**
-     * navi 中获取的媒体服务地址
-     */
-    private readonly _msInNavi;
     /**
      * 已失败的请求地址
      */
@@ -2723,16 +2727,11 @@ declare class RCMediaService {
      */
     private _configUrl;
     /**
-     * 嗅探中获取的媒体服务地址
-     */
-    private static isDetector;
-    /**
-     * 嗅探中获取的媒体服务地址
+     * 排好序的探测地址
      */
     private static msInDetector;
     private static detectorTime;
     private static detectValidMinute;
-    static jwtToken: string;
     private _msList;
     private _qualityMsList;
     private readonly _logger;
@@ -2745,19 +2744,33 @@ declare class RCMediaService {
      * 请求超时时长
      */
     _timeout?: number);
+    /**
+     * 是否需要嗅探
+     * im 未连接，无 navi 数据时，不需要嗅探
+     * 客户端手动配置 mediaServer 时，不需要嗅探
+     * navi 数据中 detectionServer 为空时，不需要嗅探
+     * navi 数据中 jwt 为空时，不需要嗅探
+     * 在探测有效期内不需要嗅探
+     * RCMediaService.detectorTime 为 0 时，代表未探测过，需要嗅探
+     */
+    isNededDetector(): boolean;
     detectorMediaSever(): void;
     /**
      *  地址探测
      *  RTC 初始化时检测是否可以拿到 navi，可以拿到开始嗅探
      *  拿不到等 IM 链接成功后，再回调中调用开始嗅探
      */
-    private _getDetectorUrls;
-    getNaviMS(): string[];
+    private _startDetector;
     /**
-     * _mslist 列表排序：[_clusterId, ping1, 主域名，ping2, ..., pingN, 备用域名list ]
+     * 清空 msList 列表，重新请求导航后需清空 msList 列表
+     */
+    clearMSList(): void;
+    getMsList(): string[];
+    /**
+     * _mslist 列表排序：[_clusterId, ping1DetectorUrl, 主域名, ping2DetectorUrl, ..., pingNDetectorUrl, 备用域名list ]
      * ping1 ：ping 结果返回最快值
      */
-    private setMediaServiceList;
+    private _sortMediaServiceList;
     /**
      * 配置 gzip 请求头和请求体
      */
@@ -2950,12 +2963,6 @@ declare class ReportMediaActionLogger {
     recordQualityIceStatusData(iceCandidatePair: IRCCandidatePairStat, status: RTCIceConnectionState, time: number): void;
 }
 
-declare enum RCEncoder {
-    VP8 = "VP8",
-    VP9 = "VP9",
-    H264 = "H264"
-}
-
 declare class RCLocalMediaStream {
     readonly msid: string;
     readonly mediaStream: MediaStream;
@@ -3398,7 +3405,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * 是否是房间内观众
      */
     private readonly _isRoomAudience;
-    private readonly _options;
     static __INNER_EVENT_TRACK_READY__: string;
     static __INNER_AUDIOLEVEL_CHANGE__: string;
     static __INNER_ICE_STATE_CHANGE__: string;
@@ -3412,7 +3418,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
     private _reportR3R4ToPolarisTimer;
     private _isDestroyed;
     private _formatStatsData?;
-    private _WebRTCIssueDetector?;
     constructor(_logger: BasicLogger, 
     /**
      * _reTryExchange 方法
@@ -3433,16 +3438,11 @@ declare class RCRTCPeerConnection extends EventEmitter {
     /**
      * 是否是房间内观众
      */
-    _isRoomAudience?: boolean, _options?: {
-        /**
-         * 是否启用自定义加密
-         */
-        encrypt: boolean;
-        /**
-         * 是否开启 WebRTC 问题检测器
-         */
-        isOpenWebRTCIssueDetector: boolean;
-    });
+    _isRoomAudience?: boolean, 
+    /**
+     * 是否启用自定义加密
+     */
+    encrypt?: boolean);
     getLocalTracks(): RCLocalTrack[];
     private _onConnectionStateChange;
     private startAutoExecute;
@@ -3504,13 +3504,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @param listener
      */
     registerReportListener(listener: IRCRTCReportListener | null): void;
-    /**
-     * 判断是否发送了两秒视频
-     * @param framesSent 发送帧数
-     * @param frameRate 发送帧率
-     * @param trackId
-     */
-    private _isSendTwoSecondsVideo;
     /**
      * 组装上行质量报告数据
      */
@@ -3542,17 +3535,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
      */
     __reportR3R4ToPolaris(): Promise<void>;
     getRTCPeerConn(): RTCPeerConnection;
-    /**
-     * 它返回一个 RTCRtpCodecCapability 对象数组，第一个元素是与传入的编码器类型匹配的元素
-     * @param {RCEncoder} encoder - RCEncoder.H264
-     * @returns 正在返回 RTCRtpCodecCapability[] 数组。
-     */
-    private getCapabilitiesCodes;
-    /**
-     * 它为视频流设置编码器首选项。
-     * @param {RCEncoder} [encoder] - RC编码器
-     */
-    setEncoderPreferences(encoder?: RCEncoder): Promise<void>;
     /**
      * 关闭 RTCPeerConnection 连接。其生命周期：
      * 1. 连接生命周期与房间实例一致（包含观众加房间），仅在退出房间时进行关闭。
@@ -5059,4 +5041,4 @@ declare const helper: {
     ifSupportScreenShare: typeof ifSupportScreenShare;
 };
 
-export { BackgroundPictureFillMode, IAudienceRoomEventListener, IAudioLevelChangeHandler, ICameraVideoProfile, ICreateLocalTrackOptions, IJoinRTCRoomOptions, IJoinResCDNInfo, ILiveAudioState, IMCUOutputConfig, IMCUOutputVideoConfig, IMicphoneAudioProfile, IPKEndInfo, IPKInviteAnswerInfo, IPKInviteInfo, IPubSuccessRes, IPublishAttrs, IPublishedResource, IRCCandidatePairStat, IRCEncryptorHooks, IRCRTCInitOptions, IRCRTCReportListener, IRCRTCStateReport, IRCTrackStat, IRTCUserData, IReqResPKOptions, IRoomEventListener, IRoomPKEventListener, IScreenVideoProfile, ISubscribeAttr, IVideoProfile, MixLayoutMode, MixVideoRenderMode, RCAbstractRoom, RCAudienceClient, RCAudienceLivingRoom, RCAudioBitrate, RCCameraVideoTrack, RCEncryptFunction, RCFrameRate, RCInnerCDNPullIsHttps, RCInnerCDNPullKind, RCKickReason, RCLivingRoom, RCLivingType, RCLocalAudioTrack, RCLocalFileAudioTrack, RCLocalFileTrack, RCLocalFileVideoTrack, RCLocalTrack, RCLocalVideoTrack, RCMCUConfigBuilder, RCMediaStreamCapture, RCMediaType, RCMicphoneAudioTrack, RCRTCClient, RCRTCCode, RCRTCLiveRole, RCRTCPingResult, RCRTCRoom, RCRemoteAudioTrack, RCRemoteTrack, RCRemoteVideoTrack, RCResolution, RCScreenAudioTrack, RCScreenVideoTrack, RCTag, RCTrack, RCVideoBitrate, RTCEncodedFrame, RTCJoinType, RTCMode, device, helper, installer };
+export { BackgroundPictureFillMode, IAudienceRoomEventListener, IAudioLevelChangeHandler, ICameraVideoProfile, ICreateLocalTrackOptions, IJoinRTCRoomOptions, IJoinResCDNInfo, ILiveAudioState, IMCUOutputConfig, IMCUOutputVideoConfig, IMicphoneAudioProfile, IPKEndInfo, IPKInviteAnswerInfo, IPKInviteInfo, IPubSuccessRes, IPublishAttrs, IPublishedResource, IRCCandidatePairStat, IRCEncryptorHooks, IRCRTCInitOptions, IRCRTCReportListener, IRCRTCStateReport, IRCTrackStat, IRTCUserData, IReqResPKOptions, IRoomEventListener, IRoomPKEventListener, IScreenVideoProfile, ISubscribeAttr, IVideoProfile, MixLayoutMode, MixVideoRenderMode, RCAbstractRoom, RCAudienceClient, RCAudienceLivingRoom, RCAudioBitrate, RCCameraVideoTrack, RCEncryptFunction, RCFrameRate, RCInnerCDNPullIsHttps, RCInnerCDNPullKind, RCKickReason, RCLivingRoom, RCLivingType, RCLocalAudioTrack, RCLocalFileAudioTrack, RCLocalFileTrack, RCLocalFileVideoTrack, RCLocalTrack, RCLocalVideoTrack, RCMCUConfigBuilder, RCMediaStreamCapture, RCMediaType, RCMicphoneAudioTrack, RCRTCClient, RCRTCCode, RCRTCLiveRole, RCRTCPingResult, RCRTCRoom, RCRemoteAudioTrack, RCRemoteTrack, RCRemoteVideoTrack, RCResolution, RCScreenAudioTrack, RCScreenVideoTrack, RCTag, RCTrack, RCVideoBitrate, RTCJoinType, RTCMode, device, helper, installer };