实时音频
  • 平台类型
  • 框架 / 引擎

SDK 集成指引

更新时间:2020-06-04 17:47

1 准备环境

请确保开发环境满足以下技术要求:

  • Xcode 6.0 或以上版本
  • iOS 8.0 或以上版本且支持音视频的 iOS 设备或模拟器(推荐使用真机)
  • iOS 设备已经连接到 Internet

2 集成 SDK

方式一:使用 CocoaPods 自动集成 SDK

  1. 在执行以下步骤之前,请确保已安装 CocoaPods。安装 CocoaPods 的方法以及常见问题可参考 CocoaPods 常见问题:安装 CocoaPods

  2. 打开终端,cd 进入你的项目的根目录,并执行 pod init 命令创建 Podfile

  3. 打开 Podfile 并添加 pod 'ZegoExpressEngine/Audio_zh',如下所示(后缀加 /Audio_zh 可指定集成极速音频中文 SDK,加 /Audio_en 则集成极速音频英文 SDK,不加则集成极速视频英文 SDK)

     target 'MyProject' do
       use_frameworks!
       pod 'ZegoExpressEngine/Audio_zh'
     end
  4. 执行 pod repo update 更新本地索引,以确保能安装最新版本的 ZegoExpressEngine。(最新版本号请查阅 iOS 发布历史

  5. 执行 pod install 命令安装 ZegoExpressEngine

    若出现 CDN: trunk URL couldn't be downloaded 问题,请参考 CocoaPods 常见问题:连接不上 trunk CDN 的问题

    若出现 Unable to find a specification for 'ZegoExpressEngine' 问题,请参考 CocoaPods 常见问题:无法找到项目的问题

    若出现 CocoaPods could not find compatible versions for pod "ZegoExpressEngine" 问题,请参考 CocoaPods 常见问题:无法找到项目的问题

方式二:手动添加 SDK 到项目中

  1. 下载 SDK

    请从 ZegoExpressEngine iOS 下载 SDK。

  2. 导入 SDK

    注意,SDK 库文件中有两个文件夹:armv7-arm64armv7-arm64-x86_64,区别如下:

    1. armv7-arm64 仅用于真机调试。用户在最终发布时,需要使用此文件下的 ZegoExpressEngine.framework,否则可能被苹果打回。

    2. armv7-arm64-x86_64 包含了真机和模拟器调试的库。如果用户开发过程中使用模拟器调试,需要导入此文件夹下的 ZegoExpressEngine.framework。但是最终发布时,要切换回 armv7-arm64 文件夹下的 framework。

    请选择符合开发要求的 framework 文件。

    1. 手动将 SDK 动态库文件 ZegoExpressEngine.framework,拷贝到项目目录下。

    2. 打开 Xcode,使用 [Add Files to "xxx"(xxx 为用户的项目名)],添加 SDK 动态库文件到项目。

  3. 配置 SDK

    注意:Xcode 11 与 Xcode 10 有差异

    Xcode 11

    在 Xcode 11 中,选择:项目 TARGETS -> General -> Frameworks,Libraries,and Embedded Content 中,添加 ZegoExpressEngine.framework,Embed 设置为 Embed & Sign。

    Dylibembed

    Xcode 10

    在 Xcode 10 中,选择:项目 TARGETS -> General -> Embedded Binaries 中,添加 ZegoExpressEngine.framework。

    Dylibembed Xcode10

3 添加权限

选择项目 TARGETS -> Info -> Custom iOS Target Properties

AddPrivacy

点击 + 添加按钮,添加麦克风权限。

  • Privacy - Microphone Usage Description

添加完成后如图所示:

AddPrivacy Done

4 常见问题

  1. dyld: Library not loaded

    此为 iOS 13.3.1 的 bug,请升级至 iOS 13.4 或以上版本即可解决。

5 相关文档

集成 SDK 后,可以使用 ZEGO SDK 依次完成如下功能来实现基础的通话或者直播。

快速开始-初始化