快速开始 Demo 是 RTC 提供的基本音视频通话功能的开源示例工程文件。获取该工程文件后，你可以快速构建应用，感受 RTC 的通话效果；也能通过阅读代码，了解基本音视频通话的最佳实践。

应用使用说明

使用该项目构建应用后，你可以使用该应用进行音视频通话。

你和你的同事必须使用同一 Appid 且加入同一个房间，才能成功进行音视频通话。

前提条件

推荐使用真机进行测试，使用模拟器可能有部分功能无法正常体验

操作步骤
步骤1：配置Demo工程文件

  1. 解压已下载的 RTC 快速开始 Demo 工程文件（Android），并使用 Android Studio 打开工程文件。

  2. 搜索并打开 Constants.java 。

说明：Mac开发环境，在没有改快捷键的情况下，可双击 Shift 后输入文件地址进行搜索。

搜索 Constants.java

图1 - 搜索 Constants.java 文件
  1. 打开 Constants 文件之后，界面如下图所示。你需要在该界面 APPID 和 TOKEN 后分别填入你的 AppID 和临时 Token。

注意：

  • 如果你没有 AppID 和临时 Token，请参看 开通服务。
  • 如果没有向 APPID 和 TOKEN 填入相应的值，Constants 文件会不符合 Java 语法规范，导致编译不通过。

image.png

图2 - Constants 文件

下图为填写 AppID 和临时 Token 示例：

alt

图3 - 填写示例
步骤2：编译运行
  1. 连接 Android 真机。连接成功后，设备名称出现在界面上方，如下图所示。

如果 Android Studio 未能成功连接设备，请参看 Android Studio 官方用户指南之在硬件设备上运行应用。

alt

图4 - 连接成功后显示设备名称
  1. 点击软件界面上方 Run -> Run 'app' 按钮，运行工程文件。

image.png

图5 - Run 'app' 按钮
  1. 工程运行后，将会在已连接 Android 真机上安装 QuickStart 应用。如果安装过程中，设备弹出风险提示（如下图所示），请选择继续安装。

image.png

图6 - 安装 QuickStart 应用风险提示
步骤3：使用软件
  1. 安装成功后，设备屏幕将自动跳转至 QuickStart 应用的加入房间界面。此时应用会向你请求若干权限，请选择允许，否则可能影响后续实时音视频通话的画面和音频采集。
  2. 允许 QuickStart 应用使用权限之后，屏幕为加入房间界面，你需要输入房间名和用户名，才能加入房间，体验实时音视频通话。

注意：房间名与用户名应与生成临时 Token 时填写的房间 ID 和用户 ID 一致。

image

图7 -输入房间名和用户名
  1. 加入房间后，应用界面如下图所示。你可以在左上角看到当前设备所采集的图像，则快速开始 Demo 工程文件成功跑通。

image.png

图8 - 房间内界面
常见问题

  1. 打开项目时提示错误 Gradle sync failed: com.android.tools.idea.gradle.project.sync.idea.issues.SdkPlatformNotFoundException: Module: 'app' platform 'android-29' not found。
    解决方案：请在 Android Studio 中找到 SDK Manager，在 Appearance & Behavior > System Settings > Android SDK > SDK Platforms 里面勾选缺少的 Android 版本，点击 ok 按钮然后等待下载完成，完成后重启 Android Studio。

  3. 快速开始 Demo 跑通后，两个测试设备距离较近会产生啸叫。
    原因：通信两端的设备在同一房间内，且处于公放状态，连环增益大于 1 时会产生近场啸叫，与 demo 本身无关。请将各测试设备保持一定距离。

  4. Demo 运行后，出现错误弹窗。
    原因：SDK 内部遇到不可恢复的错误。错误码详情，请参看：错误码。

视频演示