跳到主要内容

常见问题

使用自动登录方式，首次登录报 {"code":9999, "error_msg":"user token is empty"} 异常。​

自动登录说明：以上次登录成功过的账号继续登录。采用自动登录方式即调用 LoginByType(Default) 接口，首次确实会报上述异常，属于预期之内的现象。推荐的登录流程是先进行自动登录，自动登录失败后再显示 TapTap 登录按钮给用户点击授权登录。

Tap APP 登录失败，报错信息 signature not match 是什么原因？​

  • 要在 Tap 开发者后台配置应用的安卓包名、签名文件 MD5、iOS Bundle ID，不可随意修改，需要对应才可以使用。其中安卓包名及 iOS Bundle ID 区分大小写，安卓签名文件 MD5 值不区分大小写。
  • 还需要把 Tap 账号 id 加入 Tap 开发者后台的测试用户列表中才可以。
  • 可以用 这个工具 确认安卓 apk 的包名和签名文件 MD5 值。
  • 如果在线上遇到部分玩家报该错误，且游戏通过 TapPlay 打开，可以怀疑是 TapPlay 的问题，可参考 案例。此问题已经在 TapTap 2.34 修复，可引导玩家升级 TapTap 客户端之后再进入游戏。

账户注销的实销冷静 15 天如此长，游戏如何尽快测试？​

可以按照如下流程测试：

  • 在游戏客户端内走完注销申请流程，且期间不要再登录这个账号 。
  • 联系平台服务端研发，提供 xdid。
  • 我们会根据 xdid 来指定一个实销时间。
  • 修改完实销时间之后，等待 10 分钟左右即可看到效果。

如何配置账户注销的回调地址？​

回调地址可以在申请 Client ID 开通时一并在申请单中提交，也可以在联调的过程中直接发给平台研发。

如何获取账户注销的回调秘钥？​

平台研发会在 Client ID 开通时一并提供给接入方，或者在联调的过程中提供给接入方。

iOS XDGAccount.AccountCancellation() 打开空白页面是什么原因？​

如果确认不是网络问题后，应该是账号注销地址未配置到该应用上，请联系 XD Server 端同学补充该配置。

SDK 初始化失败，提示 "Chain validation failed"，如何排查？​

可以按照以下步骤排查：

  1. 检查设备是否链接代理未正常安装证书。
  2. 检查手机系统时间是否有修改。

使用 XDSDK 注册账号并登录后，用 SDK 返回的游客昵称在 TapDC 后台查询，无法找到该账号？​

可以尝试用以下代码获取昵称：

var tdsUser = await TDSUser.GetCurrent().Result.Fetch();
var name = tdsUser["name"] as string

不过需要注意的是 XDSDK 不会帮游戏设置用户名，需要游戏自行设置。设置方式如下：

var currentUser = await TDSUser.GetCurrent();
currentUser["username"] = "your display name";
await currentUser.Save();

TDS 账户的属性，只是提供了一种保存的机制，该设置什么值，只能由业务方自己来定，所以你想得到什么名字，就应该给 TDSUser 设置什么名字。

使用 XDSDK 登录后提示 "不安全设备，无法登录" 或者是 "Insecure device. Unable to login in"？​

只有游客登录触发了风控才会出现 "不安全設備，無法登陸"(不同语言会有不同的文案，但是意思相同) ，触发条件是使用安卓设备进行游客登录时该设备的分辨率与上次登录不一致。

用申请的测试账号登录时，提示 "游戏/应用暂未开放"？​

参考 TapDC 的《测试用户管理》文档。

Facebook 登录出现 "Sorry, something went wrong"​

确认不是 Facebook 的 官方故障 后，或许你应该检查 XDConfig.json 文件中的 fb 的 permissions 配置和在 Facebook 申请的是否一致，Facebook 控制后台 应用审核 -> 权限和功能， 可查看对应的权限字段。 可参考 案例。

Google PC 网页登录提示 "禁止访问：此应用的请求无效"，错误 400: redirect_uri_mismatch​

如文档所述：需要在 Web 应用内配置授权的重定向 URI https://xdsdk-intnl-6.xd.com/api/login/v1/auth/google/authorization_code/ 和一个授权的 JavaScript 来源 https://login-xdsdk.xd.com，一定要记得点击保存，否则不会生效。 请对此做检查是否配置正确。

Unity 导出 Xcode 工程打包 iOS 报错 "Config file empty, Please check your XDConfig.json"。​

检查 Xcode 工程中 Users/当前设备用户名/.jenkins/....../XcodeProj/SDKResource 目录下的 XDConfig.json 文件是否存在，如果存在检查该文件中是否包含注释、非法字符，文件内容需遵循 JSON 数据的格式以及语法。

iOS TapTap 登录唤起 TapTap 社区客户端闪一下便退回到游戏，调试日志显示：Login failed:sdk_not_matched。​

检查 Xcode 工程打包时配置的 Bundle ID 和 TapDC 后台配置的应用 Bundle ID 是否一致。

Android Google 登录报错：error":{"code":3, "error_msg":"12500: ", "extra_data":null} 或者 error":{"code":3, "error_msg":"10: ", "extra_data":null}​

类似 error_msg 为数字+冒号的格式，都是 Google 登录时 Google 返回的错误码，但是 Google 并没有给出具体的解释。当出现 error_msg 为 10: 12500: 时，请务必确保 Android 应用端 ID 创建时填写打包的签名证书中的 SHA-1 证书指纹的正确性。如果确定 SHA-1 没有配置错误，请检查移动端在项目的 XDconfig.json 文件中配置的 CLIENT_ID_FOR_ANDROID 的准确性。

TapTap 登录报错：{"code":50000, "error_msg":"Unknown Error", "detail":"UNKNOWN: message 50000 failed to create tds user:{"code": 401, "error": "Unauthorized."}"}​

由异常信息 message 50000 failed to create tds user:{"code": 401, "error": "Unauthorized."} 得知错误原因是内建账户 Unauthorized，需要检查一下游戏侧配置的 TapTap Server Secret 是否正确。