# 在线 K 歌房概览 (/zh-CN/solutions/online-ktv)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

在线 K 歌房是声网面向娱乐社交场景提供的线上 K 歌解决方案。你可以基于实时音频、实时合唱、歌词同步、歌唱打分、版权曲库和房间管理能力，构建 K 歌房、语聊房 K 歌、派对房、互动直播 K 歌等业务场景。

声网提供三条接入路径。你可以根据 UI 完整度、接入速度和自定义需求选择合适方案。

<Cards>
  <Card
    title="UIKit 开源方案"
    href="/zh-CN/solutions/online-ktv/auikaraoke"
    description="适合希望直接使用开源 UI 和后端示例，快速搭建完整 K 歌房体验的团队。"
  />
  <Card
    title="场景化 API 方案"
    href="/zh-CN/solutions/online-ktv/ktv-scenario"
    description="适合需要基于场景化 API 快速实现独唱、合唱、大合唱、抢唱和接唱等玩法的团队。"
  />
  <Card
    title="PaaS 方案"
    href="/zh-CN/solutions/online-ktv/online-ktv-sdk"
    description="适合需要深度自定义业务流程、UI 和服务端逻辑，并直接组合底层能力的团队。"
  />
</Cards>

## 如何选择 [#如何选择]

| 接入路径 | 适用情况 | 你需要关注 |
| --- | --- | --- |
| UIKit 开源方案 | 想快速上线完整 K 歌房，复用开源 UI、房间管理和常见互动流程 | 示例项目配置、后端服务部署、UI 和业务流程定制 |
| 场景化 API 方案 | 想快速接入典型 K 歌玩法，同时保留一定业务定制空间 | 场景化 API、玩法实现、版权音乐、歌词打分和 Token 鉴权 |
| PaaS 方案 | 已有较完整的业务系统，需要自行设计 UI、房间状态和服务端逻辑 | RTC 能力组合、内容中心、歌词组件、音效和业务状态同步 |

## 技术架构 [#技术架构]

在线 K 歌房的整体架构取决于你选择的接入路径。三种方案都围绕实时音频和歌曲内容展开，但 UI、玩法逻辑、房间状态和服务端能力的归属不同。

### UIKit 开源方案 [#uikit-开源方案]

应用层集成 AUIKaraoke，场景组装层使用 AScenesKit，基础层使用 AUIKit。AUIKit 提供 UI、Service，以及房间、实时消息等 Manager，适合快速搭建完整 K 歌房并在源码基础上定制。详见 [UIKit 架构说明](/zh-CN/solutions/online-ktv/auikaraoke/build/manage-karaoke/uikitkaraoke)。

### 场景化 API 方案 [#场景化-api-方案]

场景化 API 方案由实时互动 SDK、K 歌场景化 API、声网内容中心和歌词组件共同组成。RTC 频道负责音频发布与订阅，场景化 API 负责歌曲播放、角色切换和歌词进度同步，业务服务负责房间和麦位状态。独唱和合唱的频道与角色流程详见 [独唱实现](/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/solo) 和 [合唱实现](/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/chorus)。

### PaaS 方案 [#paas-方案]

PaaS 方案直接组合实时互动 SDK、声网内容中心和歌词组件，房间、麦位、用户状态及 UI 由业务侧自行实现。该方案适合已有业务系统、需要深度定制 K 歌流程和服务端逻辑的团队，架构图和产品职责详见 [PaaS 方案介绍](/zh-CN/solutions/online-ktv/online-ktv-sdk)，主唱、合唱者和听众的实现流程详见 [PaaS 快速集成](/zh-CN/solutions/online-ktv/online-ktv-sdk/get-started/karaoke)。

## 核心能力 [#核心能力]

- **实时音频互动**：支持房主、主唱、合唱者和听众在房间内低延时互动。
- **多种 K 歌玩法**：支持独唱、合唱、大合唱、抢唱、接唱等常见娱乐场景。
- **歌词与打分**：支持歌词同步显示、演唱评分和歌词组件自定义。
- **版权曲库**：可结合声网内容中心获取歌曲、歌词、专辑封面等内容。
- **房间与麦位管理**：支持点歌、排麦、上麦、下麦、角色切换和房间状态管理。
- **音效与耳返**：支持美声、音效、原唱/伴奏切换和低延时耳返。

## 阅读路径 [#阅读路径]

如果你想先跑通完整体验，请从 [UIKit 开源方案快速开始](/zh-CN/solutions/online-ktv/auikaraoke/get-started/integrate)开始。如果你已经明确要接入某种 K 歌玩法，请进入 [场景化 API 方案](/zh-CN/solutions/online-ktv/ktv-scenario)。如果你需要完全自定义实现，请阅读 [PaaS 方案](/zh-CN/solutions/online-ktv/online-ktv-sdk)。