网易云信为您提供开源的示例项目，您可以参考本文档快速跑通示例项目，体验语聊房效果。

前提条件

在开始运行示例项目之前，请确保您已完成以下操作：

• 已创建应用并获取 App Key
• 已开通IM 即时通讯、聊天室、音视频通话2.0 和 NERoom 房间组件
• 已开通统一登录功能，具体请联系网易云信商务经理。

开发环境

在开始运行示例项目之前，请确保开发环境满足以下要求：

环境要求	说明
JDK 版本	1.8.0 及以上版本
Android API 版本	API 21 及以上版本
Android Studio 版本	Android Studio 5.0 及以上版本
CPU架构	ARM 64、ARM V7
IDE	Android Studio
其他	依赖 Androidx，不支持 support 库。 Android 系统 4.3 及以上版本的真机。

注意事项

示例项目需要在 RTC 调试模式下使用，此时无需传入 Token。修改鉴权方式的方法请参见 Token 鉴权 。

您可以在集成开发阶段使用调试模式进行应用开发与测试。但是出于安全考虑，应用正式上线前，请在控制台中将指定应用的鉴权方式改回安全模式。

运行示例源码

语聊房的示例源码仅供开发者接入参考，实际应用开发场景中，请结合具体业务需求修改使用。

若您计划将源码用于生产环境，请确保应用正式上线前已经过全面测试，以免因兼容性等问题造成损失。

1. 克隆语聊房示例项目源码（基于语聊房组件）仓库至您本地工程。

2. 开启 Android 设备的开发者选项，通过 USB 连接线将 Android 设备接入电脑。

3. 通过 Android Studio 打开项目，配置应用的 App Key。

   在 app\src\main\java\com\netease\yunxin\app\voiceroom\config\AppConfig.java 文件中配置应用的 App Key。

   // 请填写您的appKey,如果您的APP是国内环境，请填写APP_KEY_MAINLAND，如果是海外环境，请填写APP_KEY_OVERSEA
   private static final String APP_KEY_MAINLAND = "your mainland appKey"; // 国内用户填写
   private static final String APP_KEY_OVERSEA = "your oversea appKey";// 海外用户填写
   

4. 在 Android Studio 中，单击 Sync Project with Gradle Files 按钮，同步工程依赖。

5. 选中设备直接运行，即可体验 Demo。

建议在真机上运行，不支持模拟器调试。

示例项目结构

基于语聊房组件（voiceroomkit）的示例项目源码结构说明如下：

模块	描述
voiceroomkit-sample	App 壳工程，首页、房间列表等UI
voiceroomkit-ui	语聊房业务 UI 组件
listentogetherkit	一起听业务组件
listentogetherkit-ui	一起听业务 UI 组件
ordersong	点歌台功能

voiceroomkit-ui 重点类：
AnchorActivity.java         # 语聊房主播端界面
AudienceActivity.java       # 语聊房观众端界面
SeatAdapter.java            # 语聊房麦位适配器
VoiceRoomViewModel.java     # 语聊房ViewModel
    
listentogetherkit-ui 重点类：
    ListenTogetherAnchorActivity.java      # 一起听功能 主播页面
    ListenTogetherAudienceActivity.java    # 一起听功能 观众页面
    ListenTogetherService    #一起听业务服务
    NEListenTogetherListener    #一起听业务监听器
    ListenTogetherViewModel #一起听ViewModel