You need to enable JavaScript to run this app.
导航
iOS
最近更新时间:2023.12.13 16:13:04首次发布时间:2023.02.15 18:01:57

快速开始 Demo 是互动白板提供的基本白板操作的开源示例工程文件。获取该工程文件后,你可以快速构建应用,体验在线白板互动;也能通过阅读代码,了解构建在线白板的最佳实践。

前提条件

操作步骤

步骤 1:配置 Demo 工程文件

  1. 指定 SDK 版本依赖。
  • 为 podfile 文件的 target 工程指定 SDK 版本,例如:
target '你的项目名字' do
  pod 'VolcEngineWhiteboard', '1.8.0'// 将版本号替换为最新或你需要的版本号。
  • 在项目的配置文件里指定 SDK 版本。可以根据实际需要指定 SDK 的版本。
spec.dependency 'VolcEngineWhiteboard', '1.8.0'// 版本号和 podfile 中的依赖项保持一致。
  1. 在终端打开工程文件目录下的 WhiteBoardDemo,通过 CocoaPods 安装工程依赖。
pod install

安装成功后打印如下信息。

Pod installation complete! 
  1. 使用 Xcode 打开 WhiteBoardDemo 下的 WhiteBoardDemo.xcodeproj 工程文件。
  2. 打开 RTCConfig.h 文件并在双引号间填写你在控制台上获取到的 AppIDToken

注意:没有 AppID 和临时 Token,将无法进入白板房间进行互动。获取方法参看 开通服务

alt

步骤 2:配置开发者证书

  1. 登录 Apple ID。
  • 选择 Xcode 页面左上角 Xcode > Preferences,或通过快捷键 Command + , 打开 Preferences。
  • 选择 Accounts,点击左下部 +,选择 Apple ID 进行账号登录。
    image.png
  1. 配置开发者证书。
  • 单击 Xcode 左侧导航栏中的 WhiteBoiardDemo 项目,选择 Signing & Capabilities > Automatically manage signing 自动生成证书,也可以通过 https://developer.apple.com/ 手动配置,下载证书。
  • Team 中选择 Personal Team。
  • 默认的 Bundle Identifier 已被注册,修改为其他 Bundle ID,格式为 com.xxx
    alt

步骤 3:编译运行

  1. 连接并选择你的 iOS 设备。
  2. 选择 Product > Run,或通过快捷键 Command + R 运行。
    image
  3. 在 iOS 设备上完成信任开发者设置。
  4. 首次运行过程中可能需要在弹窗中输入电脑开机密码:
    image

步骤3:使用软件

  1. 安装成功后,进入 WhiteBoardDemo 应用。

  2. 首页为登录界面,输入房间名和用户名,进入房间,体验白板互动。

房间名与用户名应与生成临时 Token 时填写的房间 ID 和用户 ID 一致。

alt

  1. 加入房间后,应用界面如下图所示,默认横屏显示。在工具栏中选择画笔工具,开始白板互动。

alt

使用多台设备体验白板互动时,不同设备必须使用不同 User ID,同一 App ID,并加入同一个房间,才能成功进行互动。

常见问题

  1. Build Failed。
  • 请使用真机进行 Demo 工程跑通和体验。
  • 重启 Mac 和 测试设备后再次尝试。
  1. 进入房间后,无法绘制。
  • 尝试切换右上角的绘图工具,确认画笔工具已被选中。
  • 检查画笔颜色是否与背景颜色相同。
  • 确认已经在 Config 文件中填写了正确的 AppID 和 Token。所登录的房间 ID 与用于生成当前 Token 的房间 ID 一致。