tencent cloud

组件介绍

TUILiveRoom 是一个开源的视频直播 UI 组件，通过在项目中集成 TUILiveRoom 组件，您只需要编写几行代码就可以为您的 App 添加“视频互动直播”场景。TUILiveRoom包含 Android、iOS等平台的源代码，基本功能如下图所示：

组件集成

步骤一：下载并导入 TUILiveRoom 组件

单击进入 Github ，选择克隆/下载代码，然后拷贝 Android/Beauty ，Android/Debug 和 Android/Source 目录到您的工程中，并完成如下导入动作：

• 在 setting.gradle 中完成导入，参考如下：

  include ':Beauty'
  include ':Source'
  include ':Debug'
  

• 在 app 的 build.gradle 文件中添加对 Source 的依赖：

  api project(":Source")
  

• 在根目录的 build.gradle 文件中添加 TRTC SDK 和 IM SDK 的依赖：

  ext {
   liteavSdk = "com.tencent.liteav:LiteAVSDK_TRTC:latest.release"
   imSdk = "com.tencent.imsdk:imsdk-plus:latest.release"
  }
  

步骤二：配置权限及混淆规则

1. 在 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">

2. 在 proguard-rules.pro 文件，将 SDK 相关类加入不混淆名单：
   -keep class com.tencent.** { *; }

步骤三：初始化并登录组件

TRTCLiveRoom mLiveRoom = TRTCLiveRoom.sharedInstance(this);
//useCDNFirst：true 表示普通观众通过 CDN 观看，false 表示普通观众通过低延时观看
//yourCDNPlayDomain：表示 CDN 观看时配置的播放域名
TRTCLiveRoomDef.TRTCLiveRoomConfig config = 
    new TRTCLiveRoomDef.TRTCLiveRoomConfig(useCDNFirst, CDNPlayDomain);
mLiveRoom.login(SDKAPPID, userId, userSig, config, 
    new TRTCLiveRoomCallback.ActionCallback() {
            @Override
            public void onCallback(int code, String msg) {
                if (code == 0) {
                    //登录成功
                }
            }
});

参数说明：

• SDKAppID：TRTC 应用 ID，如果您未开通腾讯云 TRTC 服务，可进入 腾讯云实时音视频控制台，创建一个新的 TRTC 应用后，单击应用信息，SDKAppID 信息如下图所示：
  
• Secretkey：TRTC 应用密钥和 SDKAppId 对应，进入 TRTC 应用管理 后，SecretKey 信息如上图所示。
• userId：当前用户的 ID，字符串类型，只允许包含英文字母（a-z 和 A-Z）、数字（0-9）、连词符（-）和下划线（_）。建议结合业务实际账号体系自行设置。
• userSig：根据 SDKAppId、userId，Secretkey等信息计算得到的安全保护签名，您可以单击 这里 直接在线生成一个调试的userSig，也可以参照我们的 示例工程 自行计算，更多信息见 如何计算及使用 UserSig。
• config：全局配置信息，请在登录时初始化，登录之后不可变更。
• useCDNFirst ：用于设置观众观看方式。true 表示普通观众通过 CDN 观看，计费便宜但延时较高。false 表示普通观众通过低延时观看，计费价格介于 CDN 和连麦之间，但延迟可控制在1s以内。
• CDNPlayDomain：在 useCDNFirst 设置为 true 时才会生效，用于指定 CDN 观看的播放域名，您可以登录直播控制台 > 域名管理 页面中进行设置。
• callback：登录回调，成功时 code 为0。

步骤四：实现视频互动直播间

1. 主播端开播 TRTCLiveRoom#createRoom
   // 1.主播设置昵称和头像
   mLiveRoom.setSelfProfile("A", "your_face_url", null);
   
   // 2.主播开播前预览并设置美颜参数
   TXCloudVideoView view = new TXCloudVideoView(context);
   parentView.add(view);
   mLiveRoom.startCameraPreview(true, view, null);
   mLiveRoom.getBeautyManager().setBeautyStyle(1);
   mLiveRoom.getBeautyManager().setBeautyLevel(6);
   
   // 3.主播创建房间
   TRTCLiveRoomDef.TRTCCreateRoomParam param = new TRTCLiveRoomDef.TRTCCreateRoomParam();
   param.roomName = "测试房间";
   mLiveRoom.createRoom(123456789, param, new TRTCLiveRoomCallback.ActionCallback() {
       @Override
       public void onCallback(int code, String msg) {
           if (code == 0) {
               // 4.主播开启推流并将流发布到 CDN
               mLiveRoom.startPublish(mSelfUserId + "_stream", null);
           }
       }
   });

2. 观众端观看 TRTCLiveRoom#enterRoom

   // 1.假定您从业务后台获取房间列表为 roomList
   List<Integer> roomList = GetRoomList();
   // 2.通过调用 getRoomInfos 获取房间的详细信息
   mLiveRoom.getRoomInfos(roomList, new TRTCLiveRoomCallback.RoomInfoCallback() {
   @Override
   public void onCallback(int code, String msg, List<TRTCLiveRoomDef.TRTCLiveRoomInfo> list) {
       if (code == 0) {
           // 获取到房间详细信息后，您可以在主播列表页面展示主播昵称、头像等相关信息
       }
   }
   })
   // 3.选择房间 roomid 进入
   mLiveRoom.enterRoom(roomid, null);
   // 4.观众收到主播进房通知，开始播放
   mLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
   @Override
   public void onAnchorEnter(final String userId) {  
       // 5.观众播放主播画面
            //mTXCloudVideoView为观众端播放的view
       mLiveRoom.startPlay(userId, mTXCloudVideoView, null);
   }
   });
   

3. 观众与主播连麦 TRTCLiveRoom#requestJoinAnchor
   // 1.观众端发起连麦请求
   // LINK_MIC_TIMEOUT为超时时间
   mLiveRoom.requestJoinAnchor(mSelfUserId + "请求和您连麦", LINK_MIC_TIMEOUT
       new TRTCLiveRoomCallback.ActionCallback() {
       @Override
       public void onCallback(int code, String msg) {
           if (code == 0) {
               // 4.主播接受了观众的请求
               TXCloudVideoView view = new TXCloudVideoView(context);
               parentView.add(view);
               // 5.观众启动预览，开启推流
               mLiveRoom.startCameraPreview(true, view, null);
               mLiveRoom.startPublish(mSelfUserId + "_stream", null);
           }
       }
   });
   
   // 2.主播端收到连麦请求
   mLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
       @Override
       public void onRequestJoinAnchor(final TRTCLiveRoomDef.TRTCLiveUserInfo userInfo, 
           String reason, final int timeout) {
           // 3.同意对方的连麦请求
           mLiveRoom.responseJoinAnchor(userInfo.userId, true, "同意连麦");
       }
   
       @Override
       public void onAnchorEnter(final String userId) {
           // 6.主播收到连麦观众的上麦通知
           TXCloudVideoView view = new TXCloudVideoView(context);
           parentView.add(view);
           // 7.主播播放观众画面
           mLiveRoom.startPlay(userId, view, null);
       }
   });

4. 主播与主播 PK TRTCLiveRoom#requestRoomPK
   // 主播 A:
   // 主播 A 创建12345的房间
   mLiveRoom.createRoom(12345, param, null);
   
   mLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
       @Override
       public void onAnchorEnter(final String userId) {
           // 6.收到 B 进房的通知
           mLiveRoom.startPlay(userId, mTXCloudVideoView, null);
       }
   });
   
   // 1.主播 A 向主播 B 发起 PK 请求
   mLiveRoom.requestRoomPK(54321, "B", 
       new TRTCLiveRoomCallback.ActionCallback() {
       @Override
       public void onCallback(int code, String msg) {  
           // 5.收到是否同意的回调
           if (code == 0) {
               // 用户接受
           } else {
               // 用户拒绝
           }
       }
   });
   
   // 主播 B：
   // 主播 B 创建54321的房间
   mLiveRoom.createRoom(54321, param, null);
   
   // 2.主播 B 收到主播 A 的消息
   mLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
       @Override
       public void onRequestRoomPK(
          final TRTCLiveRoomDef.TRTCLiveUserInfo userInfo, final int timeout) {
           // 3.主播 B 回复主播 A 接受请求
           mLiveRoom.responseRoomPK(userInfo.userId, true, "");
       }
       @Override
       public void onAnchorEnter(final String userId) {
           // 4.主播 B 收到主播 A 进房的通知，播放主播 A 的画面
           mLiveRoom.startPlay(userId, mTXCloudVideoView, null);
       }
   });

5. 实现文字聊天 TRTCLiveRoom#sendRoomTextMsg
   // 发送端：发送文本消息
   mLiveRoom.sendRoomTextMsg("Hello Word!", null);
   // 接收端：监听文本消息
   mLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
       @Override
       public void onRecvRoomTextMsg(String roomId, 
               String message, TRTCLiveRoomDef.TRTCLiveUserInfo userInfo) {
               Log.d(TAG, "收到来自" + userInfo.userName + "的消息:" + message);
       }
   });

6. 实现弹幕消息 TRTCLiveRoom#sendRoomCustomMsg
   // 发送端：您可以通过自定义 Cmd 来区分弹幕和点赞消息
   // eg:"CMD_DANMU"表示弹幕消息，"CMD_LIKE"表示点赞消息
   mLiveRoom.sendRoomCustomMsg("CMD_DANMU", "Hello world", null);
   mLiveRoom.sendRoomCustomMsg("CMD_LIKE", "", null);
   // 接收端：监听自定义消息
   mLiveRoom.setDelegate(new TRTCLiveRoomDelegate() {
       @Override
       public void onRecvRoomCustomMsg(String roomId, String cmd, 
           String message, TRTCLiveRoomDef.TRTCLiveUserInfo userInfo) {
           if ("CMD_DANMU".equals(cmd)) {
               // 收到弹幕消息
               Log.d(TAG, "收到来自" + userInfo.userName + "的弹幕消息:" + message);
           } else if ("CMD_LIKE".equals(cmd)) {
               // 收到点赞消息
               Log.d(TAG, userInfo.userName + "给您点了个赞！");
           }
       }
   });

常见问题

如果有任何需要或者反馈，您可以联系：colleenyu@tencent.com。