快速开始 Demo 是互动白板提供的基本白板操作的开源示例工程文件。获取该工程文件后，你可以快速构建应用，体验在线白板互动；也能通过阅读代码，了解构建在线白板的最佳实践。 ## 前提条件 * 根据 [开通服务](https://docs.volcengine.com/docs/6348/69865) 获取的 AppID 和临时 Token * Xcode 9.0+ * iOS 9.0+ 真机设备 * 有效的 [AppleID](http://appleid.apple.com/) * 已获取互动白板[快速开始 Demo 工程文件](https://docs.volcengine.com/docs/6348/1163813) ## 操作步骤 ### 步骤 1：配置 Demo 工程文件 1. 指定 SDK 版本依赖。 * 为 podfile 文件的 target 工程指定 SDK 版本，例如： ```Plain Text target '你的项目名字' do pod 'VolcEngineWhiteboard', '1.8.0'// 将版本号替换为最新或你需要的版本号。 end ``` * 在项目的 .podspec 配置文件里指定 SDK 版本。可以根据实际需要指定 SDK 的版本。 ```Plain Text spec.dependency 'VolcEngineWhiteboard', '1.8.0'// 版本号和 podfile 中的依赖项保持一致。 ``` 2. 在终端打开工程文件目录下的 WhiteBoardDemo，通过 CocoaPods 安装工程依赖。 ```Plain Text pod install ``` 安装成功后打印如下信息。 ```Plain Text Pod installation complete! ``` 3. 使用 Xcode 打开 WhiteBoardDemo 下的 **`WhiteBoardDemo.xcodeproj`** 工程文件。 4. 打开 RTCConfig.h 文件并在双引号间填写你在控制台上获取到的 **AppID** 和 **Token**。 > 注意：没有 AppID 和临时 Token，将无法进入白板房间进行互动。获取方法参看 [开通服务](https://docs.volcengine.com/docs/6348/69865)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3b66991ec7171507be837578401c0882.png) ### 步骤 2：配置开发者证书 1. 登录 Apple ID。 * 选择 Xcode 页面左上角 **Xcode** \> **Preferences**，或通过快捷键 **Command** + **,** 打开 Preferences。 * 选择 **Accounts**，点击左下部 **+** ，选择 Apple ID 进行账号登录。 ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/5c256e713ddd4bc6b5c8526a6b382c86~tplv-em5hxbkur4-noop.image?width=1280&height=849) 2. 配置开发者证书。 * 单击 Xcode 左侧导航栏中的 WhiteBoardDemo 项目，选择 **Signing & Capabilities** \> **Automatically manage signing** 自动生成证书，也可以通过 [https://developer.apple.com/](https://developer.apple.com/) 手动配置，下载证书。 * 在 **Team** 中选择 Personal Team。 * 默认的 **Bundle Identifier** 已被注册，修改为其他 Bundle ID，格式为 `com.xxx`。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_db4e9502fbc3c0aa552f66636e8a60b8.png) ### 步骤 3：编译运行 1. 连接并选择你的 iOS 设备。 2. 选择 **Product** \> **Run**，或通过快捷键 **Command** + **R** 运行。 ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/a46afe5d1bb848dd8aa2f423a5fafe8c~tplv-em5hxbkur4-noop.image?width=1164&height=850) 3. 在 iOS 设备上完成信任开发者设置。 4. 首次运行过程中可能需要在弹窗中输入电脑开机密码： ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/141b43fa85884545a1caab9c387f4707~tplv-em5hxbkur4-noop.image) ### 步骤 4：使用软件 1. 安装成功后，进入 WhiteBoardDemo 应用。 2. 首页为登录界面，输入房间名和用户名，进入房间，体验白板互动。 > 房间名与用户名应与生成临时 Token 时填写的房间 ID 和用户 ID 一致。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_acf11af3360d960a2018014d4cc72a3c.PNG) 3. 加入房间后，应用界面如下图所示，默认横屏显示。在工具栏中选择画笔工具，开始白板互动。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fcf95ddc6431391a6bf69916d3d364cf.PNG) > 使用多台设备体验白板互动时，不同设备必须使用不同 User ID，同一 App ID，并加入同一个房间，才能成功进行互动。 ## 常见问题 1. Build Failed。 * 请使用真机进行 Demo 工程跑通和体验。 * 重启 Mac 和测试设备后再次尝试。 2. 进入房间后，无法绘制。 * 尝试切换右上角的绘图工具，确认画笔工具已被选中。 * 检查画笔颜色是否与背景颜色相同。 * 确认已经在 Config 文件中填写了正确的 AppID 和 Token。所登录的房间 ID 与用于生成当前 Token 的房间 ID 一致。

实时音视频