AndroidDemo_zh - aopacloud/aopa-rtc GitHub Wiki

运行android demo

奥帕在 GitHub 上提供开源示例项目 AopaRtcAndroid 演示奥帕 RTC SDK 的 API 使用示例，以帮助开发者更好地理解和运用奥帕 SDK 的功能。

本文介绍如何快速跑通 Android 示例项目，体验实时音视频功能。

前提条件​

  • Android Studio 4.2 及以上。

  • Android API 级别 21 及以上。

  • 两台运行 Android 5.0 及以上版本的移动设备。

    注意

    奥帕推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。

  • 可以访问互联网的计算机。如果你的网络环境部署了防火墙，参考[应对防火墙限制]以正常使用奥帕服务。

  • 一个有效的奥帕账号以及奥帕项目。请参考[开通服务]从奥帕控制台获得以下信息：

    • App ID：奥帕随机生成的字符串，用于识别你的 App。
    • (可选) App 证书：奥帕提供的 App 证书，用于在服务器部署并生成 Token 或使用控制台生成临时的 Token。

操作步骤​

获取示例项目​

  1. 运行以下命令克隆仓库到本地：

    Shell

    git clone [email protected]:aopacloud/aopa-rtc.git

  2. 该仓库中包含奥帕 RTC SDK 所有 Native 平台的示例项目，其中 Android 平台的 API 使用示例位于 /Android 路径下。

    路径 描述
    /aopa-rtc/AopaRtcAndroid 奥帕视频 SDK 的 API 使用示例。

配置示例项目​

信息

本文以视频示例项目为例。如需跑通音频示例项目，参考以下步骤在音频文件夹下操作即可。

  1. 集成 SDK 并安装依赖

    /AopaRtcAndroid/app/build.gradle 文件中已添加集成 SDK 及安装依赖所需的代码，SDK 会在同步 Gradle 后自动完成集成。

  2. 设置 App ID 和 App 证书

    打开 /AopaRtcAndroid/app/src/main/res/values/string-config.xml 文件，在 YOUR APP ID 和 YOUR APP CERTIFICATE 中填入你从声网控制台获取的 App ID 和 App 证书。

    XML

    <?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <!--    奥帕 App ID    -->   
    <string name="aopa_app_id" translatable="false">YOUR APP ID</string>  
    <!--    奥帕 App 证书    注意：如果项目没有开启证书鉴权，这个字段留空。    -->    
    <string name="aopa_app_certificate" translatable="false">YOUR APP CERTIFICATE</string>  
</resources>

编译并运行示例项目​

  1. 用 Android Studio 打开 /AopaApi-Example/BanRtcDemo 文件夹。

  2. 开启 Android 设备的开发者选项，打开 USB 调试，通过 USB 连接线将 Android 设备接入电脑，并在 Android 设备选项中勾选你的 Android 设备。

  3. 在 Android Studio 中，点击 图片 (Sync Project with Gradle Files) 进行 Gradle 同步。

  4. 待同步成功后，点击 图片 (Run 'app') 开始编译。

  5. 编译成功后，你的 Android 设备上会出现 图片 (Aopa API Example) 应用。

  6. 打开 Aopa API Example 应用后，你可以任意选择你想体验的场景。以 视频互动直播 为例，输入频道名（如 test），并点击加入频道。

  7. 为更好地体验各种音视频互动场景，你可以邀请一位朋友使用另一台设备运行该示例项目（需确保 App ID 不变）。以 视频互动直播 为例，你们输入相同的频道名并加入频道后，你们会看到彼此，并听到彼此的声音。

⚠️ **GitHub.com Fallback** ⚠️