快速开始

使用文档前准备

1 前提条件

  • 互动工具

    实现互动直播功能需要具互动工具,微吼云提供互动直播SDK及体验Demo,可以通过Demo进行互动直播

    通过微吼云提供的下载页,下载安装互动直播SDK及Demo。

2 操作步骤

2.1 登录

登录微吼云控制台

2.2 创建应用

详情参考如何创建应用

2.3 获取app_id

详情参考如何获取app_id

2.4 设置包名&签名

如需集成移动端SDK,则需设置包名&签名,详情参考设置包名&签名

2.5 添加服务

创建应用后,点击添加服务,弹出添加服务对话框,选择互动直播服务,点击确定,互动直播服务添加成功。

添加互动直播服务

互动直播服务

2.6 获取互动直播房间id

用户可通过控制台查询互动直播房间ID,也可通过接口和API在线测试工具进行查询。

2.6.1 控制台查询

在互动管理房间管理页面可查询互动直播的房间ID,具体如下图

2.6.2 接口查询

可通过接口获取room_id,具体参考创建互动房间

2.6.3 API在线测试工具查询

参考通过在线测试接口工具完成获取room_id。

2.7 获取旁路直播房间id

room_id 即为 直播房间ID ,以下简称 room_id ,用户可通过控制台查询 room_id,也可通过 API接口 和 API在线测试工具 进行查询。

2.7.1 控制台查询

在直播管理房间管理页面可查询直播间的 房间ID 字段即为 room_id,具体如下图

控制台查询

2.7.2 API接口查询

通过接口创建并获取 room_id,具体参考创建房间接口

2.7.3 API在线测试工具

通过API在线测试工具获取直播房间ID

2.8 获取access_token

access_token即权限,调用接口生成access_token将传入SDK,SDK在请求时会附带access_token,具体方式参考生成access_token接口和API在线测试工具。

: access_token过期时间,默认为一天,最大为一天,过期后需要重新生成access_token。

2.8.1 接口获取

可通过接口获取access_token,具体参考生成access_token接口。

2.8.2 API在线测试工具获取

参考通过在线测试接口工具完成获取access_token。

互动直播

JS SDK Demo

主持端

1 演示地址

https://static.vhallyun.com//jssdk/vhall-jssdk-interaction/test/index.html

2 开始互动

依次填写app_id和互动直播ID,点击开始互动,则进入互动直播房间

3 互动直播

进入互动直播房间后可在房间内进行设置、上麦、下麦、关闭/开启声音、关闭/开启画面、开启/关闭旁路直播、退出房间、用户管理操作。

设置:支持对视、音频设备和视频参数进行设置

上麦:有上麦权限,直接点击上麦,即可进行上麦

下麦:点击下麦,用户下麦,停止直播

开启/关闭视频:点击开启视频可采集视频画面,点击关闭视频将无法采集视频画面

开启/关闭音频:点击开启音频可采集声音,点击关闭音频将无法采集声音

开启/关闭旁路:点击开启旁路,弹出填写旁路直播房间ID的对话框,填写完毕点击确定,即可将混流画面推送至旁路直播房间;点击关闭旁路停止向旁路直播房间进行推流

用户列表:包含用户列表和被踢用户列表,可以查看列表中的所有人员,并可对列表中的人员进行操作,操作项包含踢出房间、邀请上麦、下麦三种

退出房间:点击退出房间则退出互动房间

观众端

1 演示地址

https://static.vhallyun.com/jssdk/vhall-jssdk-interaction/test/guest.html?v=20180611

2 开始互动

依次填写app_id和互动直播ID,点击开始互动,则进入互动直播房间

3 互动直播

进入互动直播房间后可在房间内进行设置、上麦、下麦、请求上麦、关闭/开启声音、关闭/开启画面、退出房间。

设置:支持选择摄像头/麦克风,支持设置分辨率、帧率

上麦/下麦:有上麦权限的观众端,点击上麦,即可在观众端进行上麦互动;点击下麦,即下麦停止互动。

请求上麦:不具备上麦权限的观众端,点击请求上麦,向主持端发起请求,主持端收到请求并通过,观众即可上麦进行互动。

关闭/开启声音:点击开启声音可采集声音,点击关闭声音将无法采集声音

关闭/开启画面:点击开启画面可采集视频画面,点击关画面频将无法采集视频画面

退出房间:点击退出房间则退出互动房间

iOS SDK Demo

具体参考Demo使用指南

Android SDK Demo

具体参考Demo使用指南