@rongcloud/plugin-rtc 5.5.4-alpha.1 → 5.5.4

package/dist/core/webrtc/stat-parser/AbstractStatParser.d.ts

@@ -0,0 +1,117 @@
+import IStatParser from './IStatParser';
+import { IInnerRCRTCStateReport } from '../../interfaces';
+export default abstract class AbstractStatParser implements IStatParser {
+    protected readonly _rtcPeerConn: RTCPeerConnection;
+    protected readonly _sdpSemantics: string;
+    protected readonly _currentUserId: string;
+    constructor(_rtcPeerConn: RTCPeerConnection, _sdpSemantics: string, _currentUserId: string);
+    /**
+     * 最近的上行发送包数据统计
+     */
+    protected _latestPacketsSent: {
+        [resourceId: string]: {
+            packetsLost?: number;
+            packetsSent?: number;
+            crtPacketsSent?: number;
+        };
+    };
+    /**
+     * 最近的上行发送字节数统计
+     */
+    protected _latestBytesSent: {
+        [resourceId: string]: {
+            bytesSent: number;
+            timestamp: number;
+        };
+    };
+    /**
+     * 最近的下行接收字节数统计
+     */
+    protected _latestBytesRecv: {
+        [resourceId: string]: {
+            bytesRecv: number;
+            timestamp: number;
+        };
+    };
+    /**
+     * 最近的下行接收包数据统计
+     */
+    protected _latestPacketsRecv: {
+        [resourceId: string]: {
+            packetsLost: number;
+            packetsRecv: number;
+        };
+    };
+    /**
+     * 更新上行码率存储，返回计算出的码率
+     * @param resourceId
+     * @param bytesSent 本次发送的字节数
+     * @param timestamp
+     * @returns bitrate
+     */
+    protected updateBytesSent(resourceId: string, bytesSent: number, timestamp: number): number;
+    /**
+     * 更新下行码率存储，返回计算出的码率
+     * @param resourceId
+     * @param bytesRecv
+     * @param timestamp
+     * @returns bitrate
+     */
+    protected updateBytesRecv(resourceId: string, bytesRecv: number, timestamp: number): number;
+    /**
+     * 更新上行丢包总数，返回计算出的丢包率
+     * 计算丢包率
+     * 上行数据统计中，packageLost 的统计具有延时性
+     * 会导致瞬时的 packetsLost - prePacketsLost 值大于 packetsSent - prePacketsSent，从而丢包率可能大于 1
+     * 因此此处计算只在 packetsLost - prePacketsLost !== 0 时计算丢包率，其他时间丢包为 0
+     * packetsSent 只在 packetsLost 有变化时更新
+     */
+    protected updateSenderPacketsLost(resourceId: string, packetsLost: number, packetsSent: number): number;
+    /**
+     * 更新下行丢包总数，返回计算出的丢包率
+     */
+    protected updateReceiverPacketsLost(resourceId: string, packetsLost: number, packetsReceived: number): number;
+    /**
+     * 取消发布后，需把 _latestPacketsSent 中 key 为 resourceId 存储的数据清除掉
+     */
+    clearLatestpacketsSent(resourceIds: string[]): void;
+    /**
+     * 取消订阅后，需把 _latestPacketsRecv 中 key 为 resourceId 存储的数据清除掉
+     */
+    clearLatestPacketsRecv(resourceIds: string[]): void;
+    parseRTCStatsReport(reports: RTCStatsReport): {
+        [key: string]: any;
+    };
+    formatRCRTCStateReport(stats: {
+        [key: string]: any;
+    }): IInnerRCRTCStateReport;
+    getAudioLevelList(stats: {
+        [key: string]: any;
+    }): {
+        trackId: string;
+        audioLevel: number | null;
+    }[];
+    /**
+     * 从 offer 和 answer 的 sdp 中获取 ssrc 对应的 msid
+     * @param statInfo outbound 和 inbound 对应值
+     * @returns resourceId
+     */
+    protected getResourceIdByParseSdp(statInfo: {
+        [key: string]: any;
+    }): string;
+    /**
+     * 从 offer sdp 中查找 ssrc 对应的通道是否可用
+     * @param outboundInfo
+     */
+    protected isValidSender(outboundInfo: {
+        [key: string]: any;
+    }): boolean;
+    /**
+     * 从 answer sdp 中查找 ssrc 对应的通道是否可用
+     * @param inboundInfo
+     */
+    protected isValidReceiver(inboundInfo: {
+        [key: string]: any;
+    }): boolean;
+}
+//# sourceMappingURL=AbstractStatParser.d.ts.map

package/dist/core/webrtc/stat-parser/ChromeStatParser.d.ts

@@ -0,0 +1,14 @@
+import { IInnerRCRTCStateReport } from '../../interfaces';
+import AbstractStatParser from './AbstractStatParser';
+export default class RTCReportParser extends AbstractStatParser {
+    formatRCRTCStateReport(stats: {
+        [key: string]: any;
+    }): IInnerRCRTCStateReport;
+    getAudioLevelList(stats: {
+        [key: string]: any;
+    }): {
+        trackId: string;
+        audioLevel: number | null;
+    }[];
+}
+//# sourceMappingURL=ChromeStatParser.d.ts.map

package/dist/core/webrtc/stat-parser/FirefoxStatParser.d.ts

@@ -0,0 +1,14 @@
+import { IInnerRCRTCStateReport } from '../../interfaces';
+import AbstractStatParser from './AbstractStatParser';
+export default class RTCReportParser extends AbstractStatParser {
+    formatRCRTCStateReport(stats: {
+        [key: string]: any;
+    }): IInnerRCRTCStateReport;
+    getAudioLevelList(stats: {
+        [key: string]: any;
+    }): {
+        trackId: string;
+        audioLevel: number | null;
+    }[];
+}
+//# sourceMappingURL=FirefoxStatParser.d.ts.map

package/dist/core/webrtc/stat-parser/IStatParser.d.ts

@@ -0,0 +1,24 @@
+import { IInnerRCRTCStateReport } from '../../interfaces';
+export default interface IStatParser {
+    /**
+     * 取消发布后，需把 _latestPacketsSent 中 key 为 resourceId 存储的数据清除掉
+     */
+    clearLatestpacketsSent(resourceIds: string[]): void;
+    /**
+     * 取消订阅后，需把 _latestPacketsRecv 中 key 为 resourceId 存储的数据清除掉
+     */
+    clearLatestPacketsRecv(resourceIds: string[]): void;
+    parseRTCStatsReport(reports: RTCStatsReport): {
+        [key: string]: any;
+    };
+    formatRCRTCStateReport(stats: {
+        [key: string]: any;
+    }): IInnerRCRTCStateReport;
+    getAudioLevelList(stats: {
+        [key: string]: any;
+    }): {
+        trackId: string;
+        audioLevel: number | null;
+    }[];
+}
+//# sourceMappingURL=IStatParser.d.ts.map

package/dist/core/webrtc/stat-parser/SafariStatParser.d.ts

@@ -0,0 +1,14 @@
+import { IInnerRCRTCStateReport } from '../../interfaces';
+import AbstractStatParser from './AbstractStatParser';
+export default class RTCReportParser extends AbstractStatParser {
+    formatRCRTCStateReport(stats: {
+        [key: string]: any;
+    }): IInnerRCRTCStateReport;
+    getAudioLevelList(stats: {
+        [key: string]: any;
+    }): {
+        trackId: string;
+        audioLevel: number | null;
+    }[];
+}
+//# sourceMappingURL=SafariStatParser.d.ts.map

package/dist/device.d.ts

@@ -0,0 +1,6 @@
+export declare const device: {
+    getCameras: () => Promise<MediaDeviceInfo[]>;
+    getMicrophones: () => Promise<MediaDeviceInfo[]>;
+    getSpeakers: () => Promise<MediaDeviceInfo[]>;
+};
+//# sourceMappingURL=device.d.ts.map

package/dist/helper.d.ts

@@ -0,0 +1,195 @@
+import { INaviInfo } from '@rongcloud/engine';
+import { RCFrameRate } from './core/enums/RCFrameRate';
+import { RCResolution } from './core/enums/RCResolution';
+import { RCRTCMessageType } from './core/enums/inner/RCRTCMessageType';
+import { IPKInfo, IPublishAttrs, IPublishedResource, IResource, ISubscribeAttr, RoomData } from './core/interfaces';
+import { RCMediaType } from './core/enums/RCMediaType';
+import { RCLocalTrack } from './core/tracks/RCLocalTrack';
+import RCRTCPeerConnection from './core/webrtc/RCRTCPeerConnection';
+import { RCRemoteTrack } from './core/tracks/RCRemoteTrack';
+import { RCTrack } from './core/tracks/RCTrack';
+import { IRTCUsers, IServerRTCRoomEntry } from './core/codec/interface';
+/**
+ * 构建增量消息内容
+ * @param objectname 消息名
+ * @param uris 增量变更资源
+ */
+export declare const buildPlusMessage: (messageName: RCRTCMessageType, uris: IPublishedResource[]) => {
+    name: RCRTCMessageType;
+    content: string;
+};
+/**
+ * 构建预发布的全量资源变更消息
+ * @param uris 全量资源数据
+ */
+export declare const buildTotalURIMessageContent: (uris: IPublishedResource[]) => string;
+/**
+ * roomId 有效性验证
+ * @param roomId
+ */
+export declare const isValidRoomId: (roomId: string) => boolean;
+/**
+ * 验证 tag 是否有效
+ * @param tag
+ * @returns
+ */
+export declare const isValidTag: (tag: string) => boolean;
+/**
+ * 页面地址有效性检测
+ */
+export declare const isValidLocation: boolean;
+/**
+ * 获取视频流的分辨率及帧率数据，若无法获取真实值，则返回 0
+ * @param track
+ */
+export declare const getVideoTrackInfo: (track: MediaStreamTrack) => {
+    /**
+     * applyConstraints 方法应用的宽高约束不一定可以立马生效
+     * 取值优先 constraints
+     */
+    width: number;
+    height: number;
+    frameRate: number;
+};
+/**
+ * 取视频流动态码率
+ * @param track
+ * @returns
+ */
+export declare const getDynamicBitrate: (track: MediaStreamTrack) => {
+    min: number;
+    max: number;
+};
+/**
+ * 获取资源唯一性标识
+ * @param item
+ */
+export declare const getTrackId: (item: IResource) => string;
+/**
+ * 它接受一个类似“userId_tag_mediaType”的字符串，并返回一个包含字符串三个部分的对象
+ * 解析 trackId 以获取资源信息
+ * trackId 构成说明 trackId = [ userid, tag, mediaType ].join('_')
+ *    userid    : 用户可随意定义可包含 _ 下划线
+ *    tag       : `不可以有 _ 下划线`
+ *    mediaType : RCMediaType 0:音频流  1:视频流 2:音视频混合流
+ * @param {string} trackId - 远程轨道的轨道 ID。
+ * @returns 具有三个属性的对象：mediaType、tag 和 userId。
+ */
+export declare const parseTrackId: (trackId: string) => {
+    mediaType: RCMediaType;
+    tag: string;
+    userId: string;
+};
+export declare const parseStreamId: (streamId: string) => {
+    tag: string;
+    userId: string;
+};
+export declare const formatStreamId: (userId: string, tag: string) => string;
+export declare const deepCopyResources: <T>(resources: T[]) => T[];
+/**
+ * 比对资源找出新增、状态变更及取消发布的资源
+ * @param prevResources 原资源数据
+ * @param resources 变更的全量资源
+ */
+export declare const diffPublishResources: (prevResources: IPublishedResource[], resources: IPublishedResource[], isReconnect?: boolean) => {
+    publishedList: IPublishedResource[];
+    unpublishedList: IPublishedResource[];
+    modifiedList: IPublishedResource[];
+};
+export declare const diffPubResOnReconnect: (prevResources: IPublishedResource[], resources: IPublishedResource[]) => {
+    publishedList: IPublishedResource[];
+    unpublishedList: IPublishedResource[];
+    modifiedList: IPublishedResource[];
+};
+export declare const getUUID22: () => string;
+/**
+ * 转化 RCResolution 枚举值为分辨率宽高
+ * @param resolution
+ * @returns
+ */
+export declare const transResolution: (resolution: RCResolution) => {
+    width: number;
+    height: number;
+};
+/**
+ * 判断枚举值有效性
+ * @param resolution
+ * @returns
+ */
+export declare const isValidResolution: (resolution?: RCResolution) => boolean;
+/**
+ * 判断帧率枚举值有效性
+ * @param fps
+ * @returns
+ */
+export declare const isValidFPS: (fps?: RCFrameRate) => boolean;
+/**
+ * 获取枚举值对应的帧率
+ * @param fps
+ * @returns
+ */
+export declare const transFrameRate: (fps: RCFrameRate) => number;
+export declare type IBrowserDetails = {
+    browser: string;
+    version?: number;
+    supportsUnifiedPlan: boolean;
+};
+export declare const browserInfo: IBrowserDetails;
+/**
+ * 验证浏览器是否支持创建自定义文件流
+ * @returns
+ */
+export declare function ifSupportLocalFileTrack(): boolean;
+/**
+ * 验证浏览器是否支持屏幕共享
+ * @returns
+ */
+export declare function ifSupportScreenShare(): boolean;
+/**
+ * 检查参数是否为 null
+*/
+export declare const isNull: (val: any) => boolean;
+/**
+ * 公有云连接私有云 SDK 为非法连接
+ */
+export declare const isIllegalConnection: (navi: INaviInfo) => boolean;
+/**
+ * 获取将要发布的 track 数量
+ * 需要发布小流的算两个 track
+ */
+export declare const calcTracksNum: (tracks: (RCLocalTrack | IPublishAttrs)[], pc: RCRTCPeerConnection) => number;
+/**
+ * 解析房间数据
+ */
+export declare const parseRoomData: (data: IRTCUsers, mainRoomId: string) => RoomData;
+export declare const isRepeatPub: (newPub: IPublishedResource, allPublishList: IPublishedResource[]) => {
+    isInclude: boolean;
+    index: number;
+};
+/**
+ * 从加房间返回的数据中获取加入的副房间
+ */
+export declare const getPKInfoByRoomData: (mainRoomId: string, roomInfo: {
+    key: string;
+    value: string;
+}[]) => IPKInfo;
+/**
+ * 解析观众加房间 kv 数据
+ * 远端无人员时，kvEntries 的 key 不包含 RC_ANCHOR_LIST
+ * 远端无资源时，key 不包含 RC_RES_、RC_CDN
+ * 远端有资源、无 CDN 资源时，key 不包含 RC_CDN
+ * 服务端 bug，偶现无 RC_RTC_SESSIONID
+ */
+export declare const parseAudienceRoomData: (roomId: string, kvEntries: IServerRTCRoomEntry[]) => {
+    sessionId: string;
+    remoteUserIds: string[];
+    remoteRTCUris: IPublishedResource[];
+    remoteMUCUris: IPublishedResource[];
+    remoteRTCTracks: RCRemoteTrack[];
+    remoteMCUTracks: RCRemoteTrack[];
+    remoteTracks: RCRemoteTrack[];
+    CDNUris: any;
+};
+export declare const getTrackIdFromAttr: (track: RCTrack | ISubscribeAttr | IPublishAttrs) => string;
+export declare const int64ToTimestamp: (obj: any) => number;
+//# sourceMappingURL=helper.d.ts.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /*
- * RCRTC - v5.5.4-alpha.1
- * CommitId - 5979242633209b9a8830d449c1d7a425a1868f7b
- * Fri Sep 30 2022 20:48:58 GMT+0800 (China Standard Time)
+ * RCRTC - v5.5.4
+ * CommitId - 80b0c1d49cb6cbe32c4b66a016063568d6893014
+ * Sun Oct 09 2022 17:26:05 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
 import * as _rongcloud_engine from '@rongcloud/engine';
@@ -646,19 +646,7 @@ declare enum RTCMode {
     /**
     * 跨应用直播
     */
-    CROSS_LIVE = 8,
-    /**
-     * sip呼叫
-     */
-    SIP = 4,
-    /**
-     * 呼叫模式.包括单呼和群呼
-     */
-    CALL = 5,
-    /**
-     * 会议
-     */
-    MEETING = 6
+    CROSS_LIVE = 8
 }
 
 /**
@@ -1278,7 +1266,6 @@ declare const keymaps: {
     readonly RtcCancelInviteInput: readonly ["invitedUserId", "invitedRoomId", "inviteInfo", "inviteSessionId"];
     readonly RtcInviteAnswerInput: readonly ["inviteUserId", "answerCode", "inviteRoomId", "inviteSessionId", "content", "key", "value"];
     readonly RtcEndInviteInput: readonly ["inviteRoomId", "inviteSessionId", "inviteContent", "inviteRoomKeys"];
-    readonly RtcReportSDKInput: readonly ["sdkInfo"];
 };
 declare type RTCKeyMaps = typeof keymaps;
 
@@ -1499,7 +1486,7 @@ declare class RTCContext {
     getRTCJoinedUserInfo(userId: string): Promise<IAsyncRes<IRTCJoinedInfo[]>>;
     pullRTCRoomEntry(roomId: string): Promise<IAsyncRes<IChrmKVPullData>>;
     decodeRtcNotify(buffer: Uint8Array): {
-        time: number;
+        time: any;
         type: any;
         roomId: any;
     };
@@ -1516,9 +1503,6 @@ declare class RTCContext {
     registerMessageListener(listener: (message: IReceivedMessage) => boolean): void;
     getCoreVersion(): string;
     getPluginContext(): RTCPluginContext;
-    reportSDKInfo(versionInfo: {
-        [name: string]: string;
-    }): void;
 }
 
 declare class RCMediaService {
@@ -2878,8 +2862,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
     private _reportStatsTimer;
     private _reportR3R4ToPolarisTimer;
     private _isDestroyed;
-    private _reportStatsData?;
-    private _originReportStatsData?;
     constructor(
     /**
      * peerConnection 对应名称
@@ -2900,8 +2882,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
     getName(): string;
     getLocalTracks(): RCLocalTrack[];
     private _onConnectionStateChange;
-    private startAutoExecute;
-    private stopAutoExecute;
     private _onICEConnectionStateChange;
     private _onTrackReady;
     /**
@@ -2936,7 +2916,7 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @returns 返回格式化后的数据
      */
     private _getStatsData;
-    getAudioLevelReportData(gap?: number): Promise<{
+    getAudioLevelReportData(): Promise<{
         trackId: string;
         audioLevel: number | null;
     }[] | undefined>;
@@ -2945,10 +2925,6 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @todo
      */
     private _reportHandle;
-    /**
-     * 获取缓存的本地质量数据
-     */
-    _getCacheStatsData(): IInnerRCRTCStateReport | null | undefined;
     /**
      * 北极星上报 R3、R4 数据
      */
@@ -2998,8 +2974,10 @@ interface IResource {
     uri: string;
     /**
      * 资源特征，simulcast 代表这道流支持大小流
+     * @description 此参数存疑，MediaServer 似乎并未下发此字段，Web 端暂不启用
+     * @deprecated
      */
-    simulcast: number;
+    features?: ['simulcast'] | [];
 }
 /**
  * 向房间内发布的媒体数据
@@ -4228,7 +4206,6 @@ declare class RCRTCClient extends RCMediaStreamCapture {
         code: RCRTCCode | ErrorCode;
         data?: IRTCJoinedInfo[];
     }>;
-    reportSDKInfo(): void;
 }
 
 /**