README.zh.md

API Example iOS

English | 中文

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

问题描述

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

解决方案

环境准备

• iOS 12.0 或更高版本
• Xcode 13.0 或更高版本，且该版本支持将最低部署目标设为 iOS 12（Xcode 支持范围）
• iPhone 或 iPad 真机
• 不支持 iOS 模拟器

快速开始

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

安装依赖

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

cd iOS/APIExample-OC
pod install

确认 APIExample-OC.xcworkspace 已成功生成。

获取 App ID

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

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

3. 使用 Xcode 打开 APIExample-OC.xcworkspace。

4. 编辑 APIExample-OC/Common/KeyCenter.m，填入 App ID：

   static NSString * const APPID = @"<YOUR_APP_ID>";
   static NSString * const Certificate = nil;

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

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

联系我们

• 常见问题请查看 Agora FAQ
• 更多示例请查看 AgoraIO
• 复杂场景示例请查看 AgoraIO Use Cases
• 社区维护项目请查看 AgoraIO Community
• 完整 API 文档请查看 Agora Documentation
• 集成问题可以在 Stack Overflow 提问
• 示例问题请提交到 API-Examples Issues

代码许可

本项目采用 MIT License。