# 跑通示例项目 (/zh-CN/solutions/chatroom/uikit/build/run-github-project/android) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何快速跑通如下示例项目,体验在线语聊房。如需更深入了解项目代码,请参考如下示例项目: ## 项目技术架构 [#项目技术架构] 本节介绍项目的技术架构: ![架构图](https://web-cdn.agora.io/docs-portal/img/chatroom/uivoice_architecture_android.png) `AUIVoiceRoom` 依赖于 `ASceneKit`,`ASceneKit` 依赖于底层的 `AUIKit`。详细说明如下: - `AUIVoiceRoom`:代表语聊房 App。该部分需要你自行开发维护。 - `Activity`:用于管理语聊 App 中房间列表页面和单个房间的详情页面。 - `VoiceChatUIKit`:负责统一调度 `VoiceChatRoomView` 和 `VoiceChatRoomService`,并管理房间。 - `AScenesKit`:为语聊场景提供业务逻辑的组装模块。该部分由声网提供并维护。 - `VoiceChatRoomView`:语聊房的容器 View。用于管理 `AUIKit` 提供的 UI。 - `VoiceChatRoomService`:语聊房的 Service。用于管理 `AUIKit` 提供的 Service。 - `ViewBinder`:用于将 `VoiceChatRoomView` 和 `VoiceChatRoomService` 绑定。 - `AUIKit`:基础库。该部分由声网提供并维护。 - UI:基础 UI 组件。 - Manager:管理环信即时通讯 IM(`AUIChatManager`)、实时消息 RTM(`AUIRtmManager`)、房间(`AUIRoomManager`)等模块。 - Service:上麦、聊天、送礼物等业务能力。 ## 前提条件 [#前提条件] 开始前,请确保满足以下前提条件: - [开通语聊房 UIKit 相关服务](/zh-CN/solutions/chatroom/uikit/build/enable-service) - [Git](https://git-scm.com/downloads) - [Java Development Kit](https://www.oracle.com/java/technologies/javase-downloads.html) - [Android Studio](https://developer.android.com/studio/) 4.1 及以上 - Android 手机,版本 Android 5.0(API Level 21)及以上 :::warning[注意] 声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。 ::: ## 克隆仓库 [#克隆仓库] 在根目录下运行以下命令克隆 `AUIVoiceRoom` 仓库到本地: ```shell git clone git@github.com:AgoraIO-Community/AUIVoiceRoom.git ``` ## 配置示例项目 [#配置示例项目] 1. (可选)参考[使用语聊后端服务](/zh-CN/solutions/chatroom/uikit/build/run-github-project-backend)进行部署。 2. 创建 `AUIVoiceRoom/Android/local.properties` 文件并在该文件中设置如下参数: ```text SERVER_HOST= AGORA_APP_ID= AGORA_APP_CERT= AGORA_BASIC_AUTH= IM_APP_KEY= IM_CLIENT_ID= IM_CLIENT_SECRET= ``` | 参数名 | 参数描述 | |------------------|----------------------------------| | `SERVER_HOST` | 语聊后端服务的 Host URL。如果你暂时无意部署后端服务,可以使用 `https://service.shengwang.cn/uikit-v2` 作为 Host URL。这是声网为测试体验提供的地址,请你不要商用。 | | `AGORA_APP_ID` | 声网项目的 App ID,详见[获取 App ID](/zh-CN/solutions/chatroom/uikit/build/enable-service#获取-app-id)。 | | `AGORA_APP_CERT` | 声网项目的 App 证书,详见[获取 App 证书](/zh-CN/solutions/chatroom/uikit/build/enable-service#获取-app-证书)。 | | `AGORA_BASIC_AUTH` | 声网 RESTful 服务所需的 HTTP 基本认证的 `Authorization` 值。请先获取[客户 ID 和客户密钥](/zh-CN/solutions/chatroom/uikit/build/enable-service#获取客户-id-和客户密钥),再生成 [HTTP 基本认证](/zh-CN/realtime-media/rtc/build/setup-and-access/http-basic-auth)的 `Authorization` 值。 | | `IM_APP_KEY` | 环信 IM 服务的 App Key,详见[获取 IM 信息](https://doc.easemob.com/product/console/app_manage.html)。 | | `IM_CLIENT_ID` | 环信 IM 服务的 Client ID。登录[环信管理后台](https://console.easemob.com/user/login),到**应用列表** > **查看**获取。 | | `IM_CLIENT_SECRET` | 环信 IM 服务的 Client Secret。登录[环信管理后台](https://console.easemob.com/user/login),到**应用列表** > **查看**获取。 | ## 编译并运行示例项目 [#编译并运行示例项目] 1. 开启 Android 设备的开发者选项,打开 USB 调试,通过 USB 连接线将 Android 设备接入电脑。 2. 用 Android Studio 打开 `AUIVoiceRoom/Android` 文件夹。 3. 在 Android Studio 中,点击 **Sync Project with Gradle Files** 按钮,以让项目与 Gradle 文件同步。 4. 待同步成功后,点击 `Run 'app'`。片刻后,语聊 App 便会安装到你的 Android 设备上。 5. 打开应用,即可进行体验。房主可以创建语聊房;观众可以加入语聊房。