全民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接入说明

播放失败错误码说明

播放错误码说明#

播放分为两个阶段:
1)起播:调用preload到返回结果的阶段;
2)播放:preload成功后播放的阶段;

如果起播阶段失败,可能有如下原因:#

1.播放阻断:会员阻断或者限免阻断等,这种情况下sdk会回调阻断的回调,接入方在回调中处理阻断事件即可;
2.起播过程中失败,可能有token失效,资源下载失败等场景:
这种情况下,sdk会回调preload失败 PlayPreLoaderEvent.Failed
其中exception是 PlayException(int errorCode, String msg),错误码与原因说明如下:
错误码errorCode说明
40002token过期
40004多设备登录互踢导致token失效
106未登录/多设备登录互踢导致token失效
3000起播加载超时(30s)
3001录音权限申请失败
3002未经过preload直接播放
3103预加载取消
1伴奏/原唱下载失败
803离线下载数量超过限制
50015限免阻断(超过限免次数了)
50016限免阻断(播放会员歌曲)
50012歌曲已被下架或屏蔽
50013歌手已被屏蔽
50004歌曲无版权,不能播放
400无网络

如果播放过程失败,分以下两种情况:#

1.视频播放失败:
一般是由于ExoPlayer内部失败原因导致视频播放失败,比如解码失败,资源错误等。
这种情况下,如果视频播放失败,而音频正常播放,sdk会优先切换为兜底粒子特效避免黑屏,如果兜底策略播放失败,则回调onShowPicture(),接入方可以显示大图覆盖在播放界面避免黑屏。
2 播放过程中音频播放错误,或者音视频都播放失败:
此时会回调
onPlayError(KaraokePlayRequest request, Throwable throwable)
其中 throwable是 PlayException(播放错误) 或 ResponseException(接口相关错误)。
一般会在KaraokePlayerListener.onPlayError()接口中回调报错信息,播放错误示例:
onPlayError,errorCode: 29, subErrorCode: 0, extra: 0, errorMsg: start failed 29, cause: null

onPlayerError onPlayError errorCode: 3004, subErrorCode: 0, extra: 0, errorMsg: onExecuteTimeout, cause: null
播放错误码如下:
errorCodesubErrorCode说明
-1200登录时出现默认错误
-1100出现网络错误时的默认错误码
-1其他播放错误,无错误码,此时通过errorMsg确定错误原因
26原唱/伴奏的url都为空
290000视频解码失败
292开始播放失败
2-1004音频文件读取失败
2其他播放错误,无错误码,此时通过errorMsg确定错误原因
6无歌曲信息导致播放失败
7列表为空导致播放失败
10其他未知原因导致播放失败
11播放位置出错
12根据歌曲信息判断无法播放
28列表太长导致播放失败
29创建实例错误导致播放失败
35操作过快导致播放失败
38媒体属于非法状态
67音视频解码过程中出现异常
91播放器在准备阶段出现异常
92播放器在开始播放时出现异常
100编解码器错误码的开始标记
101编解码创建错误
102ExoPlayer播放错误
103二次缓冲次数过多
104超过了Exo的解码能力
105启动超时
106缓冲超时
107KTV编辑显示图片时出现错误
108Exo配置出错
110播放超时
301创建系统媒体播放器错误
302系统媒体播放器准备错误
303设置媒体数据源错误
304系统媒体播放器的跳转错误
801视频出现错误
802缓冲次数过多
1005音频设备初始化失败
2006音创的播放资源没有找到
3001录音权限未授予
3104播放下载错误
3004起播超时(默认60s),一般是视频下载缓存导致不能启播。如果网速慢,起播时不要开启MV
3005此功能需要VIP权限
3006离线时间太长
5001音频设备出现了额外的异常情况
修改于 2025-09-01 07:19:36
上一页
Ktv支付-米大师支付
下一页
作品录音、合成与播放2.0版
Built with