2024/05/11 17:12:45
跑通示例项目
声网在 GitHub 上提供一个开源的 AUIKaraoke 示例项目。本文介绍如何快速跑通该示例项目,体验在线 K 歌场景。
前提条件
-
Android API Level 24 及以上
-
Android Studio 3.5 及以上
-
Android 设备,版本 Android 7.0 及以上
-
Java Development Kit 17 及以上
信息- 声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
- 本 Demo 使用的 Java Development Kit 版本为 17,gradle 版本为 7.2。如果你编译失败,请修改编译使用的 Java Development Kit 或 gradle 版本。
操作步骤
获取示例项目
运行以下命令克隆仓库到本地:
Shell
git clone git@github.com:AgoraIO-Community/AUIKaraoke.git
配置示例项目
参考开通服务获取你的声网项目的 App ID、证书,以及环信项目的 APPKEY、Client ID 以及 Client Secret,参考部署后端服务获取你的项目的后端服务的 Host URL,然后将上述信息填入项目的 local.peoperties
文件。
信息
你也可以使用声网提供的测试域名 https://service.shengwang.cn/uikit-v2 来快速体验,但请勿用于正式生产环境中。
properties
SERVER_HOST=<=你的后端服务域名=>
AGORA_APP_ID=<=你的声网 AppID=>
AGORA_APP_CERT=<=你的声网 App 证书=>
IM_APP_KEY=<=你的环信 APPKEY=>
IM_CLIENT_ID=<=你的环信 Client ID=>
IM_CLIENT_SECRET=<=你的环信 Client Secret=>
编译并运行示例项目
-
开启 Android 设备的开发者选项,打开 USB 调试,通过 USB 连接线将 Android 设备接入电脑,并在 Android 设备选项中勾选你的 Android 设备。
-
在 Android Studio 中,点击 Sync Project with Gradle Files 按钮,以让项目与 Gradle 文件同步。
-
待同步成功后,点击 开始编译。
-
编译成功后,你的 Android 设备上会出现 AUIKaraoke app。
-
打开 app,点击创建房间即可开始体验在线 K 歌。