# 跑通示例项目 (/zh-CN/solutions/showroom/get-started/run-example/android) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何快速跑通 `agora-ent-scenarios` 示例项目,体验带美颜效果的秀场直播。 ## 前提条件 [#前提条件] 开始前,请确保满足以下前提条件: - [开通秀场直播服务](/zh-CN/solutions/showroom/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[注意] 声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。 ::: ## 克隆仓库 [#克隆仓库] 运行以下命令克隆仓库到本地: ```shell git clone git@github.com:AgoraIO-Usecase/agora-ent-scenarios.git ``` ## 集成商汤美颜 SDK [#集成商汤美颜-sdk] 按照如下步骤进行集成: 1. 联系商汤技术支持获取最新的美颜 SDK 和测试证书。美颜 SDK 中包含 Android 和 iOS SDK。 2. 下载并解压美颜 SDK,然后将 SDK 中如下文件添加到秀场直播示例项目对应的文件路径下: | 用途 | SDK 文件 | 项目路径 | | --- | --- | --- | | 基础美颜 | `Android/aar/STMobileJNI-release.aar` | `Android/scenes/show/aars/STMobileJNI/` | | 基础美颜 | `Android/smaple/SenseMeEffects/app/libs/SenseArSourceManager-release.aar` | `Android/scenes/show/aars/SenseArSourceManager` | | 基础美颜 | `Android/models` | `Android/scenes/show/src/main/assets/` | | 贴纸 | `Android/smaple/SenseMeEffects/app/src/main/assets/sticker_face_shape` | `Android/scenes/show/src/main/assets/` | | 风格妆 | `Android/smaple/SenseMeEffects/app/src/main/assets/style_lightly` | `Android/scenes/show/src/main/assets/` | | 证书 | `SenseME.lic` | `Android/scenes/show/src/main/assets/license/SenseME.lic` | 3. 在项目的 `build.gradle` 文件中,将 `applicationId` 修改为你的包名,例如 `com.example.app`。包名用于在设备上唯一标识应用程序。在开发应用时,你需要设置包名。在此处设置的包名需要与你申请 SDK 时提供的包名一致。 ```kotlin android { defaultConfig { applicationId "io.agora.entfull" ndk.abiFilters 'arm64-v8a', 'armeabi-v7a'//, 'arm64-v8a'//, 'x86', 'x86-64' } } ``` ## 配置示例项目 [#配置示例项目] 按照如下步骤进行配置: 1. 运行秀场直播项目前,你需要在 `gradle.properties` 文件中设置如下参数: ```kotlin AGORA_APP_ID= AGORA_APP_CERTIFICATE= CLOUD_PLAYER_KEY= CLOUD_PLAYER_SECRET= ``` 你可以在[创建声网项目](/zh-CN/solutions/showroom/build/enable-service#创建声网项目)后,从控制台获取这些参数的值,详情如下: | 参数 | 描述 | 获取方式 | |----|----|----| | `AGORA_APP_ID` | 声网项目的 App ID | [获取 App ID](/zh-CN/solutions/showroom/build/enable-service#获取-app-id) | | `AGORA_APP_CERTIFICATE` | 声网项目的 App 证书 |[获取 App 证书](/zh-CN/solutions/showroom/build/enable-service#获取-app-证书) | | `CLOUD_PLAYER_KEY` | 声网输入在线媒体流 RESTful 服务所需的客户 ID | [获取客户 ID 和密钥](/zh-CN/solutions/showroom/build/enable-service#获取客户-id-与客户密钥) | | `CLOUD_PLAYER_SECRET` | 声网输入在线媒体流 RESTful 服务所需的客户密钥 | [获取客户 ID 和密钥](/zh-CN/solutions/showroom/build/enable-service#获取客户-id-与客户密钥) | 2. `agora-ent-scenarios` 项目中包含在线 K 歌房、语聊房、语聊房(空间音频版)、秀场直播等模块,因此,运行秀场直播时,你可以在 `settings.gradle` 文件中注释掉其他模块。 ```kotlin // 注释掉与秀场直播无关的 module // if (!isKTVEmpty) { // include ':scenes:ktv' // } // if (!isVoiceEmpty) { // include ':scenes:voice' // include ':scenes:voice:common' // } // if (!isSpatialVoiceEmpty) { // include ':scenes:voice_spatial' // include ':scenes:voice_spatial:common' // } if(!isShowEmpty){ include ':scenes:show' include ':scenes:show:aars:SenseArSourceManager' include ':scenes:show:aars:STMobileJNI' } ``` ## 编译并运行示例项目 [#编译并运行示例项目] 按照如下步骤进行操作: 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. 打开**声动互娱**应用,点击**秀场直播**,即可进行体验。主播可以创建房间;观众可以加入房间。 ![](https://web-cdn.agora.io/docs-files/1684826793571)