KtvSDK-播放失败错误码说明
播放错误码说明
1）起播：调用preload到返回结果的阶段；
2）播放：preload成功后播放的阶段；
如果起播阶段预加载失败，可能有如下原因：
这种情况下，sdk会回调preload失败 PlayPreLoaderEvent.Failed
其中exception是 PlayException(int errorCode, String msg)，错误码与原因说明如下：
| 错误码errorCode | 说明 |
|---|---|
| 40002 | token过期 |
| 40004 | 多设备登录互踢导致token失效 |
| 106 | 未登录/多设备登录互踢导致token失效 |
| 3000 | 起播加载超时（30s） |
| 3001 | 录音权限申请失败 |
| 3002 | 未经过preload直接播放 |
| 3103 | 预加载取消 |
| 1 | 伴奏/原唱下载失败 |
| 803 | 离线下载数量超过限制 |
| 50015 | 限免阻断（超过限免次数了） |
| 50016 | 限免阻断（播放会员歌曲） |
| 50012 | 歌曲已被下架或屏蔽 |
| 50013 | 歌手已被屏蔽 |
| 50004 | 歌曲无版权，不能播放 |
| 400 | 无网络 |
如果播放过程失败，分以下两种情况：
一般是由于ExoPlayer内部失败原因导致视频播放失败，比如解码失败，资源错误等。
这种情况下，如果视频播放失败，而音频正常播放，sdk会优先切换为兜底粒子特效避免黑屏，如果兜底策略播放失败，则回调onShowPicture()，接入方可以显示大图覆盖在播放界面避免黑屏。
此时会回调
onPlayError(KaraokePlayRequest request, Throwable throwable)
其中 throwable是 PlayException(播放错误) 或 ResponseException(接口相关错误)。
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| errorCode | subErrorCode | 说明 | 建议 解决方案 |
|---|---|---|---|
| -1200 | 登录时出现默认错误 | 重新登录 | |
| -1100 | 出现网络错误时的默认错误码 | 检查网络 | |
| -1 | 其他播放错误，无错误码，此时通过errorMsg确定错误原因 | ||
| 2 | 6 | 原唱/伴奏的url都为空 | 检查输入 |
| 2 | 90000 | 视频解码失败 | 切换解码器重试 |
| 2 | 92 | 开始播放失败 | |
| 2 | -1004 | 音频文件读取失败 | 删除缓存后重新播放 |
| 2 | 其他播放错误，无错误码，此时通过errorMsg确定错误原因 | 重新登录 | |
| 6 | 无歌曲信息导致播放失败 | ||
| 7 | 列表为空导致播放失败 | ||
| 10 | 其他未知原因导致播放失败 | ||
| 11 | 播放位置出错 | ||
| 12 | 根据歌曲信息判断无法播放 | ||
| 28 | 列表太长导致播放失败 | ||
| 29 | 创建实例错误导致播放失败 | ||
| 35 | 操作过快导致播放失败 | ||
| 38 | 媒体属于非法状态 | ||
| 67 | 音视频解码过程中出现异常 | ||
| 91 | 播放器在准备阶段出现异常 | ||
| 92 | 播放器在开始播放时出现异常 | ||
| 100 | 编解码器错误码的开始标记 | ||
| 101 | 编解码创建错误 | ||
| 102 | ExoPlayer播放错误 | 可能是设备兼容问题，切换播放器 | |
| 103 | 二次缓冲次数过多 | 检查网络质量，如果不好就不要播放视频，切换大图显示 | |
| 104 | 超过了Exo的解码能力 | ||
| 105 | 启动超时 | ||
| 106 | 缓冲超时 | ||
| 107 | KTV编辑显示图片时出现错误 | ||
| 108 | Exo配置出错 | ||
| 110 | 播放超时 | 检查网络情况 | |
| 301 | 创建系统媒体播放器错误 | 查看当前有无其它播放器在使用 | |
| 302 | 系统媒体播放器准备错误 | ||
| 303 | 设置媒体数据源错误 | ||
| 304 | 系统媒体播放器的跳转错误 | ||
| 801 | 视频出现错误 | ||
| 802 | 缓冲次数过多 | 检查网络质量，如果不好就不要播放视频，切换大图显示 | |
| 1005 | 音频设备初始化失败 | ||
| 2006 | 音创的播放资源没有找到 | ||
| 3001 | 录音权限未授予 | ||
| 3104 | 播放下载错误 | ||
| 3004 | 起播超时（默认60s) | 一般是视频下载缓存导致不能启播。如果网速慢，起播时不要开启MV | |
| 3005 | 此功能需要VIP权限 | 检查用户是否为vip | |
| 3006 | 离线时间太长 | ||
| 5001 | 音频设备出现了额外的异常情况 | 重试播放 |
修改于 2025-11-19 09:17:51