本站点除 Legacy 产品与方案外，已迁移至声网新文档中心，当前页面不再维护

文档中心





全部产品

Console 官网社区技术支持





实现语音通话

更新时间 2023/01/12 09:16:43

实时语音通话能够拉近人与人之间的距离，为用户提供沉浸式的交流体验，帮助你的 app 提高用户黏性。

本文介绍如何通过少量代码集成 Agora 音频 SDK 并调用 API，在你的应用中实现高质量、低延迟的语音通话功能。

技术原理

下图展示在 app 中实现声网语音通话的基本工作流程：

实现语音通话的步骤如下：

1. 设置角色

将用户角色均设置为主播。

2. 加入频道

调用 joinChannel 创建并加入频道。在 App ID 一致的前提下，传入相同频道名的用户会进入同一个频道。

3、4. 在频道内发布和订阅音频

加入频道后，两位主播可以发布音频并互相订阅。

前提条件

Xcode 12.0 或以上版本。
两台 iOS 9.0 或以上版本的设备。
可以访问互联网的计算机。请确保你的网络环境未部署防火墙，否则可能无法正常使用声网服务。
一个有效的声网账号以及声网项目。请参考开始使用声网平台从声网控制台获得以下信息：
- App ID：声网随机生成的字符串，用于识别你的项目。
- 临时 Token：Token 也称为动态密钥，在客户端加入频道时对用户鉴权。临时 token 的有效期为 24 小时。
- 频道名：用于标识频道的字符串。
Apple 开发者账号。

创建项目

在 Xcode 中进行以下操作，在你的 app 中实现语音通话功能：

创建一个新的项目，Application 选择 App，Interface 选择 Storyboard，Language 选择 Swift。

如果你没有添加过开发团队信息，会看到 Add account… 按钮。点击该按钮并按照屏幕提示登入 Apple ID，点击 Next，完成后即可选择你的 Apple 账户作为开发团队。
为你的项目设置自动签名。
设置部署你的 app 的目标设备。
添加项目的设备权限。

在项目导航栏中打开 info.plist 文件，编辑属性列表，添加以下属性：

key type value

Privacy - Microphone Usage Description String 使用麦克风的目的，例如：for a call or live interactive streaming。
- 如果你的项目中需要添加第三方插件或库，且该插件或库的签名与项目的签名不一致，你还需勾选 Hardened Runtime > Runtime Exceptions 中的 Disable Library Validation。
- 更多注意事项，可以参考 Preparing Your App for Distribution。

key	type	value
Privacy - Microphone Usage Description	String	使用麦克风的目的，例如：for a call or live interactive streaming。

将声网音频 SDK 集成到你的项目。

开始前请确保你已安装 Cocoapods，如尚未安装 Cocoapods，参考 Getting Started with CocoaPods 安装说明。
1. 在终端里进入项目根目录，并运行 pod init 命令。项目文件夹下会生成一个 Podfile 文本文件。
2. 打开 Podfile 文件，修改文件为如下内容。注意将 Your App 替换为你的 Target 名称。
```
platform :ios, '9.0'
target 'Your App' do
  # x.y.z 请填写具体的 SDK 版本号，如 4.0.1 或 4.0.0.4。
  # 可通过发版说明获取最新版本号。
pod 'AgoraAudio_iOS', 'x.y.z'
end
```
3. 在终端内运行 pod install 命令安装声网 SDK。成功安装后，Terminal 中会显示 Pod installation complete!。
4. 成功安装后，项目文件夹下会生成一个后缀为 .xcworkspace 的文件，通过 Xcode 打开该文件进行后续操作。
你也可以使用其他方式来集成 SDK，详见其他集成方式。

实现语音通话

本节介绍如何使用声网音频 SDK 在你的 app 中实现语音通话功能。

创建用户界面

参考以下代码创建一个基础的用户界面：

   import UIKit
   class ViewController: UIViewController{
       ...
       // 定义 agoraKit
       var agoraKit: AgoraRtcEngineKit!
   }

实现语音通话逻辑

下图展示了实现语音通话的 API 调用时序。

参考以下步骤来实现语音通话逻辑：

导入声网kit

打开 ViewController.swift 文件，将下列代码添加至 import UIKit 之后：
```
import AgoraRtcKit
```

初始化声网引擎

调用 sharedEngineWithConfig 创建并初始化 AgoraRtcEngineKit 对象。在 ViewController.swift 文件中，将下列代码添加至 initView 之后：

func initializeAgoraEngine(){
    let config = AgoraRtcEngineConfig()
    // 在这里输入你的 App ID.
    config.appId = <#Your app Id#>
    // 调用 AgoraRtcEngineDelegate
    agoraKit = AgoraRtcEngineKit.sharedEngine(with: config, delegate: self)
}

填入你的临时 token、频道名以及用户 ID 加入频道，并设置频道场景及用户角色

在 ViewController.swift 文件中，将下列代码添加至 initializeAgoraEngine 之后：

func joinChannel(){
    let option = AgoraRtcChannelMediaOptions()
    // 在语音通话场景下，将频道场景设置为 liveBroadcasting
    option.channelProfile = .of((Int32)(AgoraChannelProfile.liveBroadcasting.rawValue))
      // 关闭摄像头
    option.publishCameraTrack = .of(false)
    // 设置用户角色为主播
    option.clientRoleType = .of((Int32)(AgoraClientRole.broadcaster.rawValue))

    // 使用临时 token 加入频道，在这里传入你的项目的 token 和频道名。
    agoraKit?.joinChannel(byToken: <#Your token#>, channelId: <#Your channel name#>, uid: 0, mediaOptions: option)
  }

启动和关闭 app

至此，你已经成功在你的 app 中添加了语音通话功能。当用户启动你的 app 时，语音通话开始；当用户关闭 app 时，语音通话结束。

当视图加载完成后，调用 viewDidLoad 加入频道。

打开 ViewController.swift 文件，将 viewDidLoad 添加至 UIViewController 中：

override func viewDidLoad() {
    super.viewDidLoad()
    // 当调用声网 API 时，以下函数会被调用
    initializeAgoraEngine()
    joinChannel()
}

离开频道

在 ViewController.swift 文件中，将 viewDidDisappear 添加至 joinChannel 函数之后：

override func viewDidDisappear(_ animated: Bool) {
    super.viewDidDisappear(animated)
    agoraKit?.leaveChannel(nil)
}

测试你的 app

参考以下步骤来测试你的 app：

将 iOS 设备连接至计算机。
点击 Build 来运行你的项目，需等待几秒至安装完成。
允许 app 访问设备的麦克风权限。
启动 app，并邀请一位朋友通过另一台设备来使用相同的 App ID、Token、频道名加入频道。你的朋友加入频道后，你们可以听见对方。

后续步骤

在测试或生产环境中，为确保通信安全，声网推荐使用 token 服务器来生成 token，详见使用 Token 鉴权。

实现语音通话

技术原理

前提条件

创建项目

实现语音通话

创建用户界面

实现语音通话逻辑

启动和关闭 app

测试你的 app

后续步骤

相关信息

示例项目

其他集成方式

手动集成 SDK

使用 Swift Package Manager