04/29/2024 11:54:53
解决方案
一、一般错误返回码
返回码 | 返回码描述 | 详细说明 |
---|---|---|
0 | 客户端回调成功 | - |
-1000 | SDK 参数错误 | - |
-1001 | SDK 未初始化 | - |
-1002 | SDK 内部错误 | - |
-1003 | 网络请求异常 | - |
-1004 | 用户未登录 | - |
-1005 | 用户取消操作 | - |
-1006 | 初始化异常 | - |
-1007 | 未安装快手 | - |
-1008 | 自动登录失败,scope发送变化,需要重新登录 | - |
6001 | 分享失败 | - |
6002 | 分享取消 | - |
6003 | 分享数据错误 | - |
6004 | 分享渠道不支持 | - |
7001 | 不支持的分享类型(iOS) | - |
7002 | 没有相册权限,请跳转设 置打开(iOS) | - |
二、分享错误返回码
返回码 | 返回码描述 | 详细说明 |
---|---|---|
-1011 | 快手未登录 | message |
-1010 | 错误参数 | message |
-1006 | 快手不支持功能 | message |
-1005 | 未安装快手 | message |
-1 | 用户取消 | message |
1 | 分享成功 | message |
20088 | 无操作权限 | message |
20089 | 无法获取gameId对应的快手 用户Id | message |
20090 | 无效的命令字 | message |
20091 | gameId同当前快手登录用户不是一个用户 | message |
20092 | targetGameId不是你的好友 | message |
20094 | 无效的targetGameId | message |
100200100 | 无效参数 | message |
1001 | 参数错误 | video |
1000 | 不支持的视频分享类型 | video |
7002 | 没有相册权限,请跳转设置打开(iOS) | video |
三、oauth授权错误返回码
返回码 | 返回码描述 | 详细说明 |
---|---|---|
1 | 成功 | - |
100200100 | 请求缺少参数或格式错误 | - |
100200101 | 未授权的 client,无效的 app 或 developer | - |
100200102 | 请求被拒绝,可能是无效的 token 等 | - |
100200103 | 请求的 responseType 错误 | - |
100200104 | 请求的 grantType 不支持 | - |
100200105 | 请求的 code 错误 | - |
100200106 | 请求的 scope 错误 | - |
100200107 | 无效的 openid | - |
100200108 | access_token 或者 refresh_token 过期 | - |
100200109 | 用户取消该 app 授权 | - |
100200110 | 用户授权过期 | - |
100200111 | 用户未授权过 | - |
100200112 | bundleToken不合法 | - |
100200410 | api限流 | - |
100200300 | 短信验证码错误 | - |
100200301 | 商家不存在 | - |
100200302 | 开发者不存在 | - |
100200303 | 商家已存在开发者 | - |
100200304 | 开发者状态不对 | - |
100200312 | app 不存在 | - |
100200313 | 统一开发者已存在同类型应用 | - |
100200314 | app 状态不对 | - |
100200220 | 没有操作权限 | - |
100200500 | 服务器内部错误 | - |
四、server错误返回码
返回码 | 返回码描述 | 详细说明 |
---|---|---|
1 | 成功 | - |
100200100 | 请求缺少参数或格式错误 | - |
100200500 | 服务器内部错误 | - |
100200600 | 签名错误 | - |
100200601 | 时间戳错误 | - |
100201000 | 账号绑定失败 | - |
100201001 | 授权失败,需重新调用sdk登录接口 | - |
100202101 | 快手账号已被其他用户绑定 | - |
100201102 | 当前账号已绑定其他快手账号 | - |
100201106 | 用户还未绑定快手账号 | - |
100201107 | 快手账号未注册当前游戏 | - |
100201108 | gameId未在游戏方绑定 | - |
100201109 | 主app token无效 | - |
100201110 | 主站用户不存在 | - |
100201111 | 快手oauth code无效 | - |
100202000 | TOKEN 错误,需要重新调用sdk登录接口 | - |
100202001 | TOKEN 过期,需要重新调用sdk登录接口 | - |
100203000 | 直播相关异常 | - |
100203001 | 礼物重复发送 | - |
100203002 | 未绑定直播的快手账号 | - |
100203003 | 还未授权观看直播 | - |
100203004 | 直播间id和游戏uid不匹配 | - |
100204000 | 身份证绑定错误 | - |
100204001 | 用户已绑定了其他身份 | - |
100205001 | 没有push权限 | - |
100205002 | 没有im权限 | - |
100205003 | 没有开通abtest权限 | - |
100205004 | 没有开通反馈权限 | - |
100206001 | appId不存在 | - |
100207001 | 获取连麦id失败 | - |
100207002 | 缺少必要的配置 | - |
100207003 | 下载异常 | - |
100207004 | 没有这样的文件 | - |
100208000 | cdkey格式错误 | - |
100208001 | cdkey,app_id不匹配 | - |
100208002 | 礼包尚未开始兑换 | - |
100208003 | CDKEY已过期 | - |
100208004 | CDKEY已使用(用光) | - |
100208005 | 礼包不能重复领取 | - |
100208006 | 礼包渠道与账号渠道不匹配 | - |
100208007 | gameId与游戏角色id不匹配 | - |
100208008 | 礼包道具不存在 | - |
100208009 | 礼包不存在 | - |
100208010 | cdkey兑换次数已达上限 | - |
100208011 | 礼包领取失败 | - |
100209000 | 上传cdn失败 | - |
100209001 | 重复的文件名 | - |
100210000 | 领取春节活动奖励失败 | - |
100211000 | 没有可以更新的渠道包 | - |
100212000 | 用户未开启自动同步快手作品 | - |
100213000 | 验证码错误 | - |
100213001 | 手机号错误 | - |
100213002 | 发送验证码过于频繁 | - |
特别说明:
1.100200101 表示未授权的 client,无效的 app 或 developer。需要检查 MSDKConfig.ini 中的 KWAI_APP_ID 与 飞鹰系统 ->游戏管理 ->我的游戏 ->SDK信息页面记录的 快手ID 是否一致。
2.100201001 表示授权失败,需要重新调用登录接口。有以下几点需重点注意。
(1)当发生和快手授权相关的错误后,需要重新调用登录接口,让用户重新授权登录;
(2)快手授权错误一般发生在访问功能超出 Scope 权限范围,或者长时间未访问授权功能的场景,需要业务方正确处理这些场景;
3.100202001 表示TOKEN 过期,需要重新调用登录接口。有以下几点需重点注意。
(1)TOKEN 过期时间为 30 天(可配置,配置需联系MSDK助手对接),在首次登录以及每次调用自动登录之后会被善心,并延长其有效期;
(2)建议所有接入方在使用 KwaiGameSDK 实际登录授权成功并获得用户信息后,每次冷启动应用都先主动调用自动登录以刷新 TOKEN。若自动登录失败,再调用登录,重新授权登录;
(3)使用 KwaiGameSDK 以及快手游戏中台业务时,如果遇到 TOKEN 过期的错 100202001,需要调用 KwaiGameSDK 的RefreshToken 接口刷新 TOKEN,并重新调用功能;
(4)TOKEN 每次刷新后不同(Login, AutoLogin, RefreshToken);
4.快手第三方错误码,也可以参考 快手官方-游戏接入指引。
Copyright © 2024 MSDK.
All rights reserved.
All rights reserved.