在线 K 歌房概览
更新时间不可用
了解在线 K 歌房的核心能力、适用场景、接入路径和相关参考资源。
在线 K 歌房是声网面向娱乐社交场景提供的线上 K 歌解决方案。你可以基于实时音频、实时合唱、歌词同步、歌唱打分、版权曲库和房间管理能力，构建 K 歌房、语聊房 K 歌、派对房、互动直播 K 歌等业务场景。
声网提供三条接入路径。你可以根据 UI 完整度、接入速度和自定义需求选择合适方案。
UIKit 开源方案
适合希望直接使用开源 UI 和后端示例，快速搭建完整 K 歌房体验的团队。
场景化 API 方案
适合需要基于场景化 API 快速实现独唱、合唱、大合唱、抢唱和接唱等玩法的团队。
PaaS 方案
适合需要深度自定义业务流程、UI 和服务端逻辑，并直接组合底层能力的团队。
如何选择
| 接入路径 | 适用情况 | 你需要关注 |
|---|---|---|
| UIKit 开源方案 | 想快速上线完整 K 歌房，复用开源 UI、房间管理和常见互动流程 | 示例项目配置、后端服务部署、UI 和业务流程定制 |
| 场景化 API 方案 | 想快速接入典型 K 歌玩法，同时保留一定业务定制空间 | 场景化 API、玩法实现、版权音乐、歌词打分和 Token 鉴权 |
| PaaS 方案 | 已有较完整的业务系统，需要自行设计 UI、房间状态和服务端逻辑 | RTC 能力组合、内容中心、歌词组件、音效和业务状态同步 |
技术架构
在线 K 歌房的整体架构取决于你选择的接入路径。三种方案都围绕实时音频和歌曲内容展开，但 UI、玩法逻辑、房间状态和服务端能力的归属不同。
UIKit 开源方案
应用层集成 AUIKaraoke，场景组装层使用 AScenesKit，基础层使用 AUIKit。AUIKit 提供 UI、Service，以及房间、实时消息等 Manager，适合快速搭建完整 K 歌房并在源码基础上定制。详见 UIKit 架构说明。
场景化 API 方案
场景化 API 方案由实时互动 SDK、K 歌场景化 API、声网内容中心和歌词组件共同组成。RTC 频道负责音频发布与订阅，场景化 API 负责歌曲播放、角色切换和歌词进度同步，业务服务负责房间和麦位状态。独唱和合唱的频道与角色流程详见 独唱实现 和 合唱实现。
PaaS 方案
PaaS 方案直接组合实时互动 SDK、声网内容中心和歌词组件，房间、麦位、用户状态及 UI 由业务侧自行实现。该方案适合已有业务系统、需要深度定制 K 歌流程和服务端逻辑的团队，架构图和产品职责详见 PaaS 方案介绍，主唱、合唱者和听众的实现流程详见 PaaS 快速集成。
核心能力
- 实时音频互动：支持房主、主唱、合唱者和听众在房间内低延时互动。
- 多种 K 歌玩法：支持独唱、合唱、大合唱、抢唱、接唱等常见娱乐场景。
- 歌词与打分：支持歌词同步显示、演唱评分和歌词组件自定义。
- 版权曲库：可结合声网内容中心获取歌曲、歌词、专辑封面等内容。
- 房间与麦位管理：支持点歌、排麦、上麦、下麦、角色切换和房间状态管理。
- 音效与耳返：支持美声、音效、原唱/伴奏切换和低延时耳返。
阅读路径
如果你想先跑通完整体验，请从 UIKit 开源方案快速开始开始。如果你已经明确要接入某种 K 歌玩法，请进入 场景化 API 方案。如果你需要完全自定义实现，请阅读 PaaS 方案。