服务端集成

前提条件

• 您已经注册阿里云账号，并完成实名认证。具体操作，请参见阿里云账号注册流程。
• 您已经开通音视频通信服务。具体操作，请参见音视频通信服务开通。
• 环境中已安装Java JDK 8的版本。具体操作，请参见安装JDK。
  说明 如果服务端为Linux环境，推荐安装Oracle JDK，不推荐使用Open JDK进行服务端集成。

操作步骤

1. 获取AppID和AppKey。此处建议记录一下AppID和AppKey，方便后续操作中使用。
   1. 登录RTC控制台。
   2. 在左侧导航栏单击应用管理，进入应用管理页面。
   3. 在AppID/名称列获取AppID。
   4. 单击操作列的查询AppKey，获取AppKey。
   说明 如果应用列表中没有您需要的应用，可以单击创建应用，创建新的应用。具体操作，请参见创建应用。
2. 获取AccessKey。
   说明 由于主账号AccessKey泄露会威胁您所有资源的安全，因此出于安全考虑，需要创建一个子账号（RAM用户）并获取子账号的AccessKey，用于访问您的云资源。
   1. 登录RAM控制台。
   2. 在左侧导航栏选择人员管理 > 用户，进入用户页面。
   3. 单击创建用户，填写用户账号信息，选中编程访问创建用户。
      
   4. 单击确定。
   5. 重新返回用户页面。在用户登录名称/显示名称列下，单击目标RAM子账户，进入管理页面。
      
   6. 单击权限管理，再单击添加权限。
      
   7. 选择AliyunRTCFullAccess（管理音视频通信的权限，可输入RTC进行搜索）。单击确定。
      
   8. 单击认证管理，在用户AccessKey区域单击创建AccessKey。
      

      说明

      • 首次创建时需填写手机验证码。
      • 如果AccessKey泄露或丢失，则需要创建新的AccessKey，最多可以创建2个AccessKey。
   9. 获取AccessKey ID和AccessKey Secret。
      创建AccessKey完成后，会弹出创建AccessKey对话框，包含AccessKey ID和AccessKey Secret信息。此处建议记录一下AccessKey ID和AccessKey Secret，方便后续操作中使用。
3. 下载并解压Demo，更多信息，请参见Demo源码下载。
   说明

   • 源码压缩文件内分为Server端、Android端、iOS端三个文件。
   • 如果GitHub代码库下载缓慢，可安装加速插件等方式加速下载。
4. 配置Demo工程。
   1. 将server/dist/rtc-api.zip文件解压到dist文件夹下。

      解压成功之后如下图所示：

      

      说明 解压成功后，可以看到BOOT-INF、META-INF及org文件夹，这三个文件夹需要和restart.sh保持在同一个目录下。
   2. 修改配置文件。
      打开BOOT-INF/classes/application.properties文件，修改配置。

      说明 使用文本编辑器打开即可，若找不到打开方式，推荐安装VSCode等轻量级代码编辑器打开。

      

      • 设置RTC应用AppId和AppKey，请参见步骤1获取。

        rtc.1v1audio.appId = *

        rtc.1v1audio.appKey = *

      • 设置AK，需要添加AliyunRTCFullAccess权限，请参见步骤2获取。

        accessKeyID=*

        accessKeySecret=*

5. 运行服务，执行restart.sh文件。如果编译过程中出现问题，请参见服务端运行常见问题。
   • Mac或Linux环境下请将终端定位至dist目录下，执行如下命令：

     sh restart.sh

     后台执行可以使用如下命令以确保退出终端时程序能够继续运行。

     nohup sh restart.sh >./run_log.log 2>&1 &

   • Windows环境需要打开CMD终端定位到server/dist文件夹下，执行如下命令：

     java org.springframework.boot.loader.JarLauncher

     若提示8080端口被占用，请尝试使用netstat命令查看占用8080端口的进程pid号，并使用taskkill关闭相关进程。

     netstat -ano | findstr 8080

     taskkill /pid 占用端口的进程pid号 /f

     

     终端成功运行后可以看到服务端启动成功的日志信息。

     
6. 检查服务端是否已经启动。

   在浏览器中访问http://127.0.0.1:8080/1v1-audio/index.html，如果显示如下图所示，表示服务端已经启动。

   

主要功能说明

• 生成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通过调用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));