RoomKit
  • 平台类型
  • 框架 / 引擎
  • iOS
  • Android
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序
示例源码
本地下载
说明

1 示例源码运行指引

1.1 准备环境

请确保开发环境满足以下技术要求:

  • Xcode 7.0 或以上版本。
  • iOS 9.0 或以上版本且支持音视频的 iOS 设备或模拟器(推荐使用真机)。
  • iOS 设备已经连接到 Internet。

1.2 前提条件

  1. 联系 ZEGO 技术支持获取初始化 RoomKit SDK 所必须的 SecretID、SecretSign、Domain、ProductID_1v1、ProductID_smallRoom、ProductID_largeRoom 等信息。

虽然开发者在示例源码中填入自定义的 SecretID 和 SecretSign 能够正常获取到 SDK Token 并进行后续的登录操作,但是不建议开发者在自己的 App 中使用这种做法。建议开发者使用业务服务器向 ZegoRoomKit 服务器请求 SDK Token 以保证数据安全,详情请参考 获取 SDK Token

  1. 创建 userID。下载的示例源码中缺少创建房间必须的 userID。userID 需要开发者提前在 ZegoRoomKit 后台创建,创建方法有两种:
  • 开发者登录 RoomKit 管理后台(登录账号密码由 ZegoRoomKit 接入时分配),手动创建 userID,用于调试时正常运行示例源码。

  • 开发者调用 Server API 创建用户,详情请参考 服务端API,此方法是正式接入时的推荐流程。

1.3 运行示例源码

  1. 打开 AppStore,搜索 Xcode 并下载安装。
  1. 解压示例源码,并在解压后的文件夹中双击文件 ZegoRoomkitDemo.xcworkspace。

workspace_position

  1. 修改开发者证书和 Bundle Identifier。

a. 打开 Xcode,单击左侧的 ZegoRoomkitDemo 项目。

choose_project

b. 分别选中 Target 和 Extension Target,单击 Signing & Capabilities 选项卡,将示例源码中的 Team、Bundle Identifier 和 App Groups,修改成开发者自己的值。

Targets 中选择 ZegoRoomkitDemo 时,修改页面如下:

signing_1

Targets 中选择 ZegoRoomkitDemoScreenShare 时,修改页面如下:

signing_2

  1. 修改示例源码中 ZegoAuthConstants.h 文件。

a. 填充 kSecretID、kSecretSign 等 RoomKit SDK 初始化所需的参数值。请使用本文 前提条件 中获取的信息正确填写,否则示例源码无法正常运行。

b. 将 kRPAppGroup 和 kAppExtensionBundleID 修改为上面步骤 3 中设置的值。

auth_constant

  1. 将 iOS 设备连接到开发电脑,单击 Xcode 左上角的 Generic iOS Device 选择 iOS 真机或者模拟器。

choose_device

  1. 单击 Xcode 左上角的 Build & Run 按钮,编译和运行示例源码。

run