快速跑通示例项目

前提条件

• Xcode (推荐最新版本)。
• 有效的声网开发者账号。
• 如果你的网络环境部署了防火墙，请根据应用企业防火墙限制打开相关端口。
• 安装 iOS 8.0 或更高版本的 iOS 模拟器或 Apple 设备。

操作步骤

1. 创建声网项目

按照以下步骤，在控制台创建一个声网项目。

1. 登录声网控制台，点击左侧导航栏 项目管理按钮进入项目管理页面。

2. 在项目管理页面，点击创建按钮。

   

3. 在弹出的对话框内输入项目名称，选择鉴权机制为 APP ID。

   声网推荐只在测试环境，或对安全要求不高的场景里使用 App ID 鉴权。

4. 点击提交，新建的项目就会显示在项目管理页中。

2. 获取 App ID

声网会给每个项目自动分配一个 App ID 作为项目唯一标识。

在声网控制台的项目管理页面，找到你的项目，点击 App ID 右侧的眼睛图标就可以直接复制项目的 App ID。

3. 集成声网 SDK

按照以下步骤将声网 SDK 集成到示例项目中。

1. 下载 RTM 仓库，找到 Agora-RTM-Tutorial-iOS 或 Agora-RTM-Tutorial-iOS-Objective-C 示例项目文件夹。

   Agora-RTM-Tutorial-iOS 基于 Swift 实现，Agora-RTM-Tutorial-iOS-Objective-C 基于 Objective-C 实现。

2. 下载最新版云信令 iOS SDK 并解压。

3. 根据你下载的 SDK 版本进行集成：

   • （1.4.3 或之前版本）将 SDK 包中 libs 目录下的 .framework 文件复制到 Agora-RTM-Tutorial-iOS\Agora-RTM-Tutorial 或 Agora-RTM-Tutorial-iOS-Objective-C\Agora-RTM-Tutorial 目录下。
   • （1.4.4 或之后版本）
     1. 将 SDK 包中 libs 目录下的 .xcframework 文件复制到 Agora-RTM-Tutorial-iOS\Agora-RTM-Tutorial 或 Agora-RTM-Tutorial-iOS-Objective-C\Agora-RTM-Tutorial 目录下。
     2. 打开 Xcode，进入 TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content 菜单，并点击 - 移除以下库文件：
        • AgoraRtmKit.framework
        • libc++.tbd
        • libresolv.tbd
        • SystemConfiguration.framework
        • CoreTelephony.framework
     3. 点击 + > Add Other > Add Files 添加你复制的 .xcframework 文件。
     4. 将 AgoraRtmKit.xcframework 的 Embed 属性改为 Embed & Sign。
   使用 1.4.4 版 SDK 集成的 iOS app，在 App Store 由于审核问题无法上架，如需在 App Store 上架请使用其他版本的 SDK。

4. 运行示例项目

1. (Agora-RTM-Tutorial-iOS) 在 AppId.swift 中填入 App ID；(Agora-RTM-Tutorial-iOS-Objective-C) 在 AppId.m 中填入 App ID。
2. 编译并运行项目。
3. 在登录界面填入任意字符串作为用户 ID（例如 userA），点击 Login 即可登录。
   你需要自行设置用户 ID，支持的字符集为：

   • 26 个小写英文字母 a-z
   • 26 个大写英文字母 A-Z
   • 10 个数字 0-9
   • 空格
   • "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","

运行效果