效果展示

您可以 下载 安装我们的 Demo 体验语音聊天室的能力，包括麦位管理、低延时语音互动、文字聊天等 TRTC 在语音聊天场景下的相关能力。

房主麦位操作	听众麦位操作

如需快速接入语音聊天室功能，您可以直接基于我们提供的 Demo 进行修改适配，也可以使用我们提供的 TRTCVoiceRoom 组件并实现自定义 UI 界面。

复用 Demo 的 UI 界面

步骤1：创建新的应用

1. 登录实时音视频控制台，选择【开发辅助】>【快速跑通Demo】。
2. 输入应用名称，例如 TestVoiceRoom ，单击【创建】。

注意：

本功能同时使用了腾讯云 实时音视频 TRTC 和 即时通信 IM 两个基础 PaaS 服务，开通实时音视频后会同步开通即时通信 IM 服务。 即时通信 IM 属于增值服务，详细计费规则请参见 即时通信 IM 价格说明。

步骤2：下载 SDK 和 Demo 源码

1. 根据实际业务需求下载 SDK 及配套的 Demo 源码。
2. 下载完成后，单击【已下载，下一步】。
   

步骤3：配置 Demo 工程文件

1. 进入修改配置页，根据您下载的源码包，选择相应的开发环境。
2. 找到并打开 Android/TRTCScenesDemo/debug/src/main/java/com/tencent/liteav/debug/GenerateTestUserSig.java 文件。
3. 设置 GenerateTestUserSig.java 文件中的相关参数：
   • SDKAPPID：默认为 PLACEHOLDER ，请设置为实际的 SDKAppID。
   • SECRETKEY：默认为 PLACEHOLDER ，请设置为实际的密钥信息。
   
4. 粘贴完成后，单击【已复制粘贴，下一步】即创建成功。
5. 编译完成后，单击【回到控制台概览】即可。

注意：

• 本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。
• 正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。

步骤4：运行 Demo

使用 Android Studio（3.5以上的版本）打开源码工程TRTCScenesDemo，单击【运行】即可开始调试本 Demo。

步骤5：修改 Demo 源代码

源码中的 trtcvoiceroomdemo 文件夹包含两个子文件夹 ui 和 model，ui 文件夹中均为界面代码，如下表格列出了各个文件或文件夹及其所对应的 UI 界面，以便于您进行二次调整：

实现自定义 UI 界面

源码 中的 trtcvoiceroomdemo 文件夹包含两个子文件夹 ui 和 model，model 文件夹中包含可重用的开源组件 TRTCVoiceRoom，您可以在TRTCVoiceRoom.java文件中看到该组件提供的接口函数，并使用对应接口实现自定义 UI 界面。

步骤1：集成 SDK

语音聊天组件 TRTCVoiceRoom 依赖 TRTC SDK 和 IM SDK，您可以按照如下步骤将两个 SDK 集成到项目中。

方法一：通过 Maven 仓库依赖

1. 在 dependencies 中添加 TRTCSDK 和 IMSDK 的依赖。

   dependencies {
      complie "com.tencent.liteav:LiteAVSDK_TRTC:latest.release"
      complie 'com.tencent.imsdk:imsdk:latest.release'
      compile 'com.google.code.gson:gson:2.3.1'
   }

   说明：

   两个 SDK 的最新版本号，可以在 TRTC 和 IM 的 GitHub 首页获取。

2. 在 defaultConfig 中，指定 App 使用的 CPU 架构。

   defaultConfig {
     ndk {
         abiFilters "armeabi-v7a"
     }
   }

3. 单击【Sync Now】，自动下载 SDK 并集成到工程里。

方法二：通过本地 AAR 依赖
若您的开发环境访问 Maven 仓库较慢，您可以直接下载 ZIP 包，并按照集成文档手动集成到您的工程中。

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

在 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.READ_PHONE_STATE" />

在 proguard-rules.pro 文件，将 SDK 相关类加入不混淆名单：

-keep class com.tencent.** { *; }

步骤3：导入 TRTCVoiceRoom 组件

拷贝以下目录中的所有文件到您的项目中：

trtcvoiceroomdemo/src/main/java/com/tencent/liteav/trtcvoiceroom/model

步骤4：创建并登录组件

1. 调用sharedInstance接口可以创建一个 TRTCVoiceRoom 组件的实例对象。
2. 调用setDelegate函数注册组件的事件通知。
3. 调用login函数完成组件的登录，请参考下表填写关键参数：

   参数名	作用
   sdkAppId	您可以在 实时音视频控制台 中查看 SDKAppID。
   userId	当前用户的 ID，字符串类型，只允许包含英文字母（a-z、A-Z）、数字（0-9）、连词符（-）和下划线（_）。
   userSig	腾讯云设计的一种安全保护签名，获取方式请参考 如何计算 UserSig。
   callback	登录回调，成功时 code 为0。

   TRTCVoiceRoom mTRTCVoiceRoom = TRTCVoiceRoom.sharedInstance(this);
   mTRTCVoiceRoom.setDelegate(this);
   mTRTCVoiceRoom.login(SDKAPPID, userId, userSig, new TRTCVoiceRoomCallback.ActionCallback() {
       @Override
       public void onCallback(int code, String msg) {
           if (code == 0) {![](https://main.qcloudimg.com/raw/be8ee8461f8e06295d5ae1ad1502d745.png)
               //登录成功
           }
       }
   });

步骤5：房主端开播

1. 房主执行 步骤4 登录后，可以调用setSelfProfile设置自己的昵称和头像。
2. 房主调用createRoom创建新的语音聊天室，此时传入房间 ID、上麦是否需要房主确认、麦位数等房间属性信息。
3. 房主创建房间成功后，调用enterSeat进入座位。
4. 房主收到组件的onSeatListChange麦位表变化事件通知，此时可以将麦位表变化刷新到 UI 界面上。
5. 房主还会收到麦位表有成员进入的onAnchorEnterSeat的事件通知，此时会自动打开麦克风采集。

// 1.房主设置昵称和头像
mTRTCVoiceRoom.setSelfProfile("my_name", "my_face_url", null);

// 2.房主调用 createRoom 创建房间
final TRTCVoiceRoomDef.RoomParam roomParam = new TRTCVoiceRoomDef.RoomParam();
roomParam.roomName = "房间名称";
roomParam.needRequest = false; // 上麦是否需要房主确认
roomParam.seatCount = 7; // 房间座位数，这里一共7个座位，房主占了一个后听众剩下6个座位
roomParam.coverUrl = "房间封面图的 URL 地址";
mTRTCVoiceRoom.createRoom(mRoomId, roomParam, new TRTCVoiceRoomCallback.ActionCallback() {
    @Override
    public void onCallback(int code, String msg) {
        if (code == 0) {
            //3. 占0号座位
            mTRTCVoiceRoom.enterSeat(0, new TRTCVoiceRoomCallback.ActionCallback() {
                @Override
                public void onCallback(int code, String msg) {
                    if (code == 0) {
                    }
                }
            });
        }
    }
});

// 4.占座成功后，收到 onSeatListChange 事件通知
@Override
public void onSeatListChange(final List<trtcvoiceroomdef.seatinfo> seatInfoList) {
    // 展示您的麦位列表
}

// 5. 收到 onAnchorEnterSeat 事件通知
@Override
public void onAnchorEnterSeat(TRTCVoiceRoomDef.UserInfo userInfo) {
}

步骤6：听众端观看

1. 听众端执行 步骤4 登录后，可以调用setSelfProfile设置自己的昵称和头像。
2. 听众端向业务后台获取最新的语音聊天室房间列表。

   说明：

   Demo 中的语音聊天室列表仅做演示使用，语音聊天室列表的业务逻辑千差万别，腾讯云暂不提供语音聊天室列表的管理服务，请自行管理您的语音聊天室列表。

3. 听众端调用getRoomInfoList获取房间的详细信息，该信息是在房主端调用createRoom创建语音聊天室时设置的简单描述信息。

   注意：

   如果您的语音聊天室列表包含了足够全面的信息，可跳过调用getRoomInfoList相关步骤。

4. 听众选择一个语音聊天室，调用enterRoom并传入房间号即可进入该房间。
5. 进房后会收到组件的onRoomInfoChange房间属性变化事件通知，此时可以记录房间属性并做相应改变，例如 UI 展示房间名、记录上麦是否需要请求房主同意等。
6. 进房后会收到组件的onSeatListChange麦位表变化事件通知，此时可以将麦位表变化刷新到 UI 界面上。
7. 进房后还会收到麦位表有主播进入的onAnchorEnterSeat的事件通知。

// 1.听众设置昵称和头像
mTRTCVoiceRoom.setSelfProfile("my_name", "my_face_url", null);

// 2.假定您从业务后台获取房间列表为 roomList
List<integer> roomList = GetRoomList();

// 3.通过调用 getRoomInfoList 获取房间的详细信息
mTRTCVoiceRoom.getRoomInfoList(roomList, new TRTCVoiceRoomCallback.RoomInfoCallback() {
    @Override
    public void onCallback(int code, String msg, List<trtcvoiceroomdef.roominfo> list) {
        if (code == 0) {
            // 此时可以刷新您自己的 UI 房间列表
        }
    }
});

// 4.选择语音聊天室后，传入 roomId 进入房间
mTRTCVoiceRoom.enterRoom(roomId, new TRTCVoiceRoomCallback.ActionCallback() {
        @Override
        public void onCallback(int code, String msg) {
            if (code == 0) {
                //进房成功
            }
        }
});

// 5.进房成功后，收到 onRoomInfoChange 事件通知
@Override
public void onRoomInfoChange(TRTCVoiceRoomDef.RoomInfo roomInfo) {
    mNeedRequest = roomInfo.needRequest;
    mRoomName = roomInfo.roomName;
    // UI 可以展示标题等
}

// 6.进房成功后，收到 onSeatListChange 事件通知
@Override
public void onSeatListChange(final List<trtcvoiceroomdef.seatinfo> seatInfoList) {
    // 展示您的麦位列表
}

// 7. 收到 onAnchorEnterSeat 事件通知
@Override
public void onAnchorEnterSeat(TRTCVoiceRoomDef.UserInfo userInfo) {
}

步骤7：麦位管理

// 1: 房主抱人上1号麦位
mTRTCVoiceRoom.pickSeat(1, "123", new TRTCVoiceRoomCallback.ActionCallback() {
    @Override
    public void onCallback(int code, String msg) {
        // 2.收到 callback 回调
        if (code == 0) {
        }
    }
});

// 3.收到 onSeatListChange 回调，刷新您的麦位列表
@Override
public void onSeatListChange(final List seatInfoList) {
}

// 4.单个麦位变化的通知，可以在这里判断听众是不是真的上麦成功
public void onAnchorEnterSeat(int index, TRTCVoiceRoomDef.UserInfo user) {
}

// 1: 听众主动上2号麦位
mTRTCVoiceRoom.enterSeat(2, new TRTCVoiceRoomCallback.ActionCallback() {
    @Override
    public void onCallback(int code, String msg) {
        // 2.收到 callback 回调
        if (code == 0) {
        }
    }
});

// 3.收到 onSeatListChange 回调，刷新您的麦位列表
@Override
public void onSeatListChange(final List seatInfoList) {
}

// 4.单个麦位变化的通知，可以在这里判断是不是自己并进行相应处理
public void onAnchorEnterSeat(int index, TRTCVoiceRoomDef.UserInfo user) {
}

步骤8：邀请信令的使用

在 麦位管理 中，听众上下麦、房主抱人上麦都不需要经过对方的同意就可以直接操作。
如果您的 App 需要对方同意才能进行下一步操作的业务流程，那么邀请信令可以提供相应支持。

// 听众端视角
// 1.调用 sendInvitation，请求上1号麦位
String inviteId = mTRTCVoiceRoom.sendInvitation("ENTER_SEAT", ownerUserId, "1", null);

// 2.收到邀请的同意请求, 正式上麦
@Override
public void onInviteeAccepted(String id, String invitee) {
    if(id.equals(inviteId)) {
        mTRTCVoiceRoom.enterSeat(1, null);
    }
}

// 房主端视角
// 1.房主收到请求
 @Override
public void onReceiveNewInvitation(final String id, String inviter, String cmd, final String content) {
    if (cmd.equals("ENTER_SEAT")) {
        // 2.房主同意听众请求
         mTRTCVoiceRoom.acceptInvitation(id, null);
    }
}

// 房主端视角
// 1.房主调用 sendInvitation，请求抱听众“123”上2号麦
String inviteId = mTRTCVoiceRoom.sendInvitation("PICK_SEAT", "123", "2", null);

// 2.收到邀请的同意请求, 正式上麦
@Override
public void onInviteeAccepted(String id, String invitee) {
    if(id.equals(inviteId)) {
        mTRTCVoiceRoom.pickSeat(2, null);
    }
}

// 听众端视角
// 1.听众收到请求
 @Override
public void onReceiveNewInvitation(final String id, String inviter, String cmd, final String content) {
    if (cmd.equals("PICK_SEAT")) {
        // 2.听众同意房主请求
         mTRTCVoiceRoom.acceptInvitation(id, null);
    }
}

步骤9：实现文字聊天和弹幕消息

• 通过sendRoomTextMsg可以发送普通的文本消息，所有在该房间内的主播和听众均可以收到onRecvRoomTextMsg回调。
  即时通信 IM 后台有默认的敏感词过滤规则，被判定为敏感词的文本消息不会被云端转发。
  // 发送端：发送文本消息
  mTRTCVoiceRoom.sendRoomTextMsg("Hello Word!", null);
  // 接收端：监听文本消息
  mTRTCVoiceRoom.setDelegate(new TRTCVoiceRoomDelegate() {
     @Override
     public void onRecvRoomTextMsg(String message, TRTCVoiceRoomDef.UserInfo userInfo) {
         Log.d(TAG, "收到来自" + userInfo.userName + "的消息:" + message);
     }
  });

• 通过sendRoomCustomMsg可以发送自定义（信令）的消息，所有在该房间内的主播和听众均可以收到onRecvRoomCustomMsg回调。
  自定义消息常用于传输自定义信令，例如用于点赞消息的发送和广播。
  // 发送端：您可以通过自定义 Cmd 来区分弹幕和点赞消息
  // eg:"CMD_DANMU"表示弹幕消息，"CMD_LIKE"表示点赞消息
  mTRTCVoiceRoom.sendRoomCustomMsg("CMD_DANMU", "Hello world", null);
  mTRTCVoiceRoom.sendRoomCustomMsg("CMD_LIKE", "", null);
  // 接收端：监听自定义消息
  mTRTCVoiceRoom.setDelegate(new TRTCVoiceRoomDelegate() {
      @Override
      public void onRecvRoomCustomMsg(String cmd, String message, TRTCVoiceRoomDef.UserInfo userInfo) {
          if ("CMD_DANMU".equals(cmd)) {
              // 收到弹幕消息
              Log.d(TAG, "收到来自" + userInfo.userName + "的弹幕消息:" + message);
          } else if ("CMD_LIKE".equals(cmd)) {
              // 收到点赞消息
              Log.d(TAG, userInfo.userName + "给您点了个赞！");
          }
      }
  });