跑通示例项目 (Android)

概览

Agora 在 GitHub 上提供一个开源的 Agora Meeting 示例项目，演示了如何实现基本的视频会议场景。

你可参考本文编译并运行 Android 平台的 Agora Meeting 示例项目，体验视频会议。

前提条件

• Android Studio (推荐最新版本)。
• 一台 Android 设备或模拟器。Agora 推荐你使用真机。Android 版本 4.4 及以上。
• 有效的 Agora 账号。

跑通步骤

1. 创建 Agora 项目并获取 App ID

在开始使用 Agora 服务之前，你需要注册一个 Agora 开发者账号。成功注册后，按照以下步骤，在 Agora 控制台创建一个 Agora 项目并获取该项目的 App ID。

1. 登录 Agora 控制台，点击左侧导航栏项目管理按钮进入项目管理页面。

2. 在项目管理页面，点击创建按钮。

   

3. 在弹出的对话框内输入项目名称，鉴权机制必须为 APP ID + Token。

4. 点击提交，新建的项目就会显示在项目管理页中。

5. Agora 会给每个项目自动分配一个 App ID 作为项目唯一标识。在项目管理页面，找到你刚刚创建的项目，点击 App ID 右侧的眼睛图标就可以直接复制此项目的 App ID。你需要保存此 App ID。

   

2. 获取客户 ID 和客户秘钥

1. 登录 Console，点击右上角账户名，进入下拉菜单 RESTful API 页面。

   

2. 点击下载，即可获取客户 ID和客户密钥。

   

   客户 ID 和客户密钥仅用于访问 RESTful API。客户密钥只能下载一次，下载后将不在控制台保存，请妥善保管。

3. 获取 Agora 互动白板服务的 App Identifier 和 SDK Token

Agora Meeting 集成了 Agora 互动白板 SDK 以实现互动白板功能。因此，你需要进行以下操作：

1. 登录 Agora 控制台，为你先前创建的 Agora 项目开启互动白板服务。
2. 获取互动白板服务的 App Identifier。你需要自行保存此 App Identifier。
3. 获取互动白板服务的 SDK Token。你需要自行保存此 SDK Token。

4. 在 Agora 控制台配置 Agora Meeting 的白板功能

参考以下步骤在 Agora 控制台对 Agora Meeting 的白板功能进行配置。

1. 登录 Agora 控制台，进入项目管理页面，找到你刚刚创建的项目，点击该项目的编辑按钮进入项目编辑页面，然后点击 aPaaS 配置按钮。

   

2. 进入 aPaaS 配置页面，勾选白板以开通此功能，然后参考下文分别传入相应的 JSON 配置对象，点击更新。返回项目管理页面后，再点击保存以确保 aPaaS 配置生效。

配置对象示例如下：

{
        "appId": "<your_whiteboard_app_id>",
        "token": " <your_whiteboard_sdk_token>"
 }

你需要将 <your_whiteboard_app_id> 替换为你获取到的互动白板 App Identifier，将 <your_whiteboard_sdk_token> 替换为你获取到的互动白板 SDK Token。

5. 获取客户 ID 和客户秘钥

1. 登录 Console，点击右上角账户名，进入下拉菜单 RESTful API 页面。

   

2. 点击下载，即可获取客户 ID和客户密钥。

   

   客户 ID 和客户密钥仅用于访问 RESTful API。客户密钥只能下载一次，下载后将不在控制台保存，请妥善保管。

6. 获取示例项目

前往 GitHub 下载或克隆 Agora Meeting 示例项目。

7. 运行示例项目

1. 开启 Android 设备的开发者选项，通过 USB 连接线将 Android 设备接入电脑。

2. 用 Android Studio 打开 AgoraMeeting_Android 文件夹。

3. 点击 Sync Project with Gradle Files 按钮，同步依赖项。

4. 在 app/src/main/res/values/string_configs.xml 文件中配置以下字段：

    <string name="agora_app_id" translatable="false"><#YOUR APP ID#></string>
    <string name="agora_customer_id" translatable="false"><#YOUR CUSTOMER ID#></string>
    <string name="agora_customer_cer" translatable="false"><#YOUR CUSTOMER CRE#></string>

   • 将 <#YOUR APP ID#> 替换为你的 App ID。
   • 将 <#YOUR CUSTOMER ID#> 替换为你的客户 ID。
   • 将 <#YOUR CUSTOMER CRE#> 替换为你的客户秘钥。

5. 同步完成后，构建并在设备上运行项目。

6. 输入房间名、密码、姓名，点击加入，即可体验视频会议功能。