# 接唱 (/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/relay) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). <_PlatformTabsGroup> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" /> 本文介绍如何实现歌曲接唱。在此之前,请确保你已参考[实现文档](/zh-CN/solutions/online-ktv/ktv-scenario/get-started/integrate-ktvapi)集成 KTV API。 ## 方案介绍 [#方案介绍] 接唱是一种音乐游戏玩法,玩家在每轮游戏中通过接唱歌曲来保持音乐的连贯性。游戏开始时播放歌曲,房间内参与游戏的人轮流接力演唱歌曲,其余玩家作为听众。接唱强调玩家间音乐的流畅连接,是一种富有娱乐性的音乐互动体验。 默认情况下,由房主或指定的用户播放歌曲并发起演唱,其他参与游戏的人轮流进行接唱,不参与游戏的人为听众。 接唱场景下存在三种角色: - **主唱**:默认为房主,也可以是指定的用户,负责播放音乐并发起演唱,实现逻辑等同于**合唱场景中的主唱**:主唱需要加入主频道,加载并播放歌曲,发布麦克风采集的音频流。此外,主唱还需要加入合唱子频道将人声同步给其他伴唱。 - **伴唱**:房间内其他参与接唱游戏的人。实现逻辑等同于**合唱场景中的伴唱**:伴唱需要加入合唱子频道,加载并播放歌曲,发布麦克风采集的音频流。 - **听众**:房间内不参与接唱游戏的人为听众。听众需要加入主频道,加载歌词。KTV API 模块内部控制听众订阅独唱者的人声和音乐的音频合流,同步独唱者的音乐播放进度,让歌词组件进入歌词滚动状态等逻辑。如果听众需要上麦聊天,可以更新媒体选项。 下图为接唱方案的技术原理图: ## 接唱实现 [#接唱实现] 与[合唱方案](/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/chorus)相比,接唱方案中仅需在 `KTVApiConfig` 中将 `KTVType` 设为 `SingRelay`(接唱场景),因此,你可以参考合唱方案来实现主唱和听众的逻辑。当轮到某位伴唱演唱时,该伴唱调用 `muteMic(false)` 打开麦克风进行演唱,其他伴唱调用 `muteMic(true)` 关闭麦克风即可。 ## API 参考 [#api-参考] 本文集成步骤中使用如下 API: - [K 歌房场景化 API](/zh-CN/api-reference/online-ktv) - [实时互动 API](/zh-CN/api-reference/online-ktv) ## 相关文档 [#相关文档] - [快速集成 KTV API](/zh-CN/solutions/online-ktv/ktv-scenario/get-started/integrate-ktvapi) - [合唱方案](/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/chorus) - [歌词打分组件](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/lyrics-scoring) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" /> 本文介绍如何实现歌曲接唱。在此之前,请确保你已参考[实现文档](/zh-CN/solutions/online-ktv/ktv-scenario/get-started/integrate-ktvapi)集成 KTV API。 ## 方案介绍 [#方案介绍-1] 接唱是一种音乐游戏玩法,玩家在每轮游戏中通过接唱歌曲来保持音乐的连贯性。游戏开始时播放歌曲,房间内参与游戏的人轮流接力演唱歌曲,其余玩家作为听众。接唱强调玩家间音乐的流畅连接,是一种富有娱乐性的音乐互动体验。 默认情况下,由房主或指定的用户播放歌曲并发起演唱,其他参与游戏的人轮流进行接唱,不参与游戏的人为听众。 接唱场景下存在三种角色: - **主唱**:默认为房主,也可以是指定的用户,负责播放音乐并发起演唱,实现逻辑等同于**合唱场景中的主唱**:主唱需要加入主频道,加载并播放歌曲,发布麦克风采集的音频流。此外,主唱还需要加入合唱子频道将人声同步给其他伴唱。 - **伴唱**:房间内其他参与接唱游戏的人。实现逻辑等同于**合唱场景中的伴唱**:伴唱需要加入合唱子频道,加载并播放歌曲,发布麦克风采集的音频流。 - **听众**:房间内不参与接唱游戏的人为听众。听众需要加入主频道,加载歌词。KTV API 模块内部控制听众订阅独唱者的人声和音乐的音频合流,同步独唱者的音乐播放进度,让歌词组件进入歌词滚动状态等逻辑。如果听众需要上麦聊天,可以更新媒体选项。 下图为接唱方案的技术原理图: ## 接唱实现 [#接唱实现-1] 与[合唱方案](/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/chorus)相比,接唱方案中仅需在 `KTVApiConfig` 中将 `KTVType` 设为 `SingRelay`(接唱场景),因此,你可以参考合唱方案来实现主唱和听众的逻辑。当轮到某位伴唱演唱时,该伴唱调用 `muteMic(false)` 打开麦克风进行演唱,其他伴唱调用 `muteMic(true)` 关闭麦克风即可。 ## API 参考 [#api-参考-1] 本文集成步骤中使用如下 API: - [K 歌房场景化 API](/zh-CN/api-reference/online-ktv) ## 相关文档 [#相关文档-1] - [快速集成 KTV API](/zh-CN/solutions/online-ktv/ktv-scenario/get-started/integrate-ktvapi) - [合唱方案](/zh-CN/solutions/online-ktv/ktv-scenario/build/implementation/chorus) - [歌词打分组件](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/lyrics-scoring) <_PlatformProcessedMarker close="true" />