跑通示例项目

最近更新时间:2021-01-28 13:28:53

概览

AR 在 GitHub 上提供一个开源的一对一视频通话示例项目 AR-Android-Tutorial-1to1。本文介绍如何快速跑通该示例项目,体验 AR视频通话效果。

如果你是第一次使用anyRTC的服务,我们推荐观看下面的视频,了解关于anyRTC服务的基本信息以及如何快速跑通示例项目。

视频中展示的 UI 可能有部分调整更新,请以当前最新版为准。

前提条件

  • Android Studio 3.0 或以上版本
  • Android SDK API 等级 19 或以上
  • 支持 Android 4.4 或以上版本的移动设备
  • 有效的 anyRTC 账户App ID

操作步骤

1. 创建 AR项目

按照以下步骤,在控制台创建一个 AR项目。

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

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

  3. 在弹出的对话框内输入项目名称,选择鉴权机制APP ID + Token。

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

2. 获取 App ID

AR会给每个项目自动分配一个 App ID 作为项目唯一标识。

AR控制台项目管理页面,找到你的项目,点击 App ID 右侧的眼睛图标就可以直接复制项目的 App ID。

3. 生成临时 Token

为提高项目的安全性,AR使用 Token(动态密钥)对即将加入频道的用户进行鉴权。

为了方便测试,AR控制台提供生成临时 Token 的功能,具体步骤如下:

  1. 在控制台的项目管理页面,点击已创建项目的图标,打开 Token 页面。

  2. 输入一个频道名,例如 test,然后点击生成临时Token。临时 Token 的有效期为 12 小时、24小时、3天、15天。

临时 Token 仅作为演示和测试用途。在生产环境中,你需要自行部署服务器签发 Token,详见生成 Token

对于本示例项目,请将频道名设为 123456。

4. 配置示例项目

参考以下步骤配置示例项目:

  1. 前往 AR-Android-Tutorial-1to1 DEMO页面,下载DEMO,然后解压。

  2. 找到AR-Android-Tutorial-1to1 示例项目文件夹,在

    app/src/main/res/values/strings.xml
    

    文件中填写你从anyRTC控制台获取到的 App ID 和临时 Token。

    // 把 <#YOUR APP ID#> 替换成你的 App ID,字符串格式
    <string name="ar_app_id"><#YOUR APP ID#></string>
    // 把 <#YOUR ACCESS TOKEN#> 替换成你的临时 Token,字符串格式
    <string name="ar_access_token"><#YOUR ACCESS TOKEN#></string>
    

5. 集成 ARSDK

按照以下步骤将 AR视频通话 SDK 集成到示例项目中。

  1. 使用最新版SDK。

  2. 将 SDK 包中 libs 文件夹下如下文件拷贝到示例项目对应的文件夹下:

    文件或文件夹项目路径
    arrtcengine-release 文件/app/libs/

6. 编译并运行示例项目

连接上 Android 设备后,用 Android Studio 打开 AR-Android-Tutorial-1to1 示例项目,然后编译并运行示例项目。

运行成功后,你会在 Android 设备上看到如下画面。

你已默认加入了 123456 频道。如果想体验一对一视频通话效果,你可以通过另一台设备 ,输入相同的 App ID、频道名和临时 Token,加入同一频道与 Android 端互通。