KtvSDK-常见问题FAQ
demo使用问题
1.
2.
gradle.properties增加编译配置：android.enableDexingArtifactTransform=false查看文档1.1节的配置是否已处理。
登录
出现这个错误码就是下面两种原因之一：
1.
2.
证书校验错误，看下设备本地时间对不对。
打分&歌词
由于不同设备/麦克风收声能力不同，可能会导致打分的分数偏高/偏低；
先确认麦克风的人声数据是否是清晰的声音，如果人声不清晰那打出的分数自然就低。
如果不是上述原因，是设备硬件问题，则合作方可以设置打分加权系数，sdk会将实际分数乘上这个系数；注意这个方法只针对普通打分生效，对于五维打分无法加权
KtvPlayerConfig.getInstance().setScoreFactor(float factor)1.
2.
3.
五维打分的单句结果回调只会回调节奏、气息、音准三个维度的分数，技巧和情感单句打分始终为 0，等演唱结束时总分会打出包括技巧和情感的五个维度的分数。
五维打分技巧这个维度就是不好打，建议做加权处理：
计算其他维度平均分：计算除技巧外其他四个维度的总分平均值。
判断是否需要加权：如果技巧分数低于其他四个维度的平均分，则进行加权处理。
加权处理：生成一个 0 到 9 之间的随机数，加上其他四个维度的平均分得到加权后的技巧分数，同时确保分数不超过 100。
播放
可以过滤sdk的日志来查询常见错误，过滤关键字
onPlayerError或onExecuteFail如果错误日志看不出问题，可咨询K歌开发确定原因。
常见原因是视频因设备不支持等原因播放失败时，厂商没有实现
onShowPicture接口显示大图。视频播放失败后，此回调会返回一个歌曲封面图url，厂商接收到此回调后，可在KtvVideoLayout上覆盖一个图片控件显示大图兜底。
将支付页设置为透明主题，可解决此问题。
<style name="Theme.Transparent" parent="android:Theme.Translucent.NoTitleBar">
<item name="android:backgroundDimEnabled">true</item>
<item name="android:backgroundDimAmount">0.8</item>
<item name="android:windowIsTranslucent">true</item>
<item name="android:windowBackground">@android:color/transparent</item>
<item name="android:windowContentOverlay">@null</item>
<item name="android:windowNoTitle">true</item>
<item name="android:windowFullscreen">false</item>
<item name="android:windowAnimationStyle">@android:style/Animation.Dialog</item>
</style>播放前设置：
KtvPlayerConfig.getInstance().useOpenGL(true)gradle版本过高，建议gradle插件的版本为3.6，gradle-wrapper的版本为
gradle-6.9-all.classpath "com.android.tools.build:gradle:3.6.0"确认exoplayer版本是否为“接入指南”中指定的版本
项目中集成的guava版本与exoplayer版本不匹配。
//复制自ExoPlayer仓库，与ExoPlayer-2.18.5配套使用。
implementation ("com.google.guava:guava:31.0.1-android") {
// Exclude dependencies that are only used by Guava at compile time
// (but declared as runtime deps) [internal b/168188131].
exclude group: 'com.google.code.findbugs', module: 'jsr305'
exclude group: 'org.checkerframework', module: 'checker-compat-qual'
exclude group: 'org.checkerframework', module: 'checker-qual'
exclude group: 'com.google.errorprone', module: 'error_prone_annotations'
exclude group: 'com.google.j2objc', module: 'j2objc-annotations'
exclude group: 'org.codehaus.mojo', module: 'animal-sniffer-annotations'
}录音
因为此录音文件sdk在唱下下首歌时会删除旧录音文件，所以在播放结束onPlayEnd()回调时，需要将文件复制到其它路径自行保存。如果onPlayEnd()回调的文件不存在，确认如下条件是否满足：
1.
2.
//打开音频保存
KtvPlayerConfig.getInstance().enableSavePcm = true
3.
4.
如果是使用系统收声，让系统检查AudioRecord.read()是否正确在40ms内返回过人声。
如果是麦克风收声并定制过sdk的声音通道，检查是否调用过AudioReceiver.notifyReceiveAudioFrame()给传过人声。
声音通道
app启动时安装所有可支持的AudioRecevierInstaller，在每次播放时会遍历列表，哪个receiver.onCheckInstallerEnable()返回true，就用哪个。
查看用的哪个audioReceiver的方法：过滤
finalInputInstaller，看类名。音频焦点
其它
logcat中过滤hostChannelId关键字，可查看到sdk当前版本号，示例如下：
qua: V1_ATV_KG_2.1.02_23_100074_A, appId: 100074, hostId: common, isProductEnv: false, isDevMode: true, buildInfo: null_2024_02_20 15:17:37, deviceInfo{SDK_INT: 31BRAND: HUAWEIMODEL: NOH-AN00MANUFACTURER: HUAWEIDEVICE: HWNOH}, hostVersionName: 2.1.02.23, uid: , hostChannelId: DE_SAIcom.tme.ktv.api.KtvSdk#getSdkImei()KtvSDK默认是正式环境，如果需要切换到sdk的测试环境，可以在APP启动时使用
KtvSdk.setProductEnv(false)方法来切换，重启应用后生效。需要确认设备是否能够正常收声，声音通道是否设置正确。
需要注意，MV中可能会显示歌词，这种情况下，不需要再显示歌词组件。SongInfoObject.isMvHasLyric()不为true (即MV没有自带歌词)
如果MV自带歌词，但是MV播放黑屏了 会导致不显示歌词，这时会收到onShowPic的回调，判断如果当前MV自带歌词，那需要再初始化并显示歌词组件。
sdk不提供歌词倒计时组件，但是接入方可以根据回调自行实现相关功能。OnLyricCountDown会回调当前距离歌词首句显示的时间
LyricController.getInstance().addLyricListener(object : LyricListener {
override fun OnLyricTextUpdate(text: String?) {
//歌词单句回调
Logger.d(TAG, "OnLyricTextUpdate $text")
}
override fun OnLyricCountDown(countDown: Int) {
//跳过前奏倒计时 比如5000代表 还有5s开始显示歌词
Logger.d(TAG, "OnLyricCountDown $countDown")
}
})1.
2.
3.
4.
修改于 2025-09-01 07:13:36