@rongcloud/plugin-rtc 5.1.10-alpha.3 → 5.2.2-alpha.1

package/dist/index.js

@@ -1,7 +1,7 @@
 /*
- * RCRTC - v5.1.10-alpha.3
- * CommitId - 799cc871ab8fce4eb595d368ebaa84664d101f6f
- * Thu Oct 21 2021 10:04:21 GMT+0800 (China Standard Time)
+ * RCRTC - v5.2.2-alpha.1
+ * CommitId - de4f9bc28bbee35d2d5f206a68144c89c098573f
+ * Mon Nov 22 2021 10:51:42 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
 'use strict';
@@ -110,8 +110,12 @@ exports.RCRTCCode = void 0;
     RCRTCCode[RCRTCCode["PACKAGE_ENVIRONMENT_ERROR"] = 53025] = "PACKAGE_ENVIRONMENT_ERROR";
     /** 单个用户发布资源超过限制 （ MediaServer 限制最多 10 个 track ） */
     RCRTCCode[RCRTCCode["PUBLISH_TRACK_LIMIT_EXCEEDED"] = 53026] = "PUBLISH_TRACK_LIMIT_EXCEEDED";
+    /** 房间内无主播推 CDN */
+    RCRTCCode[RCRTCCode["CDN_RESOURCE_IS_EMPTY"] = 53027] = "CDN_RESOURCE_IS_EMPTY";
     /** 加入 RTC 房间 joinTYype 为 1 时，当前有其他端在房间时的应答码 */
-    RCRTCCode[RCRTCCode["SIGNAL_JOIN_RTC_ROOM_REFUSED"] = 53207] = "SIGNAL_JOIN_RTC_ROOM_REFUSED";
+    RCRTCCode[RCRTCCode["SIGNAL_JOIN_RTC_ROOM_REFUSED"] = 53028] = "SIGNAL_JOIN_RTC_ROOM_REFUSED";
+    /** 设置音频输出设备时，无权限使用请求的设备 */
+    RCRTCCode[RCRTCCode["NO_PERMISSION_TO_USE_REQUESTED_DEVICE"] = 53029] = "NO_PERMISSION_TO_USE_REQUESTED_DEVICE";
 })(exports.RCRTCCode || (exports.RCRTCCode = {}));
 /**
  * RTC 信令 Server 返回需处理的错误 Code
@@ -5656,6 +5660,33 @@ const getBitrateMultiple = (frameRate) => {
     return rate;
 };
 
+/**
+ * 获取 Microphone 列表
+ */
+const getMicrophones = () => __awaiter(void 0, void 0, void 0, function* () {
+    const mediaDivices = yield navigator.mediaDevices.enumerateDevices();
+    return mediaDivices.filter(item => item.kind === 'audioinput');
+});
+/**
+ * 获取摄像头设备列表
+ */
+const getCameras = () => __awaiter(void 0, void 0, void 0, function* () {
+    const mediaDevices = yield navigator.mediaDevices.enumerateDevices();
+    return mediaDevices.filter(item => item.kind === 'videoinput');
+});
+/**
+ * 获取扬声器设备列表
+ */
+const getSpeakers = () => __awaiter(void 0, void 0, void 0, function* () {
+    const mediaDevices = yield navigator.mediaDevices.enumerateDevices();
+    return mediaDevices.filter(item => item.kind === 'audiooutput');
+});
+const device = {
+    getCameras,
+    getMicrophones,
+    getSpeakers
+};
+
 class RCTrack extends engine.EventEmitter {
     constructor(_tag, _userId, _kind, _isLocalTrack, _roomId) {
         super();
@@ -5793,6 +5824,17 @@ class RCTrack extends engine.EventEmitter {
                     logger.warn('the valid range of options.volume is 0-100, the value of volume has been set 100');
                 }
             }
+            if (options === null || options === void 0 ? void 0 : options.audioDeviceId) {
+                /**
+                 * 检测传入的 audioDeviceId 是否有效
+                 */
+                const deviceIds = (yield device.getSpeakers()).map((item) => { return item.deviceId; });
+                const isValid = deviceIds.includes(options.audioDeviceId);
+                if (!isValid) {
+                    logger.error(`the options.audioDeviceId is invalid --> ${options.audioDeviceId}`);
+                    return { code: exports.RCRTCCode.PARAMS_ERROR };
+                }
+            }
             const isVideoTrack = this.isVideoTrack();
             // video 播放必须传递一个 HTMLVideoElement 实例作为 video track 的播放组件
             if (isVideoTrack && (!element || !(element instanceof HTMLVideoElement))) {
@@ -5856,9 +5898,21 @@ class RCTrack extends engine.EventEmitter {
                 this._element.volume = (options === null || options === void 0 ? void 0 : options.volume) / 100;
             }
             try {
-                this._element.play();
+                if ((options === null || options === void 0 ? void 0 : options.audioDeviceId) && !isVideoTrack) {
+                    yield this._element.setSinkId(options.audioDeviceId);
+                }
+                else {
+                    this._element.play();
+                }
             }
             catch (error) {
+                /**
+                 * 检测是否有设置音频输出设备的权限
+                 */
+                if (error.message === 'No permission to use requested device') {
+                    logger.error(`setSinkId failed -> ${error.message}`);
+                    return { code: exports.RCRTCCode.NO_PERMISSION_TO_USE_REQUESTED_DEVICE };
+                }
                 logger.error(error);
                 return { code: exports.RCRTCCode.TRACK_PLAY_ERROR };
             }
@@ -6320,6 +6374,27 @@ const calcTracksNum = (tracks) => {
     });
     return length;
 };
+/**
+ * 解析房间数据
+ */
+const parseRoomData = (data) => {
+    const result = {};
+    const userIds = Object.keys(data.users);
+    userIds.length && userIds.forEach(userId => {
+        const tmp = [];
+        const userData = data.users[userId];
+        if (userData.uris) {
+            try {
+                tmp.push(...JSON.parse(userData.uris));
+            }
+            catch (error) {
+                logger.warn(`invalid user data -> userId: ${userId}, userData: ${userData}`);
+            }
+        }
+        result[userId] = tmp;
+    });
+    return result;
+};
 
 /**
  * RTC 消息类型常量
@@ -8242,7 +8317,7 @@ class PolarisReporter {
      * 加入房间
      */
     sendR1() {
-        const rtcVersion = "5.1.10-alpha.3";
+        const rtcVersion = "5.2.2-alpha.1";
         const imVersion = this._context.getCoreVersion();
         const platform = 'web';
         const pcName = navigator.platform;
@@ -8378,24 +8453,21 @@ class RCAudioLevelReport {
     }
 }
 
-const parseRoomData = (data) => {
-    const result = {};
-    const userIds = Object.keys(data.users);
-    userIds.length && userIds.forEach(userId => {
-        const tmp = [];
-        const userData = data.users[userId];
-        if (userData.uris) {
-            try {
-                tmp.push(...JSON.parse(userData.uris));
-            }
-            catch (error) {
-                logger.warn(`invalid user data -> userId: ${userId}, userData: ${userData}`);
-            }
-        }
-        result[userId] = tmp;
-    });
-    return result;
-};
+/**
+ * 直播角色
+ */
+exports.RCRTCLiveRole = void 0;
+(function (RCRTCLiveRole) {
+    /**
+     * 主播
+     */
+    RCRTCLiveRole[RCRTCLiveRole["ANCHOR"] = 1] = "ANCHOR";
+    /**
+     * 观众
+     */
+    RCRTCLiveRole[RCRTCLiveRole["AUDIENCE"] = 2] = "AUDIENCE";
+})(exports.RCRTCLiveRole || (exports.RCRTCLiveRole = {}));
+
 const getTrackIdFromAttr = (track) => {
     if (track instanceof RCTrack) {
         return track.getTrackId();
@@ -8453,7 +8525,7 @@ class RCAbstractRoom {
         /**
          * 观众升级为主播后不会收到全量 uri 消息，需直接触发人员、资源变更
          */
-        isUpgrade && this._afterChangedRole(parseRoomData(data));
+        isUpgrade && this._afterChangedRole(data);
         // 开始心跳，心跳失败时主动退出房间
         this._pinger = new Pinger(_roomId, this._roomMode, _context, this._initOptions.pingGap);
         this._pinger.onFailed = this._kickoff.bind(this);
@@ -8743,30 +8815,49 @@ class RCAbstractRoom {
      * @param content
      */
     _stateHandle(content) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const { users } = content;
             if (users.length === 0) {
                 return;
             }
+            /**
+             * 主动加入房间
+             */
             const joined = [];
+            /**
+             * 主动退出房间
+             */
             const left = [];
+            /**
+             * 观众升级为主播加入房间
+             */
+            const upgrade = [];
+            /**
+             * 主播降级为观众退出房间
+             */
+            const downgrade = [];
             users.forEach(item => {
                 if (+item.state === 0) {
                     logger.debug(`user joined -> ${item.userId}`);
                     // 对端 im 重连之后调加入房间信令获取最新数据，服务会给本端下发“对端加入房间”的消息，本端内存已包含对端人员，所以需过滤掉
-                    !this._roomResources[item.userId] && joined.push(item.userId);
+                    if (!this._roomResources[item.userId]) {
+                        item.switchRoleType ? upgrade.push(item.userId) : joined.push(item.userId);
+                    }
                     this._roomResources[item.userId] = this._roomResources[item.userId] || [];
                 }
                 else {
                     logger.debug(`user left -> ${item.userId}`);
-                    left.push(item.userId);
+                    item.switchRoleType ? downgrade.push(item.userId) : left.push(item.userId);
                 }
             });
+            const allJoined = [...joined, ...upgrade];
+            const allLeft = [...left, ...downgrade];
             // 用户离开房间时，自动退订对方资源
-            if (left.length > 0) {
+            if (allLeft.length) {
                 const tracks = [];
                 const userIds = [];
-                left.forEach(userId => {
+                allLeft.forEach(userId => {
                     tracks.push(...this.getRemoteTracksByUserId(userId));
                     // 先暂存待删用户，因当前异步队列中可能存在等待中的待处理任务，需要当前房间数据状态
                     // delete this._roomResources[userId]
@@ -8781,9 +8872,23 @@ class RCAbstractRoom {
                     userIds.forEach(userId => delete this._roomResources[userId]);
                 }
             }
-            // 通知业务层
-            joined.length > 0 && this._callAppListener('onUserJoin', joined);
-            left.length > 0 && this._callAppListener('onUserLeave', left);
+            /**
+             * 通知业务层
+             * 有 onSwitchRole 监听时，按 switchRole 分“角色切换、加入房间、退出房间”抛出
+             */
+            if ((_a = this._appListener) === null || _a === void 0 ? void 0 : _a.onSwitchRole) {
+                upgrade.length && upgrade.forEach(userId => this._callAppListener('onSwitchRole', userId, exports.RCRTCLiveRole.ANCHOR));
+                downgrade.length && downgrade.forEach(userId => this._callAppListener('onSwitchRole', userId, exports.RCRTCLiveRole.AUDIENCE));
+                joined.length && this._callAppListener('onUserJoin', joined);
+                left.length && this._callAppListener('onUserLeave', left);
+                return;
+            }
+            /**
+             * 通知业务层
+             * 无 onSwitchRole 监听时，统一按“加入房间、退出房间”抛出
+             */
+            allJoined.length && this._callAppListener('onUserJoin', allJoined);
+            allLeft.length && this._callAppListener('onUserLeave', allLeft);
         });
     }
     /**
@@ -9204,7 +9309,7 @@ class RCAbstractRoom {
                 subscribeList: subscribeList.filter((item) => {
                     var _a;
                     const trackId = item.track.getTrackId();
-                    const { userId } = helper.parseTrackId(trackId);
+                    const { userId } = parseTrackId(trackId);
                     const isInclude = (_a = this._roomResources[userId]) === null || _a === void 0 ? void 0 : _a.filter(item => trackId === `${item.msid}_${item.mediaType}`).length;
                     return isInclude;
                 }).map(item => ({
@@ -9652,6 +9757,7 @@ class RCAbstractRoom {
                     rTrack.isAudioTrack() ? this._onAudioMuteChange(rTrack) : this._onVideoMuteChange(rTrack);
                 });
             });
+            return { data };
         });
     }
     _onAudioMuteChange(audioTrack) {
@@ -9663,35 +9769,7 @@ class RCAbstractRoom {
     /**
      * 观众切换为主播后直接处理人员变更及资源变更
      */
-    _afterChangedRole(data) {
-        const currentUserId = this._context.getCurrentId();
-        const joinedAnchorList = Object.keys(data);
-        // 观众升级主播成功后返回房间实例，才可注册房间事件，需异步抛出
-        setTimeout(() => {
-            // 通知业务层人员变更
-            const needNoticeUserIds = joinedAnchorList.filter(id => {
-                return id !== currentUserId;
-            });
-            needNoticeUserIds.length > 0 && this._callAppListener('onUserJoin', needNoticeUserIds);
-            // 通知业务层资源变更
-            for (const userId in data) {
-                if (userId === currentUserId) {
-                    continue;
-                }
-                this.msgTaskQueue.push(() => this._resourceHandle({
-                    uris: data[userId]
-                }, RCRTCMessageType.TOTAL_CONTENT_RESOURCE, userId));
-            }
-        });
-    }
-    /**
-     * 主播身份降级，取消己端已发布的所有资源
-     */
-    __unpublishToSingal() {
-        const crtUserId = this._context.getCurrentId();
-        const unpublishList = this._roomResources[crtUserId];
-        return this._context.setRTCTotalRes(this._roomId, buildPlusMessage(RCRTCMessageType.UNPUBLISH, unpublishList), buildTotalURIMessageContent([]), RCRTCMessageType.TOTAL_CONTENT_RESOURCE);
-    }
+    _afterChangedRole(data) { }
     /**
      * 销毁远端资源
      */
@@ -9769,9 +9847,14 @@ class RCMCUConfigBuilder {
     /**
      * trackId 有效性验证方法
      */
-    _isValidTrackId) {
+    _isValidTrackId, 
+    /**
+     * 扩散 cdn_uris
+     */
+    _sendCDNInfoSignal) {
         this._onFlush = _onFlush;
         this._isValidTrackId = _isValidTrackId;
+        this._sendCDNInfoSignal = _sendCDNInfoSignal;
         /**
          * mcu 配置数据，每次向服务器提交全量数据
          */
@@ -10158,24 +10241,62 @@ class RCMCUConfigBuilder {
      * 使已修改的配置生效，在调用该方法前，所有数据只会对本地配置进行修改，不会产生实际效果
      */
     flush() {
+        var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function* () {
             const config = JSON.parse(JSON.stringify(this._values));
             const { code } = yield this._onFlush(config);
+            /**
+             * 合流布局中包含分辨率设置时，需扩散 cdn_uris
+             */
+            if (code === exports.RCRTCCode.SUCCESS && (((_b = (_a = this._values.output) === null || _a === void 0 ? void 0 : _a.video.normal) === null || _b === void 0 ? void 0 : _b.width) || ((_d = (_c = this._values.output) === null || _c === void 0 ? void 0 : _c.video.normal) === null || _d === void 0 ? void 0 : _d.fps))) {
+                this._sendCDNInfoSignal();
+            }
             this._values = createMCUConfig();
             return { code };
         });
     }
 }
 
+var RCInnerCDNModel;
+(function (RCInnerCDNModel) {
+    // 开启
+    RCInnerCDNModel[RCInnerCDNModel["OPEN"] = 1] = "OPEN";
+    // 停用
+    RCInnerCDNModel[RCInnerCDNModel["STOP"] = 2] = "STOP";
+})(RCInnerCDNModel || (RCInnerCDNModel = {}));
+
+var RCInnerCDNBroadcast;
+(function (RCInnerCDNBroadcast) {
+    // 扩散
+    RCInnerCDNBroadcast[RCInnerCDNBroadcast["SPREAD"] = 0] = "SPREAD";
+    RCInnerCDNBroadcast[RCInnerCDNBroadcast["NO_SPREAD"] = -1] = "NO_SPREAD";
+})(RCInnerCDNBroadcast || (RCInnerCDNBroadcast = {}));
+
+var RCInnerCDNPushMode;
+(function (RCInnerCDNPushMode) {
+    // 自动模式
+    RCInnerCDNPushMode[RCInnerCDNPushMode["AUTOMATIC"] = 0] = "AUTOMATIC";
+    // 手动模式
+    RCInnerCDNPushMode[RCInnerCDNPushMode["MANUAL"] = 1] = "MANUAL";
+})(RCInnerCDNPushMode || (RCInnerCDNPushMode = {}));
+
 /**
  * 直播房间
  */
 class RCLivingRoom extends RCAbstractRoom {
     constructor(context, runtime, roomId, data, service, initOptions, clientEvent, _livingType, isUpgrage = false) {
+        var _a;
         super(context, runtime, roomId, data, engine.RTCMode.LIVE, service, initOptions, clientEvent, isUpgrage);
         this._livingType = _livingType;
+        /**
+         * cdn_uris 信令扩散数据
+         */
+        this._CDNUris = null;
+        this._CDNEnable = false;
         // 初始化 MCUBuilder
-        this._mcuConfigBuilder = new RCMCUConfigBuilder(this._onMCUConfigFlush.bind(this), this._isValidResourceId.bind(this));
+        this._mcuConfigBuilder = new RCMCUConfigBuilder(this._onMCUConfigFlush.bind(this), this._isValidResourceId.bind(this), this._sendCDNInfoSignal.bind(this));
+        const CDNUris = (_a = data.roomInfo.filter((item) => { return item.key === 'cdn_uris'; })[0]) === null || _a === void 0 ? void 0 : _a.value;
+        CDNUris && (this._CDNUris = JSON.parse(CDNUris)[0]);
     }
     getLivingType() {
         return this._livingType;
@@ -10199,16 +10320,214 @@ class RCLivingRoom extends RCAbstractRoom {
                 UserId: this._context.getCurrentId(),
                 SessionId: this.getSessionId()
             };
-            const { code } = yield this._service.setMcuConfig(headers, data);
+            const { code, res } = yield this._service.setMcuConfig(headers, data);
             if (code !== exports.RCRTCCode.SUCCESS) {
                 logger.error(`set MCU config failed: ${code}`);
+                return { code };
             }
-            logger.debug('set MCU config success');
-            return { code };
+            logger.info('set MCU config success');
+            res.pull_url && (this._CDNUris = JSON.parse(res.pull_url));
+            return { code, res };
         });
     }
+    /**
+     * 主播端断线重连后，需更新内存中的 CDN 数据
+     * 判断房间内 CDN 状态是否和内存数据一致，不一致时需通知到客户端
+     */
     __onReconnected() {
-        return super.__onReconnected(this._livingType);
+        const _super = Object.create(null, {
+            __onReconnected: { get: () => super.__onReconnected }
+        });
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield _super.__onReconnected.call(this, this._livingType);
+            if (!res || !res.data) {
+                return;
+            }
+            const roomInfo = res.data.roomInfo;
+            const CDNUris = (_a = roomInfo.filter((item) => { return item.key === 'cdn_uris'; })[0]) === null || _a === void 0 ? void 0 : _a.value;
+            if (!CDNUris) {
+                return;
+            }
+            const parseCDNUris = JSON.parse(CDNUris);
+            if (((_b = this._CDNUris) === null || _b === void 0 ? void 0 : _b.enableInnerCDN) !== parseCDNUris.enableInnerCDN) {
+                this._callAppListener('onCDNEnableChange', parseCDNUris.enableInnerCDN);
+            }
+            this._CDNUris = parseCDNUris;
+        });
+    }
+    /**
+     * 开启/停用推 CDN
+     */
+    enableInnerCDN(enable) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!engine.isBoolean(enable)) {
+                logger.error('`enable` is invalid');
+                return { code: exports.RCRTCCode.PARAMS_ERROR };
+            }
+            this._CDNEnable = enable;
+            const params = {
+                version: 2,
+                output: {
+                    inCDNModel: enable ? RCInnerCDNModel.OPEN : RCInnerCDNModel.STOP
+                }
+            };
+            const { code } = yield this._onMCUConfigFlush(params);
+            if (code !== exports.RCRTCCode.SUCCESS) {
+                logger.error(`enableInnerCDN failed -> code: ${code}`);
+                return { code: exports.RCRTCCode.SIGNAL_ERROR };
+            }
+            // 判断是否需要扩散 cdn_uris 时
+            if (this._CDNUris && (this._CDNUris.broadcast !== RCInnerCDNBroadcast.SPREAD)) {
+                logger.info('enableInnerCDN succeed');
+                return { code: exports.RCRTCCode.SUCCESS };
+            }
+            /**
+             * 扩散 cdn_uris
+             */
+            const { code: sendSingalCode } = yield push(() => __awaiter(this, void 0, void 0, function* () { return this._sendCDNInfoSignal(); }));
+            if (sendSingalCode === exports.RCRTCCode.SUCCESS) {
+                logger.info('enableInnerCDN succeed');
+                return { code: exports.RCRTCCode.SUCCESS };
+            }
+            logger.error(`enableInnerCDN failed -> code: ${sendSingalCode}`);
+            return { code: sendSingalCode };
+        });
+    }
+    /**
+     * 开启、停用 CDN 推资源后发信令
+     */
+    _sendCDNInfoSignal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this._CDNUris = Object.assign({}, this._CDNUris, { enableInnerCDN: this._CDNEnable });
+            const resCodeArr = yield Promise.all([this._spreadCDNInfo(this._CDNUris), this._setRoomCDNInfo(this._CDNUris)]);
+            const isSuccess = resCodeArr.every((item) => {
+                return item.code === exports.RCRTCCode.SUCCESS;
+            });
+            return isSuccess ? { code: exports.RCRTCCode.SUCCESS } : { code: exports.RCRTCCode.SIGNAL_ERROR };
+        });
+    }
+    /**
+     * 扩散 cdn_uris 资源
+     */
+    _spreadCDNInfo(CDNUris) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const code = yield this._context.setRTCCDNUris(this._roomId, RCRTCMessageType.TOTAL_CONTENT_RESOURCE, JSON.stringify([CDNUris]));
+            if (code !== engine.ErrorCode.SUCCESS) {
+                logger.error(`spreadCDNInfo failed -> code: ${code}`);
+                return { code: exports.RCRTCCode.SIGNAL_ERROR };
+            }
+            logger.info('spreadCDNInfo succeed');
+            return { code: exports.RCRTCCode.SUCCESS };
+        });
+    }
+    /**
+     * 给房间设置 CDN 数据
+     */
+    _setRoomCDNInfo(CDNUris) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const code = yield this._context.setRTCData(this._roomId, 'cdn_uris', JSON.stringify([CDNUris]), true, engine.RTCApiType.ROOM);
+            if (code !== engine.ErrorCode.SUCCESS) {
+                logger.error(`setRoomCDNInfo failed -> code: ${code}`);
+                return { code: exports.RCRTCCode.SIGNAL_ERROR };
+            }
+            logger.info('setRoomCDNInfo succeed');
+            return { code: exports.RCRTCCode.SUCCESS };
+        });
+    }
+    /**
+     * 资源变化时触发
+     * 直播房间需单独处理 cdn_uris
+     */
+    _resourceHandle(content, messageType, userId) {
+        const _super = Object.create(null, {
+            _resourceHandle: { get: () => super._resourceHandle }
+        });
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            _super._resourceHandle.call(this, content, messageType, userId);
+            if (!content.cdn_uris) {
+                return;
+            }
+            // 给业务层抛 CDN 状态
+            if (((_a = this._CDNUris) === null || _a === void 0 ? void 0 : _a.enableInnerCDN) !== content.cdn_uris[0].enableInnerCDN) {
+                this._callAppListener('onCDNEnableChange', !this.__getCDNEnable());
+            }
+            // 更新 _CDNUris
+            this._CDNUris = content.cdn_uris[0];
+        });
+    }
+    /**
+     * 重写父类 _exchangeHandle 方法
+     */
+    _exchangeHandle(body) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this._service.exchange(this._getRTCReqestHeaders(), body);
+            const pullUrl = (_b = (_a = res.data) === null || _a === void 0 ? void 0 : _a.urls) === null || _b === void 0 ? void 0 : _b.pull_url;
+            if (res.code !== exports.RCRTCCode.SUCCESS || !pullUrl) {
+                return res;
+            }
+            /**
+             * 自动模式下:
+             * /exchange 完需根据 broadcast 字端判断是否扩散 cdn_uris 数据，设置房间 cdn_uris 数据
+             */
+            this._CDNUris = JSON.parse(pullUrl);
+            if (((_c = this._CDNUris) === null || _c === void 0 ? void 0 : _c.broadcast) === RCInnerCDNBroadcast.SPREAD) {
+                this._CDNEnable = true;
+                this._sendCDNInfoSignal();
+            }
+            return res;
+        });
+    }
+    /**
+     * 观众切换为主播后直接处理人员变更及资源变更
+     */
+    _afterChangedRole(data) {
+        const parseData = parseRoomData(data);
+        const currentUserId = this._context.getCurrentId();
+        const joinedAnchorList = Object.keys(parseData);
+        // 观众升级主播成功后返回房间实例，才可注册房间事件，需异步抛出
+        setTimeout(() => {
+            var _a, _b, _c;
+            // 通知业务层人员变更
+            const needNoticeUserIds = joinedAnchorList.filter(id => {
+                return id !== currentUserId;
+            });
+            needNoticeUserIds.length > 0 && this._callAppListener('onUserJoin', needNoticeUserIds);
+            // 通知业务层资源变更
+            for (const userId in parseData) {
+                if (userId === currentUserId) {
+                    continue;
+                }
+                this._resourceHandle({
+                    uris: parseData[userId]
+                }, RCRTCMessageType.TOTAL_CONTENT_RESOURCE, userId);
+            }
+            const CDNUris = (_a = data.roomInfo.filter((item) => { return item.key === 'cdn_uris'; })[0]) === null || _a === void 0 ? void 0 : _a.value;
+            if (!CDNUris) {
+                return;
+            }
+            if (((_b = this._CDNUris) === null || _b === void 0 ? void 0 : _b.push_mode) === RCInnerCDNPushMode.MANUAL) {
+                this._callAppListener('onCDNEnableChange', (_c = this._CDNUris) === null || _c === void 0 ? void 0 : _c.enableInnerCDN);
+            }
+        });
+    }
+    /**
+     * 返回 CDN 是否可用
+     * @returns boolean
+     */
+    __getCDNEnable() {
+        var _a;
+        return (_a = this._CDNUris) === null || _a === void 0 ? void 0 : _a.enableInnerCDN;
+    }
+    /**
+     * 返回 CDN 推送模式: 自动 or 手动
+     * @returns boolean
+     */
+    __getCDNPushMode() {
+        var _a;
+        return (_a = this._CDNUris) === null || _a === void 0 ? void 0 : _a.push_mode;
     }
 }
 
@@ -10267,7 +10586,7 @@ const getCommonHeader = () => ({
     'Content-Type': 'application/json;charset=UTF-8',
     'Cache-Control': 'no-cache',
     ClientType: `web|${browserInfo.browser}|${browserInfo.version}`,
-    ClientVersion: "5.1.10-alpha.3",
+    ClientVersion: "5.2.2-alpha.1",
     'Client-Session-Id': getUUID(),
     'Request-Id': Date.now().toString()
 });
@@ -10435,7 +10754,25 @@ class RCMediaService {
             if (status === 200) {
                 logger.debug(`request success -> Request-Id: ${commonHeader['Request-Id']}`);
                 const data = JSON.parse(jsonStr);
-                return { code: data.resultCode };
+                return { code: data.resultCode, res: data };
+            }
+            return { code: exports.RCRTCCode.REQUEST_FAILED };
+        });
+    }
+    /**
+     * 房间内观众获取 CDN 资源信息、拉流地址
+     */
+    getCDNResourceInfo(headers, url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const commonHeader = getCommonHeader();
+            const { status, data: resStr } = yield this._runtime.httpReq({
+                url,
+                headers: Object.assign(Object.assign({}, commonHeader), headers),
+                method: engine.HttpMethod.GET
+            });
+            if (status === 200) {
+                const data = JSON.parse(resStr);
+                return { code: data.resultCode, res: data };
             }
             logger.warn(`request failed -> Request-Id: ${commonHeader['Request-Id']}, status: ${status}, url: ${url}`);
             return { code: exports.RCRTCCode.REQUEST_FAILED };
@@ -10580,12 +10917,15 @@ class RCAudienceClient {
             if (code !== exports.RCRTCCode.SUCCESS) {
                 return { code, tracks };
             }
-            // 直观观众订阅的是合流后的数据，并不存在流的归属问题，此处直接以虚拟生成的合流 id 替代 userId
+            // 直播观众订阅的是合流后的数据，并不存在流的归属问题，此处直接以虚拟生成的合流 id 替代 userId
             const mcuId = `rc_mcu_${Date.now()}`;
             const tag = 'RongCloudRTC';
-            this._subTracks.length = 0;
-            this._subTracks.push(new RCRemoteAudioTrack(tag, mcuId), new RCRemoteVideoTrack(tag, mcuId));
-            this._pc.updateSubRemoteTracks(this._subTracks.slice());
+            if (this._subTracks.length === 0) {
+                // 观众端单次只能订阅一个 liveUrl, 订阅后再次重复订阅只是修改订阅参数
+                // 重复订阅后之前订阅的流可直接根据参数变动，无需重新添加 transceiver
+                this._subTracks.push(new RCRemoteAudioTrack(tag, mcuId), new RCRemoteVideoTrack(tag, mcuId));
+                this._pc.updateSubRemoteTracks(this._subTracks.slice());
+            }
             const offer = yield this._pc.createOffer(true);
             const body = {
                 sdp: offer,
@@ -10685,6 +11025,19 @@ class RCAudienceClient {
     }
 }
 
+exports.RCInnerCDNPullKind = void 0;
+(function (RCInnerCDNPullKind) {
+    RCInnerCDNPullKind["RTMP"] = "rtmp";
+    RCInnerCDNPullKind["FLV"] = "flv";
+    RCInnerCDNPullKind["HLS"] = "hls";
+})(exports.RCInnerCDNPullKind || (exports.RCInnerCDNPullKind = {}));
+
+exports.RCInnerCDNPullIsHttps = void 0;
+(function (RCInnerCDNPullIsHttps) {
+    RCInnerCDNPullIsHttps[RCInnerCDNPullIsHttps["NOT_HTTPS"] = 0] = "NOT_HTTPS";
+    RCInnerCDNPullIsHttps[RCInnerCDNPullIsHttps["HTTPS"] = 1] = "HTTPS";
+})(exports.RCInnerCDNPullIsHttps || (exports.RCInnerCDNPullIsHttps = {}));
+
 const tinyConf = Object.assign(Object.assign({}, transResolution(exports.RCResolution.W176_H144)), { frameRate: transFrameRate(exports.RCFrameRate.FPS_15) });
 /**
  * 观众直播房间类
@@ -10693,12 +11046,12 @@ const tinyConf = Object.assign(Object.assign({}, transResolution(exports.RCResol
  * 2、观众订阅、取消订阅资源
  */
 class RCAudienceLivingRoom {
-    constructor(_context, _runtime, _initOptions, _roomId, _token, _livingType) {
+    constructor(_context, _runtime, _initOptions, _roomId, _joinResData, _livingType) {
         this._context = _context;
         this._runtime = _runtime;
         this._initOptions = _initOptions;
         this._roomId = _roomId;
-        this._token = _token;
+        this._joinResData = _joinResData;
         this._livingType = _livingType;
         this._roomAnchorList = [];
         this._roomRes = {};
@@ -10743,14 +11096,18 @@ class RCAudienceLivingRoom {
      * * key RC_ANCHOR_LIST value: 为主播 ID 集合
      * * key RC_RES_`userId` value: 为主播发布的资源
      * * key RC_RTC_SESSIONID value: sessionId
+     * * key RC_CDN value: CDN 资源数据
      */
     singalDataChange(singalData, roomId) {
+        var _a;
         if (roomId !== this._roomId) {
             logger.warn(`singalDataChange -> not the current room data: data roomId: ${roomId}, current roomId: ${this._roomId}`);
             return;
         }
         logger.debug('singalDataChange -> singalData:', JSON.stringify(singalData || {}));
         const allMcuUris = [];
+        const CDNUrisStr = (_a = singalData.filter((item) => { return item.key === 'RC_CDN'; })[0]) === null || _a === void 0 ? void 0 : _a.value;
+        CDNUrisStr && this._diffCDNUris(JSON.parse(JSON.parse(CDNUrisStr).cdn_uris)[0]);
         singalData.forEach(data => {
             const { key, value, timestamp, uid } = data;
             const isResKey = key.indexOf('RC_RES_') !== -1;
@@ -11104,7 +11461,7 @@ class RCAudienceLivingRoom {
         return {
             'App-Key': this._context.getAppkey(),
             RoomId: userId,
-            Token: this._token,
+            Token: this._joinResData.token,
             RoomType: engine.RTCMode.LIVE,
             UserId: userId,
             'Session-Id': this._sessionId
@@ -11213,6 +11570,123 @@ class RCAudienceLivingRoom {
             return { code: exports.RCRTCCode.SUCCESS };
         });
     }
+    /**
+     * 对比 cdn_uris 资源
+     * @param newCDNUris 新的 cdn_uris 数据
+     */
+    _diffCDNUris(newCDNUris) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        return __awaiter(this, void 0, void 0, function* () {
+            /**
+             * CDN 资源减少: 上次 CDNUris 中有 url，变更后无 url
+             */
+            if (((_a = this._CDNUris) === null || _a === void 0 ? void 0 : _a.url) && !newCDNUris.url) {
+                this._callAppListener('onCDNInfoDisable');
+                /**
+                 * 更新内存中存储的 cdn_uris 数据
+                 */
+                this._CDNUris = newCDNUris;
+                return;
+            }
+            /**
+             * CDN 资源新增条件:
+             * 内存中无 CDNUris 或
+             * 上次 CDNUris 无 url，变更后有 url
+             */
+            if (!this._CDNUris || (!((_b = this._CDNUris) === null || _b === void 0 ? void 0 : _b.url) && newCDNUris.url)) {
+                this._callAppListener('onCDNInfoEnable', {
+                    resolution: `W${newCDNUris.w}_H${newCDNUris.h}`,
+                    fps: newCDNUris.fps
+                });
+            }
+            /**
+             * CDN 资源变更: w、h、fps 其中一项变化
+             */
+            const isWChange = (((_c = this._CDNUris) === null || _c === void 0 ? void 0 : _c.w) && newCDNUris.w && (((_d = this._CDNUris) === null || _d === void 0 ? void 0 : _d.w) !== newCDNUris.w));
+            const isHChange = (((_e = this._CDNUris) === null || _e === void 0 ? void 0 : _e.h) && newCDNUris.h && (((_f = this._CDNUris) === null || _f === void 0 ? void 0 : _f.h) !== newCDNUris.h));
+            const isFpsChange = (((_g = this._CDNUris) === null || _g === void 0 ? void 0 : _g.fps) && newCDNUris.fps && (((_h = this._CDNUris) === null || _h === void 0 ? void 0 : _h.fps) !== newCDNUris.fps));
+            if (isWChange || isHChange || isFpsChange) {
+                this._callAppListener('onCDNInfoChange', {
+                    resolution: `W${newCDNUris.w}_H${newCDNUris.h}`,
+                    fps: newCDNUris.fps
+                });
+            }
+            /**
+             * 更新内存中存储的 cdn_uris 数据
+             */
+            this._CDNUris = newCDNUris;
+        });
+    }
+    /**
+     * 获取 CDN 资源对应的拉流地址
+     * 首次获取 CDNPlayUrl 时，需传入 url，
+     * 业务层调用时使用内存中 _CDNUris 的 url，无 _CDNUris 时说明观众端未赋值过 _CDNUris
+     * @returns CDNPlayUrl
+     */
+    _getCDNPlayUrl(params, url) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const { w, h, fps } = params;
+            const kind = this._initOptions.pullInnerCDNProtocol || exports.RCInnerCDNPullKind.FLV;
+            const useHttps = (this._initOptions.pullInnerCDNUseHttps === exports.RCInnerCDNPullIsHttps.NOT_HTTPS) ? exports.RCInnerCDNPullIsHttps.NOT_HTTPS : exports.RCInnerCDNPullIsHttps.HTTPS;
+            /**
+             * 加入房间后拉 KV 数据，数据还未返回时，同步拉 KV 获取 CDN 信息
+             */
+            if (!((_a = this._CDNUris) === null || _a === void 0 ? void 0 : _a.url) && !url) {
+                logger.error(`cdn_uris url is empty, the anchor need to start CDN, code: ${exports.RCRTCCode.CDN_RESOURCE_IS_EMPTY}`);
+                return { code: exports.RCRTCCode.CDN_RESOURCE_IS_EMPTY };
+            }
+            const headers = {
+                'App-Key': this._context.getAppkey(),
+                Token: this._joinResData.token,
+                RoomId: this.getRoomId(),
+                UserId: this._context.getCurrentId(),
+                SessionId: this.getSessionId()
+            };
+            const paramsArr = [];
+            w && paramsArr.push(`w=${w}`);
+            h && paramsArr.push(`h=${h}`);
+            fps && paramsArr.push(`fps=${fps}`);
+            paramsArr.push(`kind=${kind}`);
+            paramsArr.push(`is_https=${useHttps}`);
+            const paramsStr = paramsArr.join('&');
+            let requestUrl = `${url || ((_b = this._CDNUris) === null || _b === void 0 ? void 0 : _b.url)}?`;
+            paramsStr && (requestUrl += paramsStr);
+            const { code, res } = yield this._service.getCDNResourceInfo(headers, requestUrl);
+            if (code !== exports.RCRTCCode.SUCCESS) {
+                logger.error(`getCDNPlayUrl failed: ${code}`);
+                return { code };
+            }
+            logger.info(`getCDNPlayUrl success: ${res === null || res === void 0 ? void 0 : res.data.pull_url}`);
+            return {
+                code,
+                CDNPlayUrl: res === null || res === void 0 ? void 0 : res.data.pull_url
+            };
+        });
+    }
+    /**
+     * 获取 CDN 资源对应的拉流地址
+     * @returns CDNPlayUrl
+     */
+    getCDNPlayUrl(resolution, fps) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (resolution && !isValidResolution(resolution)) {
+                logger.error('`resolution` is invalid');
+                return { code: exports.RCRTCCode.PARAMS_ERROR };
+            }
+            if (fps && !isValidFPS(fps)) {
+                logger.error('`fps` is invalid');
+                return { code: exports.RCRTCCode.PARAMS_ERROR };
+            }
+            const { width, height } = resolution ? transResolution(resolution) : { width: null, height: null };
+            const fpsNum = fps ? transFrameRate(fps) : null;
+            const params = {};
+            width && (params.w = width);
+            height && (params.h = height);
+            fpsNum && (params.fps = fpsNum);
+            return this._getCDNPlayUrl(params);
+        });
+    }
     /**
      * 订阅资源
      * @param tracks
@@ -11270,6 +11744,8 @@ class RCAudienceLivingRoom {
             this._pc.destroy();
             // 销毁 polarisReport 实例
             this._polarisReport = null;
+            // 清空 onrtcdatachange 事件监听
+            this._context.onrtcdatachange = () => { };
         });
     }
     /**
@@ -11311,7 +11787,12 @@ class RCAudienceLivingRoom {
      * @param tag 参数描述
      */
     registerRoomEventListener(listener) {
+        var _a;
         this._appListener = listener;
+        if (!listener) {
+            return;
+        }
+        ((_a = this._joinResData.kvEntries) === null || _a === void 0 ? void 0 : _a.length) && this.singalDataChange(this._joinResData.kvEntries, this._roomId);
     }
     /**
      * 音量上报
@@ -11516,7 +11997,12 @@ class RCRTCClient {
             logger.debug(`JoinRoom success -> userId: ${this._context.getCurrentId()}, roomId: ${roomId}, data: ${JSON.stringify(data)}`);
             const room = new RCLivingRoom(this._context, this._runtime, roomId, data, this._service, this._options, this._releaseCrtRoomObj.bind(this), livingType, false);
             this._crtRoom = room;
-            return { room, code: exports.RCRTCCode.SUCCESS, userIds: room.getRemoteUserIds(), tracks: room.getRemoteTracks() };
+            const joinLivingResData = { room, code: exports.RCRTCCode.SUCCESS, userIds: room.getRemoteUserIds(), tracks: room.getRemoteTracks() };
+            // 手动模式时，用户加入房间，需返回 CDN 开关状态
+            if (room.__getCDNPushMode() === RCInnerCDNPushMode.MANUAL) {
+                Object.assign(joinLivingResData, { CDNEnable: room.__getCDNEnable() });
+            }
+            return joinLivingResData;
         });
     }
     /**
@@ -11627,7 +12113,8 @@ class RCRTCClient {
                     deviceId: options === null || options === void 0 ? void 0 : options.cameraId,
                     frameRate: transFrameRate((options === null || options === void 0 ? void 0 : options.frameRate) || exports.RCFrameRate.FPS_15),
                     width,
-                    height
+                    height,
+                    facingMode: options === null || options === void 0 ? void 0 : options.faceMode
                 }
             });
             if (code !== exports.RCRTCCode.SUCCESS) {
@@ -11645,7 +12132,7 @@ class RCRTCClient {
      * @returns
      */
     createMicrophoneAndCameraTracks(tag = 'RongCloudRTC', options) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f;
         return __awaiter(this, void 0, void 0, function* () {
             const tracks = [];
             if (!isValidTag(tag)) {
@@ -11662,9 +12149,10 @@ class RCRTCClient {
                     deviceId: (_b = options === null || options === void 0 ? void 0 : options.video) === null || _b === void 0 ? void 0 : _b.cameraId,
                     frameRate: transFrameRate(((_c = options === null || options === void 0 ? void 0 : options.video) === null || _c === void 0 ? void 0 : _c.frameRate) || exports.RCFrameRate.FPS_15),
                     width,
-                    height
+                    height,
+                    facingMode: (_d = options === null || options === void 0 ? void 0 : options.video) === null || _d === void 0 ? void 0 : _d.faceMode
                 },
-                audio: { deviceId: (_d = options === null || options === void 0 ? void 0 : options.audio) === null || _d === void 0 ? void 0 : _d.micphoneId, sampleRate: (_e = options === null || options === void 0 ? void 0 : options.audio) === null || _e === void 0 ? void 0 : _e.sampleRate }
+                audio: { deviceId: (_e = options === null || options === void 0 ? void 0 : options.audio) === null || _e === void 0 ? void 0 : _e.micphoneId, sampleRate: (_f = options === null || options === void 0 ? void 0 : options.audio) === null || _f === void 0 ? void 0 : _f.sampleRate }
             });
             if (code !== exports.RCRTCCode.SUCCESS) {
                 return { code, tracks };
@@ -11887,7 +12375,8 @@ class RCRTCClient {
                 logger.error('audienceJoinLivingRoomError:', code);
                 return { code: exports.RCRTCCode.SIGNAL_AUDIENCE_JOIN_ROOM_FAILED };
             }
-            const room = new RCAudienceLivingRoom(this._context, this._runtime, this._options, roomId, data.token, livingType);
+            logger.info(`joinLivingRoomAsAudience success, room data: ${JSON.stringify(data)}`);
+            const room = new RCAudienceLivingRoom(this._context, this._runtime, this._options, roomId, data, livingType);
             this._crtAudienceLivingRoom = room;
             return { room, code: exports.RCRTCCode.SUCCESS };
         });
@@ -11948,18 +12437,13 @@ class RCRTCClient {
             if (this._crtAudienceLivingRoom) {
                 return { code: exports.RCRTCCode.REPERT_JOIN_ROOM };
             }
-            const singalCode = yield room.__unpublishToSingal();
-            if (singalCode !== engine.ErrorCode.SUCCESS) {
-                logger.error('change room identity setAllUris error', singalCode);
-                return { code: exports.RCRTCCode.SIGNAL_ERROR };
-            }
             const { code, data } = yield this._context.rtcIdentityChange(room._roomId, engine.RTCIdentityChangeType.AnchorToViewer, room.getLivingType());
             if (code !== engine.ErrorCode.SUCCESS) {
                 logger.error('change room identity error', code);
                 return { code: exports.RCRTCCode.SIGNAL_ROOM_CHANGE_IDENTITY_FAILED };
             }
-            const { token } = data;
-            const crtRoom = new RCAudienceLivingRoom(this._context, this._runtime, this._options, room._roomId, token, room.getLivingType());
+            logger.info(`downgradeToAudienceRoom success, room data: ${JSON.stringify(data)}`);
+            const crtRoom = new RCAudienceLivingRoom(this._context, this._runtime, this._options, room._roomId, data, room.getLivingType());
             this._crtAudienceLivingRoom = crtRoom;
             // 主播房间内存数据清除及停止 Signal 房间心跳
             this._crtRoom.__destroy(false);
@@ -11970,15 +12454,11 @@ class RCRTCClient {
     }
     /**
      * 获取在房间内用户信息
-     * 当前仅能查自己
-     * @since version 5.1.5
+     * @since version 5.2.1
      */
-    getJoinedUserInfo(userId) {
+    getJoinedRoomInfo() {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!engine.validate('userId', userId, engine.notEmptyString, true)) {
-                return { code: exports.RCRTCCode.PARAMS_ERROR };
-            }
-            const { code, data } = yield this._context.getRTCJoinedUserInfo(userId);
+            const { code, data } = yield this._context.getRTCJoinedUserInfo(this._context.getCurrentId());
             if (code !== engine.ErrorCode.SUCCESS) {
                 logger.error('getJoinedUserInfo error', code);
                 return { code: exports.RCRTCCode.SIGNAL_ROOM_CHANGE_IDENTITY_FAILED };
@@ -12000,33 +12480,6 @@ exports.RCKickReason = void 0;
     RCKickReason[RCKickReason["OTHER_KICK"] = 2] = "OTHER_KICK";
 })(exports.RCKickReason || (exports.RCKickReason = {}));
 
-/**
- * 获取 Microphone 列表
- */
-const getMicrophones = () => __awaiter(void 0, void 0, void 0, function* () {
-    const mediaDivices = yield navigator.mediaDevices.enumerateDevices();
-    return mediaDivices.filter(item => item.kind === 'audioinput');
-});
-/**
- * 获取摄像头设备列表
- */
-const getCameras = () => __awaiter(void 0, void 0, void 0, function* () {
-    const mediaDevices = yield navigator.mediaDevices.enumerateDevices();
-    return mediaDevices.filter(item => item.kind === 'videoinput');
-});
-/**
- * 获取扬声器设备列表
- */
-const getSpeakers = () => __awaiter(void 0, void 0, void 0, function* () {
-    const mediaDevices = yield navigator.mediaDevices.enumerateDevices();
-    return mediaDevices.filter(item => item.kind === 'audiooutput');
-});
-const device = {
-    getCameras,
-    getMicrophones,
-    getSpeakers
-};
-
 /**
  * RTC 插件生成器
  * @public
@@ -12042,12 +12495,17 @@ const installer = {
             logger.error('Please use the https protocol or use `http://localhost` to open the page!');
             return false;
         }
+        engine.VersionManage.add('plugin-rtc', "5.2.2-alpha.1");
+        if (!engine.VersionManage.validEngine("~4.5.1")) {
+            logger.error(`The current engine version '${engine.VersionManage.getInfo().engine}' error, plugin-rtc required engine version at least '${"~4.5.1"}'.`);
+            return false;
+        }
         return true;
     },
     setup(context, runtime, options = {}) {
         logger.setLogLevel(options.logLevel);
         logger.setLogStdout(options.logStdout);
-        logger.warn(`RCRTC Version: ${"5.1.10-alpha.3"}, Commit: ${"799cc871ab8fce4eb595d368ebaa84664d101f6f"}`);
+        logger.warn(`RCRTC Version: ${"5.2.2-alpha.1"}, Commit: ${"de4f9bc28bbee35d2d5f206a68144c89c098573f"}`);
         logger.warn(`browserInfo.browser -> ${browserInfo.browser}`);
         logger.warn(`browserInfo.supportsUnifiedPlan -> ${browserInfo.supportsUnifiedPlan}`);
         logger.warn(`browserInfo.version -> ${browserInfo.version}`);