Skip to content

README.zh.md

Latest commit

 

History

History
82 lines (54 loc) · 2.96 KB

README.zh.md

File metadata and controls

82 lines (54 loc) · 2.96 KB
Raw

API Example iOS

English | 中文

本项目提供一组 Agora RTC API 示例，帮助你了解各项 API 的使用方式。

问题描述

在 iOS 14.0 及以上版本中，应用首次使用 Agora RTC SDK 时，系统会请求访问本地网络设备：

解决方案

环境准备

  • iOS 12.0 或更高版本；使用 Xcode 27 SDK 构建的安装包要求 iOS 15.0 或更高版本
  • Xcode 13.0 或更高版本，且支持所需部署目标（Xcode 支持范围）。使用 iOS 27 SDK 时，主 App、扩展和 Pods 自动采用 iOS 15 部署目标；需要兼容 iOS 12 的安装包时，使用支持该目标的旧工具链。
  • iPhone 或 iPad 真机
  • 不支持 iOS 模拟器

快速开始

以下步骤说明如何安装依赖、配置项目并运行示例。

安装依赖

进入当前示例目录，然后安装 CocoaPods 依赖。CocoaPods 的安装方式请参考官方指南。

cd iOS/APIExample
pod install

确认 APIExample.xcworkspace 已成功生成。

获取 App ID

  1. 登录 Agora Console 并创建项目。

  2. 在项目详情页复制 App ID。

  3. 使用 Xcode 打开 APIExample.xcworkspace。

  4. 编辑 APIExample/Common/KeyCenter.swift，填入 App ID：

    static let AppId: String = "<YOUR_APP_ID>"
static let Certificate: String? = nil

如果项目未启用 App Certificate，请保持 Certificate 为 nil。App Certificate 属于敏感信息，生产环境应在服务端生成 Token，不应将证书写入客户端或提交到 Git。

连接 iPhone 或 iPad 真机后，即可在 Xcode 中构建并运行项目。

Agora 美颜 2.0 资源

Agora 美颜 2.0 资源包不包含在仓库中。本地构建前，从 Agora 技术支持获取 AgoraBeautyMaterial.bundle.zip，并解压到 iOS/APIExample/APIExample/Resources/。

解压后的资源目录结构如下：

iOS/APIExample/APIExample/Resources/
└── AgoraBeautyMaterial.bundle/
    ├── beauty_material_functional/
    │   ├── config.json
    │   └── ...
    └── ...

解压后的 bundle 已被 Git 忽略。

联系我们

代码许可

本项目采用 MIT License。