集成

---

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 前，请确保开发环境满足以下要求：

• Android Studio 4.0 或以上版本。
• Android 版本不低于 5.0 且支持音视频的 Android 设备。
• Android 设备已经连接到 Internet。

3 集成 SDK

3.1 （可选）新建项目

此步骤以如何创建新项目为例，如果是集成到已有项目，可忽略此步骤。

1. 打开 Android Studio，选择菜单 “File > New > New Project”。

   

2. 选择项目类型 “Empty Activity”。

   

3. 选择项目存储路径。

   

4. 单击 “Finish” 完成新工程创建。

3.2 导入 SDK

1. 请参考 下载 SDK 包 ，下载最新版本的 SDK。

2. 解压下载的 SDK 文件，将 zegowhiteboardview.aar 文件拷贝到开发者的项目目录 “app/libs/” 文件夹下。

3. 在 “app/build.gradle” 文件中的 dependencies 节点下添加以下代码:

   implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')

4. SDK 依赖以下模块，在 “app/build.gradle” 文件中的 dependencies 节点下添加以下代码:

   // 如果需要在纯java项目中集成,需要添加此依赖项
   implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.4.30" // 文档编写时最新版本为1.4.30

4 设置权限

添加权限声明，打开 "app/AndroidManifest.xml" 文件，添加如下内容：

    <!-- SDK 必须使用的权限 -->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

权限说明如下：

5 防止代码混淆

在 proguard-rules.pro 文件中，为 SDK 添加 -keep 类的配置，这样可以防止混淆 SDK 公共类名称。

-keep class im.zego.zegowhiteboard.**{*;}