功能介绍

车载/TV相比手机端，存在多人使用同一设备K歌的情况。多人场景下，用户存在同屏互动的诉求，如PK、合唱等。

PK模式：PK为双人模式，两人同唱一首歌，歌词控件可显示A、B角色分段信息、头像信息，A、B的打分分数可各自统计，展现出PK的效果。
效果示例：

合唱模式：合唱为双人模式，两人同唱一首歌，歌词控件可显示A、B角色分段信息、头像信息，A、B的打分分数合并显示，用于合唱场景。
效果示例：

PK与合唱接口

PkChorus是Pk合唱功能的核心类,提供了初始化,歌曲是否支持pk合唱,获取加入pk合唱的链接，监听用户加入pk或者合唱,退出pk合唱,修改打分条颜色,获取pk合唱结果,拉取合唱top榜单等功能。

初始化

判断当前歌曲是否支持pk

判断当前歌曲是否支持合唱

获取pk发起者参与pk的链接

发起者可通过扫包含此链接的二维码,加入pk，若没有用户扫码则发起者是匿名用户

获取pk挑战者参与pk的链接

挑战者可通过扫包含此链接的二维码,加入pk 若没有用户扫码则挑战者是匿名用户

获取合唱发起者参与合唱的链接

发起者可通过扫包含此链接的二维码,加入合唱若没有用户扫码则发起者是匿名用户

获取合唱挑战者参与合唱的链接

挑战者可通过扫包含此链接的二维码,加入合唱若没有用户扫码则挑战者是匿名用户

监听参与pk和合唱,获取参与者的用户信息

感知用户的加入

移除监听

移除之后将无法感知用户的加入

获取合唱top用户列表

是当前歌曲对应的top用户

退出pk

用户主动退出pk

退出合唱

用户主动退出合唱

开始pk

不支持pk,未登录,不是vip则无法开启pk

开始合唱

不支持合唱,未登录,不是vip则无法开启合唱

监听PK过程中的分数与pk结束后的pk结果

pk的分数指的是平均分,比如挑战者唱了10句总得分是800分,那么均分就是80
pk结束后会输出每个参与者的得分

监听合唱过程中的分数与合唱结束后的合唱结果

合唱的分数指的是已唱句子的总得分,比如挑战者唱了10句总得分是800分,那么目前的合唱分数就是800分,
合唱结束后会输出合唱的结果:包含总分,等级（比如s,ss），排名,发起者挑战者信息

PK与合唱歌词初始化

相较于普通的歌词初始化逻辑，主要增加了if (info?.isSupportPk == true)处的PK初始化逻辑。
在歌词显示方面，PK与合唱的初始化逻辑一致。

里面PlayConsole类只是演示功能，sdk不维护此类，需要厂商自己实现相同的逻辑。

用户头像加载

PK头像的加载需要用到图片加载组件，实现com/tme/ktv/api/KtvInitParams.imageLoader方法以让sdk可以加载图片。
在KtvSdk.init()时传入KtvInitParams实例。

PK歌词定制

歌词颜色定制
PK/合唱模式时，歌词会进行根据歌词中定义的唱歌角色不同，进行歌词变色（角色A红色、角色B蓝色）。如果需要颜色定制，修改LyricView中的属性值：
lightTextColor：RoleA角色歌词颜色
lightTextColorRoleB：RoleB角色歌词颜色

其它字体等属性值都是共用的。

PK头像定制
必须在build()前调用

LyricInitializer().setLyricView(lyricView).setPKHeadBitmap(BitMapA, BitmapB).build()

PK与合唱接入

功能介绍#

PK与合唱接口#

初始化#

判断当前歌曲是否支持pk#

判断当前歌曲是否支持合唱#

获取pk发起者参与pk的链接#

获取pk挑战者参与pk的链接#

获取合唱发起者参与合唱的链接#

获取合唱挑战者参与合唱的链接#

监听参与pk和合唱,获取参与者的用户信息#

移除监听#

获取合唱top用户列表#

退出pk#

退出合唱#

开始pk#

开始合唱#

监听PK过程中的分数与pk结束后的pk结果#

监听合唱过程中的分数与合唱结束后的合唱结果#

PK与合唱歌词初始化#

用户头像加载#

PK歌词定制#