实现低延迟直播
融云开发者账户是使用融云 SDK 产品的必要条件。在开始之前,请先前往 融云官网注册开发者账户。注册 后,控制台将自动为您创建一个应用,默认为开发环境应用,使用国内数据中心。请获取该应用的 App Key,在本教程中使用。
首次使用融云音视频的用户,建议参考文档 运行示例项目,以完成开发者账号注册、音视频服务开通等工作。
步骤 1:服务开通
您在融云创建的应用默认不会启用音视频服务。在使用融云提供的任何音视频服务前,您需要前往控制台,为应用开通音视频服务和音视频直播服务。
具体步骤请参阅 开通音视频服务。
服务开通、关闭等设置完成后 30 分钟后生效。
步骤 2:SDK 导入
您需要导入融云音视频核心能力库 RTCLib,和 RTC 业 务所依赖的即时通讯能力库 IMLib。根据您的业务需求,可选择导入美颜扩展库和 CDN 扩展库。
具体步骤请参阅 导入 SDK。
步骤 3:代码混淆
若开发者发布的 App 启用代码混淆,请务必在 app/proguard-rules.pro 文件添加如下配置:
-keepattributes Exceptions,InnerClasses
-keepattributes Signature
#RongRTCLib
-keep public class cn.rongcloud.** {*;}
#RongIMLib
-keep class io.rong.** {*;}
-keep class cn.rongcloud.** {*;}
-keep class * implements io.rong.imlib.model.MessageContent {*;}
-dontwarn io.rong.push.**
-dontnote com.xiaomi.**
-dontnote com.google.android.gms.gcm.**
-dontnote io.rong.**
-ignorewarnings
步骤 4:权限配置
-
在
AndroidManifest.xml
中声明 SDK 需要的所有权限。<!-- 音视频需要网络权限 和 监听网络状态权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 摄像头采集需要 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- 音频采集需要 -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> -
如果您的应用需要支持 Android 6.0(API 级别 23)或更高版本的设备,您还需要在 App 用户使用对应功能时请求摄像头(
CAMERA
)、麦克风(RECORD_AUDIO
)权限。详见 Android 开发者官方文档运行时权限与请求权限的工作流。
步骤 5:使用 App Key 初始化
RTCLib 依赖融云即时通讯客户端(IM)SDK 提供信令通道。要在您的应用程序中集成和运行,您需要先对 IM SDK 进行初始化。在成功建立 IM 连接后再初始化 RTCLib SDK。
融云即时通讯客户端 SDK 核心类为 RongCoreClient 和 RongIMClient
。在 Application 的 onCreate()
方法中,调用 RongIMClient
的初始化方法,传入生产或开发环境的 App Key。如果不换 AppKey,在整个应用生命周期中,初始化一次即可。
如果 IM SDK 版本 ≧ 5.4.2,请使用以下初始化方法。
String appKey = "Your_AppKey"; // example: bos9p5rlcm2ba
InitOption initOption = new InitOption.Builder().build();
RongIMClient.init(getApplicationContext(), appKey, initOption);
初始化配置(InitOption
)中封装了区域码(AreaCode),导航服务地址(naviServer
)、文件服务地址(fileServer
)、数据统计服务地址(statisticServer
)配置,以及是否开启推送的开关(enablePush
)和主进程开关(isMainProcess
)。不传入任何配置表示全部使用默认配置。SDK 默认连接北京数据中心。
如果 App Key 不属于中国(北京)数据中心,则必须传入有效的初始化配置。
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
// IMLib 初始化
RongIMClient.init(this, "从控制台申请的 AppKey");
}
}
关于 IM SDK 初始化的更多配置请参见初始化。
步骤 6:连接融云服务器
音视频用户之间的信令传输依赖于融云的即时通信(IM)服务,因此需要先调用 connect
与 IM 服务建立好 TCP 长连接。建议在功能模块的加载位置处调用,之后再进行音视频直播业务。当模块退出后调用 disconnect
或 logout
断开该连接。
IM 连接成功建立后可以初始化 RTCLib SDK。部分 RTC 引擎必须在初始化时提供,详见引擎配置。
RongIMClient.connect("从您服务器端获取的 Token", new RongIMClient.ConnectCallback() {
@Override
public void onSuccess(String userId) {
// 连接成功
// RTCLib 初始化
RCRTCConfig.Builder config = RCRTCConfig.Builder.create();
RCRTCEngine.getInstance().init(context, config.build());
}
@Override
public void onError(RongIMClient.ConnectionErrorCode code) {
// 连接失败
}
@Override
public void onDatabaseOpened(RongIMClient.DatabaseOpenStatus databaseOpenStatus) {
// 数据库打开失败
}
});
主播端
多人之间想要发起音视频通话,需要加入同一个音视频房间。对于直播需求来讲,房间类型需选择 LIVE_AUDIO_VIDEO
或 LIVE_AUDIO
,即音视频直播间或纯音频直播间。加入房间的角色也分为主播(BROADCASTER)和观众(AUDIENCE),下面就这两种身份,分别进行说明。
步骤 6.1:加入房间
-
构建 RoomConfig,指定房间类型和主播身份:
RCRTCRoomConfig roomConfig = RCRTCRoomConfig.Builder.create()
// 根据实际场景,选择音视频直播:LIVE_AUDIO_VIDEO 或音频直播:LIVE_AUDIO
.setRoomType(RCRTCRoomType.LIVE_AUDIO_VIDEO)
.setLiveRole(BROADCASTER)
.build(); -
调用 RCRTCEngine 下的 joinRoom 方法创建并加入一个直播房间:
RCRTCEngine.getInstance().joinRoom("直播间 ID", roomConfig, new IRCRTCResultDataCallback<RCRTCRoom>() {
@Override
public void onSuccess(final RCRTCRoom room) {
// 保存房间对象
this.rtcRoom = room;
}
@Override
public void onFailed(RTCErrorCode code) {
}
});
客户端通过 joinRoom()
传入的直播间 ID 来加入不同房间。房间不需要客户端创建或销毁,融云服务若发现该房间不存在时会自动创建。当所有主播(只有观众不算)离开持续 24 小时后,服务会自动销毁该房间。
步骤 6.2:发布音视频流
-
加入房间后,开始摄像头采集并发布音视频流。
RCRTCEngine.getInstance().getDefaultVideoStream().startCamera(null);
rtcRoom.getLocalUser().publishDefaultLiveStreams(new IRCRTCResultDataCallback<RCRTCLiveInfo>() {
@Override
public void onSuccess(RCRTCLiveInfo liveInfo) {
}
@Override
public void onFailed(RTCErrorCode code) {
}
}); -
调用 RCRTCLocalUser 下的 getStreams 方法获取主播推送的本地流,获得的视频流可用于本地的预览。
public void getVideoStream(List<RCRTCVideoOutputStream> outputStreams, List<RCRTCVideoInputStream> inputStreams) {
for (final RCRTCRemoteUser remoteUser : mRtcRoom.getRemoteUsers()) {
if (remoteUser.getStreams().size() == 0) {
continue;
}
List<RCRTCInputStream> userStreams = remoteUser.getStreams();
for (RCRTCInputStream i : userStreams) {
if (i.getMediaType() == RCRTCMediaType.VIDEO) {
inputStreams.add((RCRTCVideoInputStream) i);
}
}
}
for (RCRTCOutputStream o : mRtcRoom.getLocalUser().getStreams()) {
if (o.getMediaType() == RCRTCMediaType.VIDEO) {
outputStreams.add((RCRTCVideoOutputStream) o);
}
}
} -
创建用于显示视频的 RCRTCVideoView,调用 RCRTCVideoOutputStream 下的 setVideoView 方法设置本地流的显示 view。
/**
* 当远端或本端视频流发生变化时全量更新ui
*/
void updateVideoView(List<RCRTCVideoOutputStream> outputStreams, List<RCRTCVideoInputStream> inputStreams) {
ArrayList<RCRTCVideoView> list = new ArrayList<>();
if (null != outputStreams) {
for (RCRTCVideoOutputStream o : outputStreams) {
RCRTCVideoView rongRTCVideoView = new RCRTCVideoView(LiveActivity.this);
o.setVideoView(rongRTCVideoView);
list.add(rongRTCVideoView);
}
}
if (null != inputStreams) {
for (RCRTCVideoInputStream i : inputStreams) {
RCRTCVideoView rongRTCVideoView = new RCRTCVideoView(LiveActivity.this);
i.setVideoView(rongRTCVideoView);
list.add(rongRTCVideoView);
}
}
videoViewManager.update(list);
}