互动连麦

微吼 JS SDK 观众支持加入互动直播，并参与互动连麦，与主持人、嘉宾及其他上麦观众实时交流互动。

兼容性要求

建议使用 Chrome 74 及以上与 Safari 13.0.4 及以上版本的浏览器。

浏览器访问链接必须为 https 安全连接。

对于高画质（720P 以上）的视频互动，对计算机硬件与网络要求较高，请斟酌使用。

应用企业防火墙限制

功能描述

如要使用微吼直播连麦服务，需要对特定的服务域名和端口开通权限。因此如果你处在有网络访问限制的环境中，则需要执行以下操作。

配置以下域名和端口为白名单

域名：

vrtc-signal01.e.vhall.com

vrtc-signal02.e.vhall.com

vrtc-signal41.e.vhall.com

端口：

协议	目标端口	操作
TCP	80, 443, 8080, 8081, 3478	允许
UDP	3478, 50000-50050	允许

互动连麦集成说明

实例化 VhallSDK 之后，用 vhallSDK 的实例句柄下 interact 模块实现互动连麦功能。通过 interact 可以创建一个音视频互动房间的实例，同时也可以进行本地媒体采集设备调试。

互动连麦业务流程：

查看大图

方法列表

序号	API 方法	说明	支持版本
1	getMicData	获取互动连麦数据	3.5.0 及以上
2	userAgreeInvite	主持人邀请用户上麦，用户同意上麦	3.5.0 及以上
3	refuseInviteConnect	主持人邀请用户上麦，用户拒绝上麦	3.5.0 及以上
4	speakOff	观众下麦	3.5.0 及以上
5	useApplyMic	观众申请上麦	3.5.0 及以上
6	userCancelApply	取消申请上麦	3.5.0 及以上
7	setDeviceStatus	上麦后音/视频开关	3.5.0 及以上
8	subscribeRemoteStream	订阅远端流	3.5.0 及以上
9	getStreamPacketLoss	获取网络信号强度	3.5.0 及以上
10	getAudioLevel	获取麦克风音量强度值	3.5.0 及以上
11	getCameraList	获取本地摄像头设备列表	3.5.0 及以上
12	getSpeakersList	获取本地扬声器设备列表	3.5.0 及以上
13	getMicrophonesList	获取本地麦克风设备列表	3.5.0 及以上
14	createALocalPreviewInstance	创建本地视频流预览实例	3.5.0 及以上
15	destroyLocalStream	销毁本地视频采集流	3.5.0 及以上
16	mediaSettingsUploadPictures	本地图片上传（图片采集流）	3.5.0 及以上
17	setAudioInput	设置音频输入源	3.5.0 及以上
18	cancelAnalyserUpdates	销毁本地麦克风实例	3.5.0 及以上
19	saveMediaSettings	保存媒体设置	3.5.0 及以上
20	setVideoType	设置本地采集设备流的类型	3.5.0 及以上

获取互动连麦数据

方法：getMicData
示例：

主持人邀请用户上麦，用户同意上麦

方法：userAgreeInvite
示例：

同意上麦成功，将自动进行上麦操作,异常将会在 error 消息中返回

主持人邀请用户上麦，用户拒绝上麦

方法：refuseInviteConnect
示例：

观众下麦

方法：speakOff
示例：

观众申请上麦

方法：useApplyMic
示例：

取消申请上麦

方法：userCancelApply
示例：

上麦后音/视频开关

方法：setDeviceStatus
示例：

订阅远端流

方法：subscribeRemoteStream
示例：

同 3.4.0 及以下版本 subscribe 方法,待删除方法，不建议使用

获取网络信号强度

方法：getStreamPacketLoss
示例：

获取麦克风音量强度值

方法：getAudioLevel
示例：

设置音视频设备

媒体设置方便用户检测本地音/视频设备是否正常，以及互动流切换等。

获取本地摄像头设备列表

方法：getCameraList
示例：

获取本地摄像头设备列表

该方法返回当前本地摄像头可用设备列表

获取本地扬声器设备列表

方法：getSpeakersList
示例：

该方法返回当前本地扬声器可用设备列表

获取本地麦克风设备列表

方法：getMicrophonesList
示例：

支持版本： 3.5.0 及以上

该方法返回当前本地麦克风可用设备列表

创建本地视频流预览实例

方法：createALocalPreviewInstance
示例：

该方法，需要在 html 中建立占位的标签，id 预设为方法的 videoNode 参数值

应配合 destroyLocalStream 销毁方法一起使用，详见用例

销毁本地视频采集流

方法：destroyLocalStream
示例：

本地图片上传（图片采集流）

方法：mediaSettingsUploadPictures
示例：

该方法依赖 input type 类型为 file 的文件域，在 onchange 事件中调用，参数为 event 对象

设置音频输入源

方法：setAudioInput
示例：

销毁本地麦克风实例

方法：cancelAnalyserUpdates
示例：

保存媒体设置

方法：saveMediaSettings
示例：

调用该方法需要用到本地存储（sessionStorage），详见示例。

设置本地采集设备流的类型

方法：setVideoType
示例：

互动连麦事件消息

错误码

全局错误码

兼容性要求#

应用企业防火墙限制#

功能描述#

配置以下域名和端口为白名单#

域名：#

端口：#

互动连麦集成说明#

互动连麦业务流程：#

方法列表#

获取互动连麦数据#

主持人邀请用户上麦，用户同意上麦#

主持人邀请用户上麦，用户拒绝上麦#

观众下麦#

观众申请上麦#

取消申请上麦#

上麦后音/视频开关#

订阅远端流#

获取网络信号强度#

获取麦克风音量强度值#

设置音视频设备#

获取本地摄像头设备列表#

获取本地扬声器设备列表#

获取本地麦克风设备列表#

创建本地视频流预览实例#

销毁本地视频采集流#

本地图片上传（图片采集流）#

设置音频输入源#

销毁本地麦克风实例#

保存媒体设置#

设置本地采集设备流的类型#

互动连麦事件消息#

错误码#

兼容性要求

应用企业防火墙限制

功能描述

配置以下域名和端口为白名单

域名：

端口：

互动连麦集成说明

互动连麦业务流程：

方法列表

获取互动连麦数据

主持人邀请用户上麦，用户同意上麦

主持人邀请用户上麦，用户拒绝上麦

观众下麦

观众申请上麦

取消申请上麦

上麦后音/视频开关

订阅远端流

获取网络信号强度

获取麦克风音量强度值

设置音视频设备

获取本地摄像头设备列表

获取本地扬声器设备列表

获取本地麦克风设备列表

创建本地视频流预览实例

销毁本地视频采集流

本地图片上传（图片采集流）

设置音频输入源

销毁本地麦克风实例

保存媒体设置

设置本地采集设备流的类型

互动连麦事件消息

错误码