全民K歌IOT开放平台
  1. KtvSDK3.0接入说明
全民K歌IOT开放平台
  • 厂商合作流程
  • 快速接入K歌开放平台流程
  • SDK bug提单规范
  • 如何在线调试接口
  • 常见问题FAQ
  • 开放平台API错误码说明
  • 开放平台接入指南
    • 登录鉴权方式介绍V2(推荐)
    • 如何申请接入
    • CDK权限申请流程
    • 暗账号绑定明账号对接文档
    • 获取应用级token
    • 获取登录二维码
    • 查询二维码的状态
    • 获取用户级token
    • 刷新用户级token
    • 暗账号解绑K歌uid
    • 获取暗账号绑定信息
  • KtvSDK3.0接入说明
    • 厂商合作流程
    • bug提单规范
    • KtvSDK-接入指南
    • KtvSDK-打分
    • KtvSDK-登录
    • KtvSDK-歌词
    • KtvSDK-播放
    • 多屏一起唱---歌词与打分适配
    • 3.0新打分样式及五维打分
    • KtvSDK-多屏渲染
    • KtvSDK-2.0升级到3.0版本迁移指南
    • KtvSDK-3.0版本新功能
    • KtvSDK-Android4.4设备G2证书兼容处理
    • KtvSDK-播放页实现示例
    • KtvSDK-常见问题FAQ
    • KtvSDK-低性能设备处理
    • KtvSDK-反馈
    • KtvSDK-缓存管理
    • KtvSDK-切换音频视频清晰度
    • KtvSDK-跳过前奏
    • Ktv支付-米大师支付
    • 播放失败错误码说明
    • 作品录音、合成与播放2.0版
  • 基础类
    • tagId对照表
    • 歌曲详情
    • 查询mv的播放地址
    • 搜索
    • 搜索联想
    • 查询歌手歌曲
    • 获取歌曲歌词文件
    • Q音歌曲mid映射K歌
    • 短剧播放链接
    • 查询应用限免配置
    • 转换Q音或酷狗歌曲ID
  • 运营类
    • 排行榜id说明
    • 获取城市id列表
    • 获取专题分类列表
    • 获取云端配置
    • 热门ugc
    • 热搜词
    • 排行榜
    • 获取专题下歌曲信息
    • 获取车联渠道映射
    • 热门推荐
    • (新)排行榜
    • 综合歌单列表查询
    • 设置缓存设备
    • TV版分类歌单列表
    • 获取用户协议
    • 综合歌单列表查询(海外)
    • 榜单列表查询(海外)
    • 自建歌单列表查询(海外)
    • 获取广告配置
    • 拉取短剧合集的列表
  • 用户类
    • 用户信息查询
    • 删除用户UGC作品
    • 获取推荐/翻唱作品
    • 获取同城作品
    • 用户作品列表
    • 获取好友作品
    • UGC作品详情
    • 更改作品访问权限
    • 用户个推歌单
  • 支付类
    • 支付接入流程
    • 订单发货使用简述
    • 开通设备会员限免简述
    • 订单发货中通用sign计算规则
    • 通用返回结构
    • 【CDK】CDK兑换
    • 【CDK】生成CDK
    • 【CDK】CDK召回
    • 【CDK】CDK状态查询
    • 【三方支付】订单发货
    • 【三方支付】手机号发货
    • 【三方支付】订单状态查询
    • 【米大师支付】获取会员商品列表
    • 【米大师支付】未登录-查询会员商品列表
    • 【米大师支付】支付下单
    • 【米大师支付】支付成功通知
    • 【米大师支付】查询用户支付成功订单记录
    • 查询设备以及用户是否有赠送资格
    • 查询设备限免剩余时长
    • 设备会员迁移
    • 查询会员赠送时长
    • 同步支付订单接口
    • 【三方支付】存量会员迁移领取查询
    • 【三方支付】存量会员迁移接口
    • 授权设备体验会员
    • 查询用户会员信息
    • 【三方支付】超会发货
    • 取消授权设备体验会员
  • 用户作品-文件类
    • callback_url说明
    • 上传音频源文件
    • (服务端)上传音频作品的链接
  • 通用类
    • 【厂商定制】匹配搜索
    • 获取kg的短链接
  1. KtvSDK3.0接入说明

多屏一起唱---歌词与打分适配

歌词与打分的支持#

歌词与打分先参考接入文档的相关部分,为支持一起唱的功能需要额外做如下处理。

基本说明#

主机与副机之间是主从模式,需要打开该设置;单端是本地模式,默认为本地模式,即:
配置参数
KtvPlayerConfig.getInstance().setXXX
midiView.setIsXXXMode
模式说明
EnableScoreMasterSlaveModetrue 为主从模式,false 为本地单端
EnableScorePollingtrue 为轮询, false 为回调
歌词打分新增相关接口如下(在KaraokePlayer中对外暴露)
接口说明
NoteItem[] getNoteItems()获取节拍数据
ScoreResult getScoreResult(long timestamp)根据时间戳获取打分结果(轮询打分使用)
void setClientScoreCallBack(NewScoreCallBack callBack)设置客户端的回调逻辑(回调打分使用)
LyricData getLyricData()获取歌词数据,包括Lrc和Qrc格式字节数组和是否显示歌词,供多端显示使用

两种打分同步模式(主从模式)#

为了支持一端播放录唱,多端共同显示的功能,打分 View 支持轮询模式和回调模式。
开启主从模式
在使用主机与副机之间的轮询模式或回调模式进行打分时,需要先开启主从模式:
打分模式切换:
初始化

轮询模式#

轮询模式需要传递的数据结构:
轮询模式使用方法如下:
onPrepareScore 回调中,设置轮询获取数据的接口。播放器提供了获取数据的方法,从播放器获取数据后按需使用即可。

回调模式#

因为涉及到网络传输,需要一个中间方进行数据传输,假设为 Transfer 类。整体逻辑为:
发送方放入数据 -> Transfer -> 接收方取出数据
数据为:
击中分数条信息:GroveHitInfo groveHitInfo
当前总分:int score
单句分数:int score
单句分数对应时间戳:int timeStamp
==客户端==
onPrepareScore 回调中,设置回调获取数据的接口。播放器提供了设置客户端回调 setClientScoreCallBack 的方法,从播放器获取数据后按需使用即可。
实现 NewScoreCallback 接口的两个方法,调用 execute 方法送入四个数据
==服务器==
SingCompetitor 送入数据

对比#

修改于 2025-09-01 07:13:28
上一页
KtvSDK-播放
下一页
3.0新打分样式及五维打分
Built with