2023/12/26 18:32:32
跑通 GitHub 示例项目
本文介绍如何快速跑通 AUIVoiceRoom/Android 示例项目,体验在线语聊房。
如需更深入了解项目代码,请参考 AScenesKit 和 AUIKit。
项目技术架构
本节介绍项目的技术架构:
AUIVoiceRoom
依赖于 ASceneKit
,ASceneKit
依赖于底层的 AUIKit
。详细说明如下:
AUIVoiceRoom
:代表语聊房 App。Controller
:用于管理语聊 App 中房间列表页面和单个房间的详情页面。
AScenesKit
:为语聊场景提供业务逻辑的组装模块。VoiceChatUIKit
:负责统一调度VoiceChatRoomView
和VoiceChatRoomService
,并管理房间。VoiceChatRoomView
:语聊房的容器 View。用于管理AUIKit
提供的 UI。VoiceChatRoomService
:语聊房的 Service。用于管理AUIKit
提供的 Service。ViewBinder
:用于将VoiceChatRoomView
和VoiceChatRoomService
绑定。
AUIKit
:基础库。- UI:基础 UI 组件。
- Service:上麦、聊天、送礼物等业务能力。
前提条件
开始前,请确保前提条件如下:
-
Android Studio 4.1 及以上
-
Android 手机,版本 Android 5.0(API Level 21)及以上
注意声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
克隆仓库
在根目录下运行以下命令克隆 AUIVoiceRoom
仓库到本地:
Shell
git clone git@github.com:AgoraIO-Community/AUIVoiceRoom.git
配置示例项目
-
参考使用语聊后端服务进行部署。
-
创建
AUIVoiceRoom/Android/local.properties
文件并在该文件中设置你的后端服务 Host URL:textSERVER_HOST= "Your_Host_Url"
如果你暂时无意部署后端服务,可以使用
https://service.agora.io/uikit-voiceroom
。这是声网为测试体验提供的地址,请你不要商用。
编译并运行示例项目
-
开启 Android 设备的开发者选项,打开 USB 调试,通过 USB 连接线将 Android 设备接入电脑。
-
用 Android Studio 打开
AUIVoiceRoom/Android
文件夹。 -
在 Android Studio 中,点击 Sync Project with Gradle Files 按钮,以让项目与 Gradle 文件同步。
-
待同步成功后,点击
Run 'app'
。片刻后,语聊 App便会安装到你的 Android 设备上。 -
打开应用,即可进行体验。房主可以创建语聊房;观众可以加入语聊房。