示例项目
anyRTC 在 GitHub 上提供开源的示例项目 AriOSSDK。在实现相关功能前,你可以下载并查看源代码。
前提条件
-
Xcode 9.0 或以上版本
-
支持 macOS 10.15 +
-
有效的 anyRTC 账户 和 App ID
准备开发环境
本节介绍如何创建项目,并将 RTC SDK 集成至你的项目中。
创建 macOS 项目
参考以下步骤创建一个 macOS 项目。若已有 macOS 项目,可以直接查看集成 SDK。
方法一:使用 CocoaPods 自动集成
- 开始前确保你已安装 Cocoapods。参考 Getting Started with CocoaPods 安装说明。
- 在 Terminal 里进入项目根目录,并运行 pod init 命令。项目文件夹下会生成一个 Podfile 文本文件。
- 打开 Podfile 文件,修改文件为如下内容。注意将 Your App 替换为你的 Target 名称。
platform :ios,'9.0'
target ‘Your App’ do
pod 'ARtcKit_iOS'
use_frameworks!
end
- 在 Terminal 内运行 pod update 命令更新本地库版本。
- 运行 pod install 命令安装 anyRTC SDK。成功安装后,Terminal 中会显示 Pod installation complete!,此时项目文件夹下会生成一个 xcworkspace 文件。
- 打开新生成的 xcworkspace 文件。
方法二:手动复制 SDK 文件
-
前往 SDK 下载页面,获取最新版的 anyRTC SDK。
-
在项目中找到ARtcKit.framework,复制到项目文件夹下。
-
打开 Xcode(以 Xcode 11.0 为例),进入 TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content 菜单,点击 +,再点击 Add Other… 添加 在项目中找到ARtcKit.framework。添加完成后,项目会自动链接其他系统库。为保证动态库的签名和 app 的签名一致,你需要将动态库的 Embed 属性设置为 Embed & Sign。
注意事项: 根据 Apple 官方要求,App 的 Extension 不允许包含动态库。如果工程中的 Extension 需要集成 SDK,则集成动态库时需将文件状态改为 Do Not Embed。
动态库添加前:
动态库添加后:
添加媒体设备权限
根据场景需要,在 info.plist 文件中,点击 + 图标开始添加如下内容,获取相应的设备权限:
Key | Type | Value |
---|---|---|
Privacy - Microphone Usage Description | String | 使用麦克风的目的,例如:for a call。 |
Privacy - Camera Usage Description | String | 使用摄像头的目的,例如:for a call。 |
添加前:
添加后: