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

package/dist/index.umd.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.
  */
 (function (global, factory) {
@@ -110,8 +110,12 @@
         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 @@
         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 @@
                         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 @@
                     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 @@
         });
         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 @@
          * 加入房间
          */
         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 @@
         }
     }
 
-    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 @@
             /**
              * 观众升级为主播后不会收到全量 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 @@
          * @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 @@
                         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 @@
                     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 @@
                         rTrack.isAudioTrack() ? this._onAudioMuteChange(rTrack) : this._onVideoMuteChange(rTrack);
                     });
                 });
+                return { data };
             });
         }
         _onAudioMuteChange(audioTrack) {
@@ -9663,35 +9769,7 @@
         /**
          * 观众切换为主播后直接处理人员变更及资源变更
          */
-        _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 @@
         /**
          * trackId 有效性验证方法
          */
-        _isValidTrackId) {
+        _isValidTrackId, 
+        /**
+         * 扩散 cdn_uris
+         */
+        _sendCDNInfoSignal) {
             this._onFlush = _onFlush;
             this._isValidTrackId = _isValidTrackId;
+            this._sendCDNInfoSignal = _sendCDNInfoSignal;
             /**
              * mcu 配置数据，每次向服务器提交全量数据
              */
@@ -10158,24 +10241,62 @@
          * 使已修改的配置生效，在调用该方法前，所有数据只会对本地配置进行修改，不会产生实际效果
          */
         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 @@
                     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 @@
         '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 @@
                 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 @@
                 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 @@
         }
     }
 
+    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 @@
      * 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 @@
          * * 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 @@
             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 @@
                 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 @@
                 this._pc.destroy();
                 // 销毁 polarisReport 实例
                 this._polarisReport = null;
+                // 清空 onrtcdatachange 事件监听
+                this._context.onrtcdatachange = () => { };
             });
         }
         /**
@@ -11311,7 +11787,12 @@
          * @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 @@
                 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 @@
                         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 @@
          * @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 @@
                         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 @@
                     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 @@
                 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 @@
         }
         /**
          * 获取在房间内用户信息
-         * 当前仅能查自己
-         * @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 @@
         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 @@
                 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}`);