产品百科 ｜零门槛搭建一个 1 对 1 语音聊天 Demo （iOS 版）

1 对 1 语音聊天

1 对 1 语音聊天是一款双人实时通话产品（不具备视频通话功能），拥有实时通话、设置背景音乐等功能。能够为开发者提供高音质、低延迟、便捷接入、多平台互通的服务。可适用于私密聊、语音陪聊等社交场景。

Demo 体验

AliRTC 为 1 对 1 语音聊天提供 Android 和 iOS 的 Demo，通过钉钉扫码下载。

主要功能

	功能描述
实时语音通话	超低延时下，用户之间实现语音通话功能。
背景音乐	可以播放指定背景音乐。
伴奏混音	将本地或在线的音频和用户声音，同时发送并播放给另一名用户。
高音质	支持 48kHz 采样的高音质，支持左右声道。
3A 音频处理	行业领先的音频 3A（AGC、AEC、ANS），支持针对人声、乐器等场景定制化调优。

实现方法

创建房间 API 时序图（Android 端）：

前提条件

• 您已经完成注册阿里云账号，并完成实名认证，详情请参见 阿里云账号注册流程 。
• 您已经开通音视频通信服务，详情请参见 音视频开通服务

源码下载

请单击

Demo 下载

，下载源码。

实现流程

实现流程如下图所示：

集成服务端

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

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

操作步骤

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

服务端运行常见问题

1. 获取应用 ID 和 AppKey。说明应用 ID 和 AppKey 需要对应，不同的应用 ID 有不同的 AppKey。在后续开发中会使用应用 ID 和 AppKey，建议记录到本地文档中，妥善保存。

1. 1. 登录 RTC 控制台
   2. 在左侧导航栏单击应用管理，进入应用管理页面。
   3. 获取应用 ID 和查询 AppKey。

• • • 应用 ID：可在应用 ID / 名称列表下直接获取。
    • AppKey：单击查询 AppKey 获取 AppKey。

1. 1. 如果您还未有应用，您可以单击创建应用创建。

      

1. 获取 AccessKey。警告由于主账号 AccessKey 泄露会威胁您所有资源的安全，因此出于安全考虑，需要创建一个子账号（RAM 用户）并获取子账号的 AccessKey，用于 1 对 1 语音聊天 Demo 访问您的云资源。

1. 1. RAM 控制台
   2. 在左侧导航栏选择人员管理 > 用户，进入用户页面。
   3. 单击创建用户，填写用户账号信息，选中编程访问创建用户。

      

   4. 单击确定。
   5. 重新返回用户页面。在用户登录名称 / 显示名称列表下，单击目标 RAM 子账户，进入管理页面。

      

   6. 单击权限管理，单击添加权限。

      

   7. 选择 AliyunRTCFullAccess（管理音视频通信（RTC）的权限），可输入 RTC 进行搜索。单击确定。

      

   8. 单击认证管理，在用户 AccessKey 区域单击创建 AccessKey。说明

• • • 首次创建时需填写手机验证码。
    • 如果 AccessKey 泄露或丢失，则需要创建新的 AccessKey，最多可以创建 2 个 AccessKey。

      

1. 1. 获取 AccessKey ID 和 AccessKey Secret。创建 AccessKey 完成后，会弹出创建 AccessKey 对话框，可以获取 AccessKey ID 和 AccessKey Secret。

      注意 AccessKey ID 和 AccessKey Secret 在后续开发中会使用，建议记录到本地文档妥善保存。AccessKey Secret 只在创建时显示，不提供查询。

      

1. 下载 Demo 源码。说明

• • 源码压缩文件内分为 Server 端、Android 端、iOS 端三个源文件。
  • 若遇到 Github 代码库下载缓慢的问题，可通过安装加速插件等方式加速下载。

1. 解压 源码压缩包。解压成功之后如下图所示：

   

1. 1. 选择 server/dist/rtc-api.zip 文件，解压到 dist 文件夹下。

• • • Mac 环境下请将终端定位至 dist 目录下，使用 unzip 命令解压。

unzip rtc-api.zip      

• • • Windows 环境下请直接双击解压。

1. 1. 解压成功后如图所示。

      

      说明 解压成功后，可以看到 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=*

1. 运行服务，执行 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

    

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

    

1. 访问指定 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(app      

集成iOS端

开发前的环境要求如下表所示，详情请参见：

使用限制

类别	说明
iPhone 设备	支持 iPhone5 及以上。
系统版本	支持 iOS 8.0 及以上。
CPU 架构	支持真机架构 armv7+arm64，不支持模拟器 i386、x86 架构。
Xcode 版本	支持 Xcode9.0 及以上。下载 Xcode
其他	不支持 Bitcode，不支持屏幕旋转。

您需要先集成服务端，具体操作，请参见

说明 您需要持有 Apple 开发证书或个人账号。

Demo 运行指引

您在集成 iOS 端时，如果遇到问题，或者 Demo 体验过程中出现无法创建房间或通话等问题，请参见

iOS 端运行常见问题

1. 并解压。说明

• • Demo 源码中已经集成 AliRTC SDK（版本：1.17）。SDK 集成方式通过 CocoaPods 集成。
  • 源码压缩文件内分为 Server 端、Android 端、iOS 端三个文件。
  • 若遇到 GitHub 代码库下载缓慢的问题，可通过安装加速插件等方式加速下载。

1. 修改配置文件。

1. 1. 打开解压后的 Demo 文件夹 AliRTC-UserCase-VoiceCallSolution_1To1-master，找到 iOS/demo/⁨AlivcVoiceCallSolo⁩/AlivcVoiceCallSolo⁩/Utils/Http/AliBaseHttpClient.m⁩文件。

      

   2. 修改文件中的

      AppServer

      变量，如：

      http://<服务器IP> :8080/1v1-audio

      ，部署到正式环境上建议绑定域名并使用：

      http://<域名>/1v1-audio

      。示例假设本地 IP 为 192.0.2.1，那么

      BASE_URL="http://192.0.2.1:8080/1v1-audio"

      。本地 IP 查询，请参见 查询 IP 地址 。注意

• • • 不要使用 127.0.0.1 的 IP。
    • 手机和搭建服务器的电脑处在一个局域网中。

1. 1. 使用手机和电脑的浏览器验证。输入正确的 URL（

      AppServer

      变量）地址，即可在浏览器中打开并看到：

      Hello RTC! 

      。电脑端浏览器正确访问说明 IP 和端口号无误，手机端浏览器正确访问说明目前手机可以正常访问到服务器 IP。

      

1. 导入 Demo 源码。打开 Xcode，单击 Open a project or file，双击打开 demo 目录下的 AlivcVoiceCallSoloClient.xcworkspace 文件。

   

2. 选择运行 Target 为 AlivcVoiceCallSoloClient，将一台 IOS 真机设备使用数据线与电脑链接，在 Xcode 中选择相应的真机设备，真机在设置中打开开发者模式。（暂不支持模拟器运行）

   

3. 修改 Bundle Identifier 和开发者证书。

   注意 Bundle Identifier 改成为

   com.<公司名>.<项目名>

   ，避免由于 Bundle 已被注册从而运行失败。

   General 选项卡中修改。

   

   Sign & Capabilities 选项卡中修改。

   

4. 在 Sign & Capabilities 选项卡，勾选 Automatically manage signing，在下方选择自己的 Team。

1. 1. 选择 Team。

      

   2. 若以前没添加过账号，单击 Add an Account 添加。

      

   3. 完成账号添加。

      

   4. 在 Team 里选择新创建的账号即可，并且在完成签名后确保下方没有报错提示。

1. 单击 build and run 按钮编译。

   

2. 进行 1 对 1 语音聊天。

1. 1. 将 2 台真机移动端设备（Android 或 iOS）装上 Demo App。
   2. 将 2 台设备都连接到同一局域网下，保证可以连接到 Server 端。
   3. 在第一台真机上输入任意房间号，创建房间并等待对方加入。
   4. 在第二台真机上输入相同房间号加入房间并进行通话。

Demo 源码解析

• 项目结构说明。说明Demo 是以 Cocoapods Lib 的方式集成到项目中的。

• • RTC 把开发的业务代码封装到名称为 AlivcVoiceCallSolo 的库当中，这样 AlivcVoiceCallSolo 就可以像一个本地的第三方库一样。可以随便移植到其他项目中，只需在 Podfile 中指定 AlivcVoiceCallSolo 库的路径即可。如下所示：

pod 'AlivcVoiceCallSolo', :path => './AlivcVoiceCallSolo'
    ##   pod 'AlivcVoiceCallSolo'  说明项目依赖AlivcVoiceCallSolo库
    ##   path => './AlivcVoiceCallSolo'  指明AlivcVoiceCallSolo库的位置(相对于Podfile)      

• • 名词解释如下：

• • • pod：表示工程依赖 AlivcVoiceCallSolo 库。
    • path：表示 AlivcVoiceCallSolo 库的路径（相对 podfile 文件）。

• • 

  • AlivcVoiceCallSolo 组件库目录说明，如下所示：

文件名
AlivcVoiceCallSolo.podspec	组件的描述文件。
AlivcVoiceCallSolo.bundle	存放资源的 bundle。
AlivcVoiceCallChannelViewController	首页。
AlivcVoiceCallChattingViewController	聊天页。
AlivcDismissTransition	转场动画。
AlivcPanInteractiveTransition
AlivcPresentTransition
AlivcVoiceCallSettingViewController	设置页。
AlivcVideoCallUserAuthrization	工具类。
NSBundle+AlivcVoiceCallSolo
UIViewController+Alert
AliBaseHttpClient	网络请求。
AliRequestList

• • 

• 功能实现。

• • 创建并加入频道。

//实例化AliRtcEngine并设置代理。
   _engine = [AliRtcEngine sharedInstance:self extras:@""];
   //获取授权信息。
   //AliRtcAuthInfo:各项参数均需要客户AppServer（客户的server端）通过OpenAPI来获取，然后AppServer下发至客户端，客户端将各项参数赋值后，即可joinChannel。
   AuthInfo *authInfo = "从server端获取" 
  [_engine  joinChannel:authInfo name:name onResult:^(NSInteger errCode) {
                    //加入频道回调处理
                    if (errCode == 0) {
                        //加入房间成功
                    } else {
                     //加入房间失败
                    }
                }];      

• • 离开频道。

//离开频道。
[self.engine leaveChannel];
//销毁SDK实例。
[AliRtcEngine destroy];      

• • 播放伴奏。

NSString *path = “文件的路径”
NSString *url = [path stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
//预加载音效文件。
[self.engine preloadAudioEffectWithSoundId:soundId filePath:url];
//播放音效。
[self.engine playAudioEffectWithSoundId:soundId filePath:url cycles:1 publish:YES];      

• • 暂停伴奏。

[self.engine pauseAudioEffectWithSoundId:soundId];      

• • 停止伴奏。

[self.engine stopAudioEffectWithSoundId:soundId];      

• • 恢复播放伴奏。

[self.engine resumeAudioEffectWithSoundId:soundId];      

• • 静音模式。

[self.engine muteLocalMic:YES];      

• • 取消静音模式。

[self.engine muteLocalMic:NO];      

• • 开启扬声器。

[self.engine enableSpeakerphone:YES];      

• • 关闭扬声器。

[self.engine enableSpeakerphone:NO];      

「视频云技术」你最值得关注的音视频技术公众号，每周推送来自阿里云一线的实践技术文章，在这里与音视频领域一流工程师交流切磋。