互动白板
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • Electron
  • 概述
  • 价格说明
  • 下载
  • 跑通示例源码
  • 接入指南
  • 快速开始
  • 场景实践
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 互动白板
  • 快速开始
  • 集成

集成

更新时间:2023-05-15 17:25

1 前提条件

  • 由于 ZegoWhiteboardView SDK 需要与 ZegoExpress-Video SDK(含白板功能)搭配使用,请同时集成 ZegoExpress-Video SDK(含白板功能),详情请参考实时音视频的 快速开始 - 集成

    • 互动白板 SDK 中已包含 ZegoExpress-Video SDK(含白板功能),无需单独下载。

    • 如已集成过 ZegoExpress-Video SDK,需要删除旧包并重新集成 互动白板 SDK 中获取的包,避免 ZegoExpress-Video SDK 和 ZegoWhiteboardView SDK 版本不匹配造成初始化失败。

  • 如果需要使用文件共享功能,请下载 ZegoDocsView SDK

  • 2 准备环境

    在开始集成 ZegoWhiteboardView SDK 前,请确保开发环境满足以下要求:

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

    3 集成 SDK

    3.1 (可选)新建项目

    此步骤以如何创建新项目为例,如果是集成到已有项目,可忽略此步。
    1. 启动 Xcode,在 “Welcome to Xcode” 窗口中单击 “Create a new Xcode project” 或选择 “File > New > Project” 菜单。在出现的表单中,选择 iOS 平台,并在 “Application” 下选择 “App”。

    2. 填写表单并选取各个选项来配置项目,单击 “Next”。

    必须提供 “Product Name” 和 “Organization Identify”,用于创建在整个系统中标识 App 的 “Bundle Identify”。

    1. 选择项目存储路径,单击 “Create” 创建项目。

    3.2 导入 SDK

    开发者可通过以下任意一种方式实现集成 SDK。

    方式一: 使用 CocoaPods 自动集成

    1. 安装 CocoaPods,安装方法及常见问题请参考 CocoaPods 常见问题 - 安装 CocoaPods

    2. 打开终端,进入项目根目录,执行 pod init 命令创建 Podfile 文件。

    3. 打开 Podfile 文件,添加 pod 'ZegoWhiteboardView/Express'

    4. 执行 pod install 命令安装 SDK。

    5. 在工程中导入 ZegoWhiteboardView SDK 头文件 #import <ZegoWhiteboardView/ZegoWhiteboardView.h>

    方式二:复制 SDK 文件手动集成

    SDK 库文件中包含 iphoneos 和 iphoneos_simulator 两个文件夹,区别如下:

    1. iphoneos 仅用于真机调试。用户在最终发布时,需要使用此文件下的 ZegoWhiteboardView.framework,否则可能被苹果打回。
    2. iphonos_simulator 包含了真机和模拟器调试的库。如果用户开发过程中使用模拟器调试,需要导入此文件夹下的 ZegoWhiteboardView.framework。但是最终发布时,要切换回 iphoneos 文件下的 framework。

    在下面的设置步骤中,请选择符合开发要求的 framework 文件。

    1. 请参考 下载 SDK 包,下载最新版本的 SDK,下载完成后进行解压。

    2. 手动将 SDK 动态库文件,拷贝到项目目录下。

    3. 打开 Xcode,选择 “File > Add Files to "xxx"(xxx 为项目名)” 菜单,添加 SDK 库文件到项目。

    4. 选择 “TARGETS > General > Frameworks,Libraries,and Enbedded Content” 菜单,添加 “ZegoWhiteboardView.framework”,将 “Embed” 设置为 “Embed & Sign”。

    5. 选择 “TARGET > General > Deployment Target”,设置 8.0 或以上版本。

    本篇目录