@rongcloud/plugin-rtc 5.4.5-alpha.1 → 5.4.6

package/README.md

@@ -1 +1,50 @@
-# @rongcloud/plugin-rtc
+# 使用说明
+## 安装依赖 @rongcloud/plugin-rtc
+
+> RTC 消息通信需要依赖 IMLib 进行消息收发，所以需要先安装 IMLib
+### 一、 安装消息通信依赖 IMLib
+
+1. 查看最新包所依赖模块
+
+```
+npm info "@rongcloud/imlib-next@latest" peerDependencies
+```
+
+2. 安装所依赖的模块
+
+> npm version > 5.0
+>
+> 将所有依赖安装到 `dependencies` 的位置
+
+```
+npx install-peerdeps -x "--save-prod" @rongcloud/imlib-next@latest
+```
+
+
+### 二、 安装音视频通信 RTCLib
+1. 查看最新包所依赖模块
+
+```
+npm info "@rongcloud/plugin-rtc@latest" peerDependencies
+```
+
+2. 安装所依赖的模块
+
+> npm version > 5.0
+>
+> 将所有依赖安装到 `dependencies` 的位置
+
+```
+npx install-peerdeps -x "--save-prod" @rongcloud/plugin-rtc@latest
+```
+
+## RTC 使用
+
+1. 融云开发者文档 [^快速开始](https://doc.rongcloud.cn/live/Web/5.X/quickstart/init)
+
+2. demo 体验 [rongcloud-rtc-web-demo](https://github.com/rongcloud/rongcloud-rtc-web-demo)
+2. 流程说明
+    - [初始化](https://doc.rongcloud.cn/live/Web/5.X/quickstart/init)
+    - 创建房间并加入
+    - 在房间内发布资源
+    - 订阅房间内已经发布的资源

package/dist/core/webrtc/sdp/ASdpBuilder.d.ts

@@ -1,5 +1,5 @@
 import { IRCTrackBitrate } from '../../interfaces';
-import { ISdpSemantics } from './ASdpStrategy';
+import { ISdpSemantics, RtpTransceiverDirection } from './ASdpStrategy';
 /**
  * 以字符串的形式 硬处理 SDP 信息
  * 对于 plan-b | unified-plan 数据的处理 方式是相同的。
@@ -12,6 +12,9 @@ export default abstract class ASdpBuilder {
     protected SDPHeader: string;
     protected videoStreams: string[];
     protected audioStreams: string[];
+    static KBitrate: number;
+    get videoSdps(): string[];
+    get audioSdps(): string[];
     constructor(SDP: string, type: ISdpSemantics);
     /**
      * 它从 SDP 中删除空行和尾随空格
@@ -54,6 +57,12 @@ export default abstract class ASdpBuilder {
      * @param {string} streamId - 音频流的媒体流 ID。
      */
     setAudioBitrateWithStreamId(bitrate: IRCTrackBitrate, streamId: string): ASdpBuilder;
+    /**
+     * 它设置特定 MID 的音频比特率。
+     * @param {IRCTrackBitrate} bitrate - 音频流的比特率，以 kbps 为单位。
+     * @param {string} mid - 音频流的媒体流 ID。
+     */
+    setAudioBitrateWithMid(bitrate: IRCTrackBitrate, mid: string): ASdpBuilder;
     /**
      * 它接受一个 SDP 音频块和一个比特率，并返回比特率设置为给定值的 SDP 音频块
      * @param {string} sdpAudioBlock - SDP 的音频块。
@@ -80,6 +89,12 @@ export default abstract class ASdpBuilder {
      * @param {string} streamId - 媒体流 ID。
      */
     setVideoBitrateWithStreamId(bitrate: IRCTrackBitrate, streamId: string): ASdpBuilder;
+    /**
+     * 它设置特定中间的视频比特率， 针对 SDP 中给定 mid 的 video 元素添加码率设置。
+     * @param {IRCTrackBitrate} bitrate - 您要设置的比特率。
+     * @param {string} streamId - 媒体流 ID。
+     */
+    setVideoBitrateWithMid(bitrate: IRCTrackBitrate, mid: string): ASdpBuilder;
     /**
      * 它设置视频项目的比特率。
      * @param {string} sdpVideoBlock - SDP 的视频块。
@@ -94,5 +109,7 @@ export default abstract class ASdpBuilder {
      * @returns 正在返回 sdpVideoBlock。
      */
     private addVideoBlineAS;
+    clearnSsrcWithMid(mid: string, direction: RtpTransceiverDirection): ASdpBuilder;
+    private clearSSRC;
 }
 //# sourceMappingURL=ASdpBuilder.d.ts.map

package/dist/core/webrtc/sdp/ASdpStrategy.d.ts

@@ -8,6 +8,11 @@ export declare enum SdpSemantics {
     PLANB = "plan-b",
     UNIFIEDPLAN = "unified-plan"
 }
+export declare enum RtpTransceiverDirection {
+    SENDONLY = "sendonly",
+    RECVONLY = "recvonly",
+    INACTIVE = "inactive"
+}
 export interface IOfferInfo {
     type: 'offer';
     sdp: string;

package/dist/core/webrtc/sdp/SDPUtils.d.ts

@@ -0,0 +1,60 @@
+interface ssrcMedia {
+    ssrc: number;
+    attribute?: string;
+    value?: string;
+}
+interface Msid {
+    stream: string;
+    track: string;
+}
+interface mline {
+    kind: string;
+    port: number;
+    protocol: string;
+    fmt: string;
+}
+export default class SDPUtils {
+    static splitSections(blob: string): string[];
+    /**
+     * 它需要一个 SDP 文本块并返回一个仅包含媒体部分的 SDP 文本数组
+     * @param {string} blob - 您要解析的 SDP 字符串。
+     * @returns 字符串数组。
+     */
+    static getMediaSections(blob: string): string[];
+    static parseExtmap(line: string): {
+        id: number;
+        direction: string;
+        uri: string;
+    };
+    static splitLines(blob: string): string[];
+    /**
+     * 它接受一个媒体部分并返回一个对象，其中包含媒体部分的种类、端口、协议和格式
+     * @param {string} mediaSection - SDP的媒体部分。
+     * @returns 具有以下属性的对象：
+     *   kind：媒体的类型（音频、视频等）
+     *   端口：端口号
+     *   协议：使用的协议
+     *   fmt：媒体的格式
+     */
+    static parseMLine(mediaSection: string): mline;
+    static matchPrefix(blob: string, prefix: string): string[];
+    /**
+     * 它从 SDP 媒体部分解析 msid 属性
+     * @param {string} mediaSection - SDP的媒体部分。
+     * @returns 具有两个属性的对象：流和轨道。
+     */
+    static parseMsid(mediaSection: string): Msid;
+    /**
+     * 它接受一个字符串并返回一个对象
+     * @param {string} line - 我们正在解析的 SDP 行。
+     */
+    static parseSsrcMedia(line: string): ssrcMedia;
+    /**
+     * 它从 SDP 的媒体部分返回中间值
+     * @param {string} mediaSection - SDP的媒体部分。
+     * @returns 媒体部分的中间。
+     */
+    static getMid(mediaSection: string): string | undefined;
+}
+export {};
+//# sourceMappingURL=SDPUtils.d.ts.map

package/dist/core/webrtc/sdp/UnifiedPlanStrategy.d.ts

@@ -14,8 +14,12 @@ export declare class UnifiedPlanStrategy extends ASdpStrategy {
     private _subedTracks;
     updateRecvTransceiverMap(trackId: string, transceiver: RTCRtpTransceiver): void;
     updateSubRemoteTracks(tracks: RCRemoteTrack[]): void;
+    protected midMsid: {
+        [key: string]: string;
+    };
     createOffer(iceRestart: boolean): Promise<IOfferInfo>;
     setRemoteAnswer(sdp: string): Promise<RCRTCCode>;
-    protected resetSdp(sdp: string): string;
+    protected resetOfferSdp(sdp: string): string;
+    protected resetAnswerSdp(sdp: string): string;
 }
 //# sourceMappingURL=UnifiedPlanStrategy.d.ts.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /*
- * RCRTC - v5.4.5-alpha.1
- * CommitId - 960e964ebd4294c2f095e87cf9e33935703b475e
- * Fri Aug 12 2022 15:02:10 GMT+0800 (China Standard Time)
+ * RCRTC - v5.4.6
+ * CommitId - 94eaaf8b42fa1e563b6c6408fffee2eeaea15e7a
+ * Tue Aug 23 2022 22:25:57 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';