根据本文指导通过 Agora Classroom SDK 快速启动并体验灵动课堂。

技术原理

下图展示了启动灵动课堂的基本流程。

当你的 app 客户端请求加入灵动课堂时：

1. 你的 app 客户端向 app 服务端申请 RTM Token。
2. 你的 app 服务端使用 Agora App ID、App 证书和用户 ID 生成一个 RTM Token，返回给 app 客户端。详见生成 RTM Token。
3. 你的 app 客户端调用 API 并传入用户 ID、房间 ID 和 RTM Token 启动灵动课堂。灵动课堂云服务会根据你传入的房间 ID 为该课题自动创建一个房间。

前提条件

• 已在 Agora 控制台创建 Agora 项目，获取 Agora App ID、App 证书并配置 aPaaS 服务。
• Xcode 10.0 或以上版本。
• CocoaPods 1.10 或以上版本。参考 Getting Started with CocoaPods 安装说明。
• iOS 10 或以上版本。
• 如果你使用 Swift 开发，使用 Swift 5.0 或以上版本。
• 一个有效的 Apple 开发者账号。
• 一台 iOS 设备（iPhone 或 iPad）。模拟机可能出现功能缺失或者性能问题，所以推荐使用真机。

启动灵动课堂

参照以下步骤启动灵动课堂：

1. 运行以下命令将 Agora 提供的灵动课堂项目 CloudClass-iOS 克隆至本地：

   git clone https://github.com/AgoraIO-Community/CloudClass-iOS

2. 将 keycenter.m 文件中的 Agora App ID 和 Agora App Certificate 替换成你的 App ID 和 App 证书。

   + (NSString *)appId {
       return <#Your Agora App Id#>;
   }
   
   + (NSString *)appCertificate {
       return <#Your Agora Certificate#>;
   }

   为方便你快速测试，CloudClass-iOS 项目中已包含一个临时 RTM Token 生成器，会用你传入的 App ID 和 App 证书生成一个临时 RTM Token。但是在正式环境中，为确保安全，RTM Token 必须在服务端生成。

   你可在 AgoraEducation/Main/Controllers/LoginViewController.swift 文件中查看启动课堂的具体逻辑：

   1. 调用 AgoraEduSDK.setConfig 方法全局配置 SDK。
   2. 调用 AgoraEduSDK.launch 方法启动灵动课堂。

3. 连接上 iOS 设备后，用 Xcode 打开示例项目，然后编译并运行项目。

4. 输入房间名、用户名，选择一种班型，然后点击加入，即可进入灵动课堂，看到以下画面：

   

后续步骤

现在你已经初步体验了灵动课堂的功能，接下来可试着将灵动课堂集成到你自己的 app 项目中。