You need to enable JavaScript to run this app.
导航

Android

最近更新时间2024.01.23 20:01:38

首次发布时间2021.09.23 13:17:33

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

应用使用说明

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

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

前提条件
  • 根据 开通服务 获取的 AppID 和临时 Token

  • Android Studio 3.0+

  • Android 设备

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

操作步骤

步骤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。

  2. 使用模拟器调试时出现花屏?

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

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

  5. 更多关于 Android 平台上集成 RTC SDK 的问题,参看 Android 集成常见问题

视频演示