# 跑通示例项目 (/zh-CN/solutions/one-to-one-live/rtm/get-started/run-example/android)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
声网在 `agora-ent-scenarios` 仓库中提供 1v1 私密房和秀场转 1v1 的源代码供你参考。本文介绍如何快速跑通该示例项目,体验直播效果。
## 前提条件 [#前提条件]
开始前,请确保满足如下前提条件:
- 参考[开通一对一直播服务](/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service)在控制台创建项目,获取 App ID 和 App 证书,并[开通项目的 RTM 服务权限](/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service#开通-rtm-服务权限)
- [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[注意]
声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
:::
## 克隆仓库 [#克隆仓库]
运行以下命令克隆仓库到本地:
```shell
git clone git@github.com:AgoraIO-Usecase/agora-ent-scenarios.git
```
## 配置示例项目 [#配置示例项目]
运行项目前,你需要在 `/agora-ent-scenarios/Android/gradle.properties` 文件中设置如下参数:
```kotlin
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
```
你可以在[创建声网项目](/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service#创建声网项目)后,从控制台获取这些参数的值,详情如下:
| 参数 | 描述 | 获取方式 |
|----|----|----|
| `AGORA_APP_ID` | 声网项目的 App ID | [获取 App ID](/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service#获取-app-id) |
| `AGORA_APP_CERTIFICATE` | 声网项目的 App 证书 |[获取 App 证书](/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service#获取-app-证书) |
## 编译并运行示例项目 [#编译并运行示例项目]
按照如下步骤进行操作:
:::warning[注意]
声网 1v1 私密房和秀场转 1v1 示例项目基于 RTC 和 RTM SDK 开发。运行前请确保你的项目已[开通 RTM 服务权限](/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service#开通-rtm-服务权限)。
:::
1. 开启 Android 设备的开发者选项,打开 USB 调试,通过 USB 连接线将 Android 设备接入电脑。
2. 用 **Android Studio** 打开 `agora-ent-scenarios/Android` 文件夹。
3. 在 **Android Studio** 中,点击 **Sync Project with Gradle Files** 按钮,以让项目与 Gradle 文件同步。
4. 待同步成功后,点击 `Run 'app'`。片刻后,**声动互娱**应用便会安装到你的 Android 设备上。
5. 打开**声动互娱**应用,点击 **1v1私密房**或**秀场转 1v1 私密房**,即可进行体验。
:::warning[注意]
你需要在两个客户端都打开**声动互娱**,且都选择 **1v1 私密房**或**秀场直播转 1v1 私密房**才能进行互动体验。
:::