K 歌房场景化 Kotlin API

本文提供在线 K 歌房场景定制化 Kotlin API。你可以在 GitHub 上查看源码文件 KTVApi.kt 和 KTVApiImpl.kt。

KTVApiCopy Anchor Link

该类提供实现 K 歌场景的核心方法。

createKTVApiCopy Anchor Link

fun createKTVApi(config: KTVApiConfig): KTVApi = KTVApiImpl(config)

创建并初始化 KTV API 实例。调用该方法可以初始化 KTV API 模块内部变量和缓存数据，并注册相应的回调监听。

参数Copy Anchor Link

• config：初始化配置，详见 KTVApiConfig。

createKTVGiantChorusApiCopy Anchor Link

fun createKTVGiantChorusApi(config: KTVGiantChorusApiConfig): KTVApi = KTVGiantChorusApiImpl(config)

创建并初始化大合唱场景的 KTV API 实例。调用该方法可以初始化 KTV API 模块内部变量和缓存数据，并注册相应的回调监听。

参数Copy Anchor Link

• config：初始化配置，详见 KTVGiantChorusApiConfig。

releaseCopy Anchor Link

fun release()

释放 KTV API 资源。

调用该方法可以清空 KTV API 模块内部变量和缓存数据，取消 ktvApiEventHandler 的事件监听，取消网络请求等。

renewTokenCopy Anchor Link

fun renewToken(
    rtmToken: String,
    chorusChannelRtcToken: String
)

更新 Token。

当你收到 onTokenPrivilegeWillExpire 回调报告 Token 即将过期时，需要主动调用此方法更新 Token。

参数Copy Anchor Link

• rtmToken：用于音乐内容中心鉴权的 RTM Token，详见 部署 RTM Token 服务器。
• chorusChannelRtcToken：加入合唱子频道的 Token。在合唱场景下，领唱需要加入两个频道，加入主频道发布人声和播放器的混流，加入合唱子频道发布麦克风采集的音频流，伴唱需要加入合唱子频道来同步领唱的人声。

addEventHandlerCopy Anchor Link

fun addEventHandler(ktvApiEventHandler: IKTVApiEventHandler)

注册 KTV API 事件。你可以多次调用该方法注册多个事件回调。

参数Copy Anchor Link

• ktvApiEventHandler：KTV API 的事件句柄，详见 IKTVApiEventHandler。

removeEventHandlerCopy Anchor Link

fun removeEventHandler(ktvApiEventHandler: IKTVApiEventHandler)

取消注册 KTV API 事件。

参数Copy Anchor Link

• ktvApiEventHandler：KTV API 的事件句柄，详见 IKTVApiEventHandler。

fetchMusicChartsCopy Anchor Link

fun fetchMusicCharts(
    onMusicChartResultListener: (
        requestId: String?,
        status: Int,
        list: Array<out MusicChartInfo>?
    ) -> Unit
)

获取歌曲榜单。

该方法用于获取各类歌曲榜单，并提供一个回调函数用于处理异步调用的结果。

参数Copy Anchor Link

• onMusicChartResultListener：歌曲榜单列表回调，包含以下参数：
  • requestId：请求 ID。本次请求的唯一标识。
  • status：请求状态。
    • 0：请求成功。
    • 1：一般错误，无明确归因。
    • 2：网关异常。可能的原因有：
      • 当前使用的 Token 已过期。请重新生成 Token。
      • 传入的 Token 无效。请确保你使用的是 RTM Token。
      • 网络错误。请检查你的网络。
    • 3：权限错误或歌曲不存在。请确保你的项目已开通声网音乐内容中心权限。
    • 4：内部数据解析错误。
    • 5：歌曲加载时出错。
    • 6：歌曲解密时出错。
  • list：MusicChartInfo 对象数组，包含歌曲榜单信息。

searchMusicByMusicChartIdCopy Anchor Link

fun searchMusicByMusicChartId(
    musicChartId: Int,
    page: Int,
    pageSize: Int,
    jsonOption: String,
    onMusicCollectionResultListener: (
        requestId: String?,
        status: Int,
        page: Int,
        pageSize: Int,
        total: Int,
        list: Array<out Music>?
    ) -> Unit
)

通过歌曲榜单的 ID 获取指定榜单的歌曲资源列表。

当你调用 fetchMusicCharts 获取歌曲榜单 ID 之后，可以通过此方法来检索对应的歌曲资源列表。此方法提供一个回调函数用于处理异步调用的结果。

参数Copy Anchor Link

• musicChartId：歌曲榜单 ID，可通过 fetchMusicCharts 获取。

• page：当前页面编号，默认从 1 开始。

• pageSize：每页所展示的音乐资源的最大数量，最大值为 50。

• jsonOption：扩展 JSON 字段，默认为 NULL。你可以通过该字段来筛选出你需要的音乐资源，目前支持筛选可打分的音乐资源及音乐资源的副歌片段：

  Key 值	Value 值	示例
  pitchType	是否支持打分： 1：支持打分的音乐资源。 2：不支持打分的音乐资源。	{"pitchType": 1}
  needHighPart	是否需要副歌片段资源： true：需要副歌片段资源。 false：不需要副歌片段资源。	{"needHighPart": true}

  表格内容超出当前宽度，可横向滚动查看更多列。

• onMusicCollectionResultListener：获取歌曲资源列表回调，包含以下参数：

  • requestId：请求 ID。本次请求的唯一标识。
  • status：请求状态。
    • 0：请求成功。
    • 1：一般错误，无明确归因。
    • 2：网关异常。可能的原因有：
      • 当前使用的 Token 已过期。请重新生成 Token。
      • 传入的 Token 无效。请确保你使用的是 RTM Token。
      • 网络错误。请检查你的网络。
    • 3：权限错误或歌曲不存在。请确保你的项目已开通声网音乐内容中心权限。
    • 4：内部数据解析错误。
    • 5：歌曲加载时出错。
    • 6：歌曲解密时出错。
  • page：当前页面编号，默认从 1 开始。
  • pageSize：当前歌曲资源列表的总页面数量，最大值为 50。
  • total：列表内歌曲资源的总数量。
  • list：Music 对象数组，包含歌曲的详细信息。

searchMusicByKeywordCopy Anchor Link

fun searchMusicByKeyword(
        keyword: String,
        page: Int,
        pageSize: Int,
        jsonOption: String,
        onMusicCollectionResultListener: (
            requestId: String?,
            status: Int,
            page: Int,
            pageSize: Int,
            total: Int,
            list: Array<out Music>?
        ) -> Unit
    )

通过关键词搜索歌曲。

此方法提供一个回调函数用于处理异步调用的结果。

参数Copy Anchor Link

• keyword：搜索关键词，支持歌曲名、歌手搜索。

• page：想要获取的音乐资源列表的目标页编号。

• pageSize：每页所展示的音乐资源的最大数量，最大值为 50。

• jsonOption：扩展 JSON 字段，默认为 NULL。你可以通过该字段来筛选出你需要的音乐资源，目前支持筛选可打分的音乐资源及音乐资源的副歌片段：

  Key 值	Value 值	示例
  pitchType	是否支持打分： 1：支持打分的音乐资源。 2：不支持打分的音乐资源。	{"pitchType": 1}
  needHighPart	是否需要副歌片段资源： true：需要副歌片段资源。 false：不需要副歌片段资源。	{"needHighPart": true}

  表格内容超出当前宽度，可横向滚动查看更多列。

• onMusicCollectionResultListener：获取歌曲资源列表回调，包含以下参数：

  • requestId：请求 ID。本次请求的唯一标识。
  • status：请求状态。
    • 0：请求成功。
    • 1：一般错误，无明确归因。
    • 2：网关异常。可能的原因有：
      • 当前使用的 Token 已过期。请重新生成 Token。
      • 传入的 Token 无效。请确保你使用的是 RTM Token。
      • 网络错误。请检查你的网络。
    • 3：权限错误或歌曲不存在。请确保你的项目已开通声网音乐内容中心权限。
    • 4：内部数据解析错误。

loadMusic[1/2]Copy Anchor Link

fun loadMusic(
    songCode: Long,
    config: KTVLoadMusicConfiguration,
    musicLoadStateListener: IMusicLoadStateListener
)

通过歌曲编号加载歌曲和歌词。

传入歌曲编号和加载配置，调用 loadMusic 加载歌曲和歌词。加载结果会通过 IMusicLoadStateListener 回调异步通知你。

参数Copy Anchor Link

• songCode: 歌曲编号，用于标识一个音乐资源。你可以通过 searchMusicByMusicChartId 或 searchMusicByKeyword 获取需要加载的歌曲编号，也可以通过 RESTful API 来获取曲库所有歌曲列表或增量歌曲列表。
• config: 加载配置。详见 KTVLoadMusicConfiguration。
• musicLoadStateListener: 歌曲加载状态，详见 IMusicLoadStateListener。

loadMusic[2/2]Copy Anchor Link

fun loadMusic(
    url: String,
    config: KTVLoadMusicConfiguration
)

通过歌曲 URL 加载歌曲和歌词。

参数Copy Anchor Link

• url：歌曲的 URL。
• config：加载配置。详见 KTVLoadMusicConfiguration。

removeMusicCopy Anchor Link

fun removeMusic(songCode: Long)

移除加载的版权音乐。

你可以调用该方法来移除当前正在加载或已加载完成的歌曲。调用后，歌曲的加载进程会终止，歌曲缓存也会清除。

参数Copy Anchor Link

• songCode：歌曲编号，与你调用 loadMusic 时传入的歌曲编号一致。

switchSingerRoleCopy Anchor Link

fun switchSingerRole(
    newRole: KTVSingRole,
    switchRoleStateListener: ISwitchRoleStateListener?
)

切换 K 歌时的用户角色。

KTV API 初始化时默认用户角色为听众，如果需要开始独唱或加入合唱，需要调用 switchSingerRole 来切换至相应的角色。你可以参考切换说明来进行角色切换。

KTV API 内部会根据角色的切换来控制演唱过程中音乐播放器的播放、同步，以及订阅和发布音频流的行为。角色切换的结果会通过 ISwitchRoleStateListener 回调异步通知你。

参数Copy Anchor Link

• newRole: 切换后的用户角色，详见 KTVSingRole。
• switchRoleStateListener：用户角色切换结果回调，详见 ISwitchRoleStateListener。

startSing[1/2]Copy Anchor Link

fun startSing(songCode: Long, startPos: Long)

播放歌曲。

如果你调用了 loadMusic[1/2] 加载歌曲，需要在收到 onMusicLoadSuccess 回调后再调用该方法来播放歌曲。

参数Copy Anchor Link

• songCode：歌曲编号，用于标识一个音乐资源。你可以通过 searchMusicByMusicChartId 或 searchMusicByKeyword 获取需要加载的歌曲编号，也可以通过 RESTful API 来获取曲库所有歌曲列表或增量歌曲列表。
• startPos：起始播放位置，单位为毫秒。

startSing[2/2]Copy Anchor Link

fun startSing(url: String, startPos: Long)

播放歌曲。

你可以通过传入歌曲的 URL 来进行播放。

如果你调用了 loadMusic[2/2] 加载歌曲，需要在收到 onMusicLoadSuccess 回调后再调用该方法来播放歌曲。

参数Copy Anchor Link

• url：歌曲的 URL。
• startPos：起始播放位置，单位为毫秒。

resumeSingCopy Anchor Link

fun resumeSing()

恢复播放歌曲。

pauseSingCopy Anchor Link

fun pauseSing()

暂停播放歌曲。

seekSingCopy Anchor Link

fun seekSing(time: Long)

跳转到指定时间播放歌曲。

参数Copy Anchor Link

• time: 跳转的时间点，单位为毫秒。

muteMicCopy Anchor Link

fun muteMic(mute: Boolean)

设置麦克风的开关状态。

参数Copy Anchor Link

• mute：当前麦克风的开关状态：
  • true：关闭麦克风。
  • false：开启麦克风。

setLrcViewCopy Anchor Link

fun setLrcView(view: ILrcView)

设置歌词控制视图。

歌词控制视图用于显示歌词和控制歌词滚动等操作。调用该方法后，可以将歌词控制视图和 KTV 模块进行绑定，从而实现歌词的同步滚动。

参数Copy Anchor Link

• view: 歌词控制视图，ILrcView 对象。你需要继承 ILrcView 类，并实现 ILrcView 下的接口。

setAudioPlayoutDelayCopy Anchor Link

fun setAudioPlayoutDelay(audioPlayoutDelay: Int)

设置音频播放延迟时间。

在音频自采集的情况下，你需要调用该方法传入音频帧处理和播放开始前的时间差以便播放器的实时同步。

参数Copy Anchor Link

• audioPlayoutDelay：音频帧处理和播放开始前的时间差，单位为毫秒。

getMediaPlayerCopy Anchor Link

fun getMediaPlayer() : IMediaPlayer

获取媒体播放器实例。

返回值Copy Anchor Link

• IMediaPlayer 实例。

getMusicContentCenterCopy Anchor Link

fun getMusicContentCenter() : IAgoraMusicContentCenter

获取音乐内容中心实例。

返回值

• IAgoraMusicContentCenter 实例。

renewInnerDataStreamIdCopy Anchor Link

fun renewInnerDataStreamId()

更新 KTV API 内部使用的数据流 ID。

如果你调用 leaveChannel 离开当前频道，之前创建的数据流会失效，你需要在调用 joinChannel 加入频道后，重新调用该方法更新数据流的 ID 。

ILrcViewCopy Anchor Link

该类提供歌词组件的相关回调。在调用 setLrcView 设置歌词控制视图时，你需要继承此接口类并实现其下的方法。

onUpdatePitchCopy Anchor Link

fun onUpdatePitch(pitch: Float?)

人声音调更新回调。

当人声音调更新时，会触发该回调将音调值同步给歌词评分组件。

参数Copy Anchor Link

• pitch：音调值。

onUpdateProgressCopy Anchor Link

fun onUpdateProgress(progress: Long?)

当歌曲播放进度更新时，会触发该回调将歌曲的实时进度同步给歌词评分组件。该回调每 50 ms 触发一次。

参数Copy Anchor Link

• progress：当前歌曲的播放进度，单位为毫秒。

onDownloadLrcDataCopy Anchor Link

fun onDownloadLrcData(url: String?)

当获取到歌词下载地址后，会触发调该回调报告歌词的下载地址。

参数Copy Anchor Link

• url：歌词的下载地址。

onHighPartTimeCopy Anchor Link

fun onHighPartTime(highStartTime: Long, highEndTime: Long)

当获取到副歌片段时，会触发该回调把副歌片段的起止时间同步给歌词组件用于显示对应的歌词。

参数Copy Anchor Link

• highStartTime：副歌片段的起始时间，单位为毫秒。
• highEndTime：副歌片段的结束时间，单位为毫秒。

IMusicLoadStateListenerCopy Anchor Link

该接口类提供歌曲加载状态的相关回调。

onMusicLoadSuccessCopy Anchor Link

fun onMusicLoadSuccess(songCode: Long, lyricUrl: String)

歌曲加载成功回调。

当你调用 loadMusic 成功加载歌曲后，会触发该回调。

参数Copy Anchor Link

• songCode：歌曲编号，与你调用 loadMusic 时传入的歌曲编号一致。
• lyricUrl：歌词下载地址。

onMusicLoadFailCopy Anchor Link

fun onMusicLoadFail(songCode: Long, reason: KTVLoadSongFailReason)

歌曲加载失败。

当你调用 loadMusic 加载歌曲，加载失败后会触发该回调报告失败的原因。

参数Copy Anchor Link

• songCode：歌曲编号，与你调用 loadMusic 时传入的歌曲编号一致。
• reason：歌曲加载失败的原因，详见 KTVLoadSongFailReason。

onMusicLoadProgressCopy Anchor Link

fun onMusicLoadProgress(songCode: Long, percent: Int, status: MusicLoadStatus, msg: String?, lyricUrl: String?)

歌曲加载进度回调。

你可以通过该回调来获取当前歌曲的加载进度和状态。

参数Copy Anchor Link

• songCode：歌曲编号，与你调用 loadMusic 时传入的歌曲编号一致。
• percent：歌曲加载进度，取值范围为 [0,100]，100 表示加载完成。
• status：歌曲加载状态，详见 MusicLoadStatus。
• msg：本次请求返回的消息。ok 表示请求成功。
• lyricUrl：歌词下载地址。

ISwitchRoleStateListenerCopy Anchor Link

该接口类提供用户角色切换状态的相关回调。

onSwitchRoleSuccessCopy Anchor Link

fun onSwitchRoleSuccess()

用户角色切换成功回调。

当你调用 switchSingerRole 成功切换用户角色后，会触发该回调。

onSwitchRoleFailCopy Anchor Link

fun onSwitchRoleFail(reason: SwitchRoleFailReason)

用户角色切换失败回调。

当你调用 switchSingerRole 切换用户角色失败，会触发该回调。你可以通过该回调获取切换失败的原因。

参数Copy Anchor Link

• reason：切换角色失败的原因，详见 SwitchRoleFailReason。

IKTVApiEventHandlerCopy Anchor Link

该接口类提供 K 歌场景的核心回调。

onMusicPlayerStateChangedCopy Anchor Link

open fun onMusicPlayerStateChanged(
    state: Constants.MediaPlayerState,
    error: Constants.MediaPlayerError,
    isLocal: Boolean
) {}

播放器状态改变回调。

参数Copy Anchor Link

• state：播放器的当前状态。详见 MediaPlayerState。
• error：播放器的错误码。详见 MediaPlayerReason。
• isLocal: 是否为本地事件：
  • true: 代表是本地播放器的状态改变。可用于主唱和伴唱监听本地播放器状态。
  • false: 是远端播放器的状态改变。可用于伴唱和听众知晓主唱的播放器状态，从而方便后续进行多端播放同步。

举例来说，在合唱场景下，主唱、伴唱、听众收到的 onMusicPlayerStateChanged 回调有如下区别：

• 主唱：收到一个 isLocal 为 true 的回调，报告主唱播放器的状态改变。
• 伴唱：收到一个 isLocal 为 true 的回调，报告伴唱播放器的状态改变；同时，还收到一个 isLocal 为 false 的回调，报告主唱播放器的状态改变。
• 听众：收到一个 isLocal 为 false 的回调报告主唱端播放器的状态改变。

onSingerRoleChangedCopy Anchor Link

open fun onSingerRoleChanged(oldRole: KTVSingRole, newRole: KTVSingRole) {}

用户角色改变回调。

当你调用 switchSingerRole 成功切换用户角色后，会触发该回调报告切换前后的用户角色。

参数Copy Anchor Link

• oldRole：切换前的用户角色，详见 KTVSingRole。
• newRole：切换后的用户角色，详见 KTVSingRole。

onTokenPrivilegeWillExpireCopy Anchor Link

open fun onTokenPrivilegeWillExpire() {}

Token 即将过期回调。

当用于音乐内容中心鉴权的 RTM Token 或用于加入合唱频道鉴权的 Token 即将过期时，会触发该回调。

在收到该回调后，你需要调用 renewToken 来更新 Token。

onChorusChannelAudioVolumeIndicationCopy Anchor Link

open fun onChorusChannelAudioVolumeIndication(
        speakers: Array<out IRtcEngineEventHandler.AudioVolumeInfo>?,
        totalVolume: Int) {}

领唱的人声音量回调。 开始合唱后，该回调会每 50 ms 触发一次，报告领唱的人声音量信息。

参数Copy Anchor Link

• speaker：领唱的音量信息，详见 AudioVolumeInfo 数组。
• totalVolume：混音后的总音量，取值范围为 [0, 255]。

Enum classCopy Anchor Link

KTVMusicTypeCopy Anchor Link

enum class KTVMusicType(val value: Int) {
    SONG_CODE(0),
    SONG_URL(1)
}

音乐资源类型：

• SONG_CODE：（默认）声网内容中心提供的版权音乐。
• SONG_URL：本地歌曲。

KTVSingRoleCopy Anchor Link

enum class KTVSingRole(val value: Int) {
    SoloSinger(0),
    CoSinger(1),
    LeadSinger(2),
    Audience(3)
}

K 歌用户角色类型：

• SoloSinger：(0) 独唱者。
• CoSinger：(1) 伴唱。
• LeadSinger：(2) 领唱。
• Audience：(3) 听众。

KTVLoadSongFailReasonCopy Anchor Link

enum class KTVLoadSongFailReason(val value: Int) {
    NO_LYRIC_URL(0),
    MUSIC_PRELOAD_FAIL(1),
    CANCELED(2)
}

歌曲加载失败的原因：

• NO_LYRIC_URL：(0) 无歌词下载地址。
• MUSIC_PRELOAD_FAIL：(1) 歌曲加载失败。请检查你的网络链接或检查 Token 是否过期。
• CANCELED：(2) 歌曲加载因出现错误而终止。

KTVSwitchRoleFailReasonCopy Anchor Link

enum class KTVSwitchRoleFailReason(val value: Int) {
    JOIN_CHANNEL_FAIL(0),
    NO_PERMISSION(1)
}

用户角色切换失败的原因：

• JOIN_CHANNEL_FAIL：(0) 加入频道失败。
• NO_PERMISSION：(1) 不支持从当前角色切换为目标角色，请参考切换说明进行角色切换。

KTVLoadMusicModeCopy Anchor Link

enum class KTVLoadMusicMode(val value: Int) {
    LOAD_MUSIC_ONLY(0),
    LOAD_LRC_ONLY(1),
    LOAD_MUSIC_AND_LRC(2)
}

歌曲加载模式：

• LOAD_MUSIC_ONLY：(0) 仅加载歌曲。用户在加入合唱成为伴唱时使用此模式。
• LOAD_LRC_ONLY：(1) 仅加载歌词。用户角色为观众时使用此模式。
• LOAD_MUSIC_AND_LRC：(2) (默认) 加载歌词和歌曲。用户角色为独唱者时使用此模式。

MusicLoadStatusCopy Anchor Link

enum class MusicLoadStatus(val value: Int) {
    COMPLETED(0),
    FAILED(1),
    INPROGRESS(2),
}

歌曲加载的状态：

• COMPLETED: (0) 加载成功。
• FAILED: (1) 加载失败。
• INPROGRESS: (2) 正在加载中。

KTVTypeCopy Anchor Link

enum class KTVType(val value: Int)  {
    Normal(0),
    SingBattle(1),
    SingRelay(3)
}

K 歌的场景：

• Normal：(0) 独唱、合唱场景。
• SingBattle：(1) 抢唱场景。
• SingRelay：（3）接唱场景。

Data classCopy Anchor Link

KTVApiConfigCopy Anchor Link

data class KTVApiConfig(
    val appId: String,
    val rtmToken: String,
    val engine: RtcEngine,
    val channelName: String,
    val localUid: Int,
    val chorusChannelName: String,
    val chorusChannelToken: String,
	  val maxCacheSize: Int = 10,
    val type: KTVType = KTVType.Normal,
    val musicType: KTVMusicType = KTVMusicType.SONG_CODE
)

K 歌配置：

• appId：你的项目的 App ID。

• rtmToken：RTM Token，用于音乐内容中心鉴权。

• engine：RtcEngine 对象。

• channelName：频道名。

• localUid：本地用户的 ID。频道内的每个用户 ID 都必须是唯一，为 32 位有符号整数，取值范围为 [-231-1, 231-1]。

• chorusChannelName: 在合唱场景下，领唱需要加入两个频道，主频道用户发布人声和播放器的混流，加入合唱子频道发布麦克风采集的音频流，伴唱需要加入合唱子频道来同步领唱的人声。在独唱场景下，该参数可以为空。

• chorusChannelToken：根据合唱子频道的名称和用户 ID 生成的 Token，用于加入合唱子频道时进行鉴权。在独唱场景下，该参数可以为空。

• maxCacheSize：可缓存的音乐资源数量，最多不能超过 50。

• type：K 歌场景，详见 KTVType。

• musicType：音乐资源类型，详见 KTVMusicType。

KTVGiantChorusApiConfigCopy Anchor Link

data class KTVGiantChorusApiConfig constructor(
    val appId: String,
    val rtmToken: String,
    val engine: RtcEngine,
    val localUid: Int,
    val audienceChannelName: String,
    val audienceChannelToken: String,
    val chorusChannelName: String,
    val chorusChannelToken: String,
    val musicStreamUid: Int,
    val musicStreamToken: String,
    val maxCacheSize: Int = 10,
    val musicType: KTVMusicType = KTVMusicType.SONG_CODE
)

大合唱场景的 K 歌配置：

• appId：你的项目的 App ID。

• rtmToken：RTM Token，用于音乐内容中心鉴权。

  信息

  你可以获取临时 RTM Token 用于测试，但在正式生产环境中，你需要自己部署一个 RTM Token 服务器来生成、更新 Token，详见部署 RTM Token 服务器。

• localUid：本地用户的 ID。频道内的每个用户 ID 都必须是唯一，为 32 位有符号整数，取值范围为 [-231-1, 231-1]。

• audienceChannelName：听众频道的频道名。

• audienceChannelToken：加入听众频道的 Token。

• chorusChannelName：演唱频道的频道名。领唱和伴唱需要加入该频道发布人声、音乐流。

• chorusChannelToken：加入演唱频道的 Token。

• musicStreamUid：发布音乐流的用户 ID。领唱需要发布音乐流到频道中。

• musicStreamToken：基于发布音乐流的用户 ID 和频道名生成的 Token，用于发布音乐流至频道内时鉴权。

• maxCacheSize：可缓存的音乐资源数量，默认值为 10，不得超过 50。

• musicType：音乐资源类型，详见 KTVMusicType。

KTVLoadMusicConfigurationCopy Anchor Link

data class KTVLoadMusicConfiguration(
    val songIdentifier: String,
    val mainSingerUid: Int,
    val mode: KTVLoadMusicMode = KTVLoadMusicMode.LOAD_MUSIC_AND_LRC
    val needPrelude: Boolean = false
)

歌曲加载设置：

• songIdentifier：歌曲的唯一标识。如果你使用的是自行维护的曲库，你需要传入该参数，并需确保唯一性。如果你使用的是声网提供的版权音乐，向 songCode 传参即可，此参数传空。
• mainSingerUid：独唱者的用户 ID。
• mode：歌曲加载的模式，详见 KTVLoadMusicMode。
• needPrelude：是否播放歌曲前奏：
  • true：播放歌曲前奏。
  • false：（默认）不播放歌曲前奏。
  注意

  该参数仅在抢唱模式（即 KTVType 设为 SingBattle）时生效。