Skip to content

声网直播间模块

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、流程概述

详细流程参见产品流程图和原型图

主播:

  1. 打开开播页面,同时初始化Rtc Engine, 预览本机摄像头画面
  2. 调用房间基础信息接口,获取当前是否可以开播
  3. 请求开播接口开播,使用接口返回的rtc配置信息加入直播间并开始推流
  4. 开播后请求心跳轮询接口,对接口数据进行响应
  5. 开播后按照心跳轮训接口的结果要求,对直播画面进行截图上传
  6. 关闭直播: 调用RTC API退出房间,调用关播接口,根据接口结果显示本次直播结算页面

观众:

  1. 选择一个直播间进入
  2. 请求加入直播间接口,并根据接口结果初始化Rtc Engine,调用RTC API加入房间
  3. 加入直播间后,开始请求心跳轮询接口,对接口数据进行响应
  4. 主动退出:调用RTC API退出房间,调用退出直播间接口,关闭页面
  5. 主播关播:调用RTC API退出房间,调用退出直播间接口,关闭页面,toast提示直播已关闭