TUILiveRoom 是一个开源的视频直播 UI 组件,通过在项目中集成 TUILiveRoom 组件,您只需要编写几行代码就可以为您的 App 添加“视频互动直播”场景。TUILiveRoom 包含 Android、iOS、小程序等平台的源代码,基本功能如下图所示:
说明:TUIKit 系列组件同时使用了腾讯云 实时音视频 TRTC 和 即时通信 IM 两个基础 PaaS 服务,开通实时音视频后会同步开通即时通信IM服务。即时通信 IM 服务详细计费规则请参见 即时通信 - 价格说明,TRTC 开通会默认关联开通 IM SDK 的体验版,仅支持100个 DAU。
![]() |
单击进入 Github ,选择克隆/下载代码,然后拷贝 Android/debug
,Android/tuiaudioeffect
, Android/tuibarrage
, Android/tuibeauty
, Android/tuigift
和 Android/tuiliveroom
目录到您的工程中,并完成如下导入动作:
在 setting.gradle
中完成导入,参考如下:
include ':debug'
include ':tuibeauty'
include ':tuibarrage'
include ':tuiaudioeffect'
include ':tuigift'
include ':tuiliveroom'
在 app
的 build.gradle
文件中添加对 tuiliveroom
的依赖:
api project(":tuiliveroom")
在根目录的 build.gradle
文件中添加 TRTC SDK
和 IM SDK
的依赖:
ext {
liteavSdk = "com.tencent.liteav:LiteAVSDK_TRTC:latest.release"
imSdk = "com.tencent.imsdk:imsdk-plus:latest.release"
}
在 AndroidManifest.xml 中配置 App 的权限,SDK 需要以下权限(6.0以上的 Android 系统需要动态申请相机、读取存储权限):
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-feature android:name="android.hardware.camera"/>
<uses-feature android:name="android.hardware.camera.autofocus" />
在 proguard-rules.pro 文件,将 SDK 相关类加入不混淆名单:
-keep class com.tencent.** { *; }
// 1.添加事件监听及登录
TUILogin.addLoginListener(new TUILoginListener() {
@Override
public void onConnecting() { // 正在连接中
super.onConnecting();
}
@Override
public void onConnectSuccess() { // 连接成功通知
super.onConnectSuccess();
}
@Override
public void onConnectFailed(int errorCode, String errorMsg) { // 连接失败通知
super.onConnectFailed(errorCode, errorMsg);
}
@Override
public void onKickedOffline() { // 登录被踢下线通知(示例:账号在其他设备登录)
super.onKickedOffline();
}
@Override
public void onUserSigExpired() { // userSig过期通知
super.onUserSigExpired();
}
});
TUILogin.login(mContext, "Your SDKAppID", "Your userId", "Your userSig", new TUICallback() {
@Override
public void onSuccess() {
}
@Override
public void onError(int errorCode, String errorMsg) {
Log.d(TAG, "errorCode: " + errorCode + " errorMsg:" + errorMsg);
}
});
// 2.初始化TUILiveRoom组件
TUILiveRoom mLiveRoom = TUILiveRoom.sharedInstance(mContext);
参数说明:
主播端开播
mLiveRoom.createRoom(int roomId, String roomName, String coverUrl);
观众端观看
mLiveRoom.enterRoom(roomId);
观众与主播连麦 TRTCLiveRoom#requestJoinAnchor
// 1.观众端发起连麦请求
// LINK_MIC_TIMEOUT为超时时间
TRTCLiveRoom mTRTCLiveRoom=TRTCLiveRoom.sharedInstance(mContext);
mTRTCLiveRoom.requestJoinAnchor(mSelfUserId + "请求和您连麦", LINK_MIC_TIMEOUT
new TRTCLiveRoomCallback.ActionCallback() {
@Override
public void onCallback(int code, String msg) {
if (code == 0) {
// 主播接受了观众的请求
TXCloudVideoView view = new TXCloudVideoView(context);
parentView.add(view);
// 观众启动预览,开启推流
mTRTCLiveRoom.startCameraPreview(true, view, null);
mTRTCLiveRoom.startPublish(mSelfUserId + "_stream", null);
}
}
});
// 2.主播端收到连麦请求
mTRTCLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
@Override
public void onRequestJoinAnchor(final TRTCLiveRoomDef.TRTCLiveUserInfo userInfo,
String reason, final int timeout) {
// 同意对方的连麦请求
mTRTCLiveRoom.responseJoinAnchor(userInfo.userId, true, "同意连麦");
}
@Override
public void onAnchorEnter(final String userId) {
// 主播收到连麦观众的上麦通知
TXCloudVideoView view = new TXCloudVideoView(context);
parentView.add(view);
// 主播播放观众画面
mTRTCLiveRoom.startPlay(userId, view, null);
}
});
主播与主播 PK TRTCLiveRoom#requestRoomPK
// 主播 A 创建12345的房间
mLiveRoom.createRoom(12345, "roomA", "Your coverUrl");
// 主播 B 创建54321的房间
mLiveRoom.createRoom(54321, "roomB", "Your coverUrl");
// 主播 A:
TRTCLiveRoom mTRTCLiveRoom=TRTCLiveRoom.sharedInstance(mContext);
// 1.主播 A 向主播 B 发起 PK 请求
mTRTCLiveRoom.requestRoomPK(54321, "B",
new TRTCLiveRoomCallback.ActionCallback() {
@Override
public void onCallback(int code, String msg) {
// 5.收到是否同意的回调
if (code == 0) {
// 用户接受
} else {
// 用户拒绝
}
}
});
mTRTCLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
@Override
public void onAnchorEnter(final String userId) {
// 6.收到 B 进房的通知
mTRTCLiveRoom.startPlay(userId, mTXCloudVideoView, null);
}
});
// 主播 B:
// 2.主播 B 收到主播 A 的消息
mTRTCLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
@Override
public void onRequestRoomPK(
final TRTCLiveRoomDef.TRTCLiveUserInfo userInfo, final int timeout) {
// 3.主播 B 回复主播 A 接受请求
mTRTCLiveRoom.responseRoomPK(userInfo.userId, true, "");
}
@Override
public void onAnchorEnter(final String userId) {
// 4.主播 B 收到主播 A 进房的通知,播放主播 A 的画面
mTRTCLiveRoom.startPlay(userId, mTXCloudVideoView, null);
}
});
如果有任何需要或者反馈,您可以联系:colleenyu@tencent.com。
本页内容是否解决了您的问题?