集成服务端_1对1语音聊天_解决方案_音视频通信

您可以阅读本文，了解1对1语音聊天服务端的集成操作。

前提条件

您已经完成注册阿里云账号，并完成实名认证，具体操作请参见阿里云账号注册流程。
您已经开通音视频通信服务，具体操作请参见开通服务。1对1语音聊天无需购买套餐也可正常搭建。
首次开通RTC服务后，系统会自动帮您创建一个应用项目，可以直接使用自动创建好的应用项目进行使用。如果没有应用项目，需要您在阿里云音视频通信RTC控制台创建应用。
服务端环境需要Java JDK 8的版本，具体操作，请参见安装JDK。

说明 Linux环境推荐安装Oracle JDK，不推荐使用Open JDK进行服务端集成。

操作步骤

说明您在集成服务端时，如果遇到问题，请参见服务端运行常见问题。

获取应用ID和AppKey。

说明
应用ID和AppKey需要对应，不同的应用ID有不同的AppKey。

在后续开发中会使用应用ID和AppKey，建议记录到本地文档中，妥善保存。
1. 登录RTC控制台。
2. 在左侧导航栏单击应用管理，进入应用管理页面。
3. 获取应用ID和查询AppKey。
  - 应用ID：可在应用ID/名称列表下直接获取。
  - AppKey：单击查询AppKey获取AppKey。
  如果您还未有应用，您可以单击创建应用创建。
获取AccessKey。

警告由于主账号AccessKey泄露会威胁您所有资源的安全，因此出于安全考虑，需要创建一个子账号（RAM用户）并获取子账号的AccessKey，用于1对1语音聊天Demo访问您的云资源。
1. 登录RAM控制台
2. 在左侧导航栏选择人员管理 > 用户，进入用户页面。
3. 请单击创建用户，填写用户账号信息，选择编程访问创建用户。
4. 重新返回用户页面。在用户登录名称/显示名称列表下，单击目标RAM子账户，进入管理页面。
5. 单击权限管理，单击添加权限。
6. 选择AliyunRTCFullAccess（管理音视频通信（RTC）的权限），可输入RTC进行搜索。单击确定。
7. 单击认证管理，在用户AccessKey区域单击创建AccessKey。
  说明
  
  首次创建时需填写手机验证码。
  
  如果AccessKey泄露或丢失，则需要创建新的AccessKey，最多可以创建2个AccessKey。
8. 获取AccessKey ID和AccessKey Secret。
  
  创建AccessKey完成后，会弹出创建AccessKey对话框，可以获取AccessKey ID和AccessKey Secret。
  
  注意 AccessKey和AccessKey Secret，在后续开发中会使用，建议记录到本地文档妥善保存。AccessKey Secret只在创建时显示，不提供查询。
下载Demo源码。
说明
- 源码压缩文件内分为Server端、Android端、iOS端三个源文件。
- 若遇到Github代码库下载缓慢的问题，可通过安装加速插件等方式加速下载。
解压Demo源码压缩包。
解压成功之后如下图所示：
1. 选择server/dist/rtc-api.zip文件，解压到dist文件夹下。
  - Mac环境下请将终端定位至dist目录下，使用unzip命令解压。
```
unzip rtc-api.zip
```
  - Windows环境下请直接双击解压。
  解压成功后如图所示。
  
  说明解压成功后，可以看到BOOT-INF、META-INF及org文件夹，这三个文件夹需要和restart.sh保持在同一个目录下。
2. 修改配置文件。
  打开 BOOT-INF/classes/application.properties文件，修改配置。
  
  说明使用文本编辑器打开即可，若找不到打开方式，推荐安装VSCode等轻量级代码编辑器打开。
  - 设置RTC应用AppId和AppKey，可参见步骤获取AppKey和应用ID。获取。
    rtc.1v1audio.appId = *
    
    rtc.1v1audio.appKey = *
  - 设置AK，需要添加AliyunRTCFullAccess权限，可参见步骤获取AccessKey获取。
    accessKeyID=*
    
    accessKeySecret=*
运行服务，执行restart.sh文件。
- Mac或Linux环境下请将终端定位至dist目录下，执行如下命令：
```
sh restart.sh
```
  后台执行可以使用如下命令以确保退出终端时程序能够继续运行。
```
nohup sh restart.sh >./run_log.log 2>&1 &
```
- Windows环境需要打开CMD终端定位到server/dist文件夹下，使用如下命令执行restart.sh。
```
java org.springframework.boot.loader.JarLauncher
```
  若提示8080端口被占用，请尝试使用netstat命令查看占用8080端口的进程pid号，并使用taskkill关闭相关进程。
```
netstat -ano | findstr 8080
taskkill /pid 占用端口的进程pid号 /f 
```
  终端成功运行后可以看到服务端启动成功的日志信息。
访问指定URL地址。

URL地址：http://127.0.0.1:8080/1v1-audio/index.html。

如果您在浏览器上看到Hello RTC! ，代表服务端已经启动。

主要功能说明

生成joinChannel所需鉴权信息

访问地址：/app/token

客户端调用RTC SDK加入房间的Token信息就是从这个接口获得。具体生成方式，请参见RTC帮助文档生成Token。

        MessageDigest digest = MessageDigest.getInstance("SHA-256");
        digest.update(appId.getBytes());
        digest.update(appKey.getBytes());
        digest.update(channelId.getBytes());
        digest.update(userId.getBytes());
        digest.update(nonce.getBytes());
        digest.update(Long.toString(timestamp).getBytes());
        String token = DatatypeConverter.printHexBinary(digest.digest()).toLowerCase();
        return token;

查询频道实时在线用户列表

访问地址：/app/descChannelUsers

AppServer通过调用rtcOpenApi的DescribeChannelUsers接口查询频道的实时在线人数。

        DefaultAcsClient client = initVodClient();
        DescribeChannelUsersRequest request = new DescribeChannelUsersRequest();
        request.setAppId(appId);
        request.setChannelId(channelId);
        DescribeChannelUsersResponse response = client.getAcsResponse(request);

查询房间开启时间

访问地址：/app/descChannelStartTime

当客户端请求加入房间所需的token时，服务端查询当前房间人数，若房间人数为0，保存当前时刻和房间id。并把当前时刻作为此房间的创建时间。

            DescribeChannelUsersResponse response = RtcOpenAPI.describeChannelUsers(appId, channelId);
            if (CollectionUtils.isEmpty(response.getUserList())) {
                ImmutablePair<String, String> appChannel = new ImmutablePair<>(appId, channelId);
                ScheduledFuture scheduledFuture = TASKS.getOrDefault(appChannel, new JSONObject()).getObject("scheduledFuture", ScheduledFuture.class);

                TASKS.put(appChannel, channelInfo);
            }


                        JSONObject scheduledTask = ScheduledDeleteChannel.TASKS.get(ImmutablePair.of(appId, channelId));