声网直播间模块
1、SDK说明
文档地址:文档
文档左上角切换平台
使用Lite版本SDK即可
2、使用的API大纲
API未区分平台,请自行根据Api关键字去对应平台文档中找到一致的API使用
| Function | API | Desc |
|---|---|---|
| 初始化RtcEngine | createAgoraRtcEngine、engine.initialize | 使用声网AppId初始化RtcEngine |
| 观众:设置远端画面渲染模式 | setRemoteRenderMode(streamerId,renderModeHidden,videoMirrorModeAuto) | 设置远端渲染模式防止画面无法铺满或变形,只有观众调用这个 |
| 设置房间模式 | setChannelProfile(channelProfileLiveBroadcasting) | 调用这个设置引擎房间为直播模式 |
| 设置房间角色 | setClientRole(role,option) 主播:clientRoleBroadcaster,观众:role:clientRoleAudience,option内设置为极速直播audienceLatencyLevelLowLatency |
主播设置自己的角色是直播者,观众设置自己的角色是观众且只观看极速流 |
| 设置音频模式 | setAudioProfile(profile:audioProfileDefault,scenario:audioScenarioGameStreaming) | 设置直播声音的音频信道模式 |
| 主播:开启本地音视频流预览并允许在加入房间后推流 | enableVideo()、enableLocaVideo(true)、enableLocalAudio(true)、 startPreview() | 主播加入房间前的准备工作 |
| 观众:允许在加入房间后拉取音视频流 | enableVideo()、enableAudio() | 观众加入房间前的准备工作 |
| 观众:设置远端音量为最大音量 | adjustPlaybackSignalVolume(400) | |
| 观众:默认打开扬声器 | setDefaultAudioRouteToSpeakerphone(true) | |
| 设置房间事件监听 | registerEventHandler() | 监听直播间的各种回调 |
| 加入直播间 | joinChannel() | |
| 离开直播间 | leaveChannel() | |
| 销毁engine | release() or destroy() | |
| 直播画面截图 | takeSnapshot() |
3、流程概述
详细流程参见产品流程图和原型图
主播:
- 打开开播页面,同时初始化Rtc Engine, 预览本机摄像头画面
- 调用房间基础信息接口,获取当前是否可以开播
- 请求开播接口开播,使用接口返回的rtc配置信息加入直播间并开始推流
- 开播后请求心跳轮询接口,对接口数据进行响应
- 开播后按照心跳轮训接口的结果要求,对直播画面进行截图上传
- 关闭直播: 调用RTC API退出房间,调用关播接口,根据接口结果显示本次直播结算页面
观众:
- 选择一个直播间进入
- 请求加入直播间接口,并根据接口结果初始化Rtc Engine,调用RTC API加入房间
- 加入直播间后,开始请求心跳轮询接口,对接口数据进行响应
- 主动退出:调用RTC API退出房间,调用退出直播间接口,关闭页面
- 主播关播:调用RTC API退出房间,调用退出直播间接口,关闭页面,toast提示直播已关闭