SDK接入FAQ

综合类

1、SDK是否提供隐私政策弹窗？

SDK只在自己的SDK登录界面含有隐私政策和用户协议弹窗，但是为了隐私政策合规， 游戏层应该有自己的启动隐私弹窗，并在玩家同意后，才能调用SDK的API，包括初始化、登录、支付等。

2、SDK知否含有实名认证和防沉迷

SDK内置了实名认证和未成年防沉迷逻辑， 游戏层无须实现。 如果游戏层有自己的实名认证和防沉迷逻辑，请屏蔽。

3、SDK接口调用无反应

1. 请检查Application或AppDelegate中，是否有实现UGApplication或iOS的生命周期函数；
2. 请检查初始化接口中的参数，包括appID、appKey等，是否和SDK后台一致；
3. 请检查SDK相关依赖库是否有添加到游戏工程；
4. 以上检查都无问题，请提供logcat日志或xcode控制台供技术分析。

4、游戏内支付后订单所属的角色ID非当前登录的账号

1. 请检查游戏层在收到onLogout回调时，是否有强制玩家返回到游戏登录界面重新进入游戏。 如果此时玩家没退出，那游戏内角色ID还是老的，玩家可能已经切换到新SDK账号了。
2. 请检查玩家在服务端发货逻辑中，是否有验证当前角色ID和uid的一致性。如果不一致，请不要给玩家发货。避免黑产代充漏洞。

5、SDK登录后，悬浮球未展示

1. 请检查SDK后台是否关闭了悬浮球的开关
2. 请检查日志，确认SDK登录是否成功

6、SDK登录后，提示我已经完成实名，但是我还没在该游戏实名过

SDK账号是全局的，如果你在该SDK下某款游戏实名认证过，那之后其他游戏内也会自动同步到您的实名信息，无须再次实名。 您可以在悬浮球-》用户中心-》实名认证中，查看您的实名信息。

7、SDK是否必须申请敏感权限

SDK中所有需要敏感权限的API都做了可选处理，SDK不会主动申请这些敏感权限。 无这些权限不影响SDK的基本功能。

Android类

1、编译报错 error: unexpected element queries found in manifest

请升级gradle以及AS中的android sdk gradle插件版本

2、SDK登录失败排查

1. 请检查初始化接口中的参数，包括appID、appKey等，是否和SDK后台一致；
2. 请检查SDK后台，登录注册开关，是否有关闭；
3. 请检查网络配置， application节点是否有配置：android:usesCleartextTraffic="true"，允许http明文请求。

3、游戏进入提示：此APP专为低版本系统打造

1. 工程中targetSdkVersion请设置为30；
2. 另外检查签名工具，保证使用的是apksigner，如果使用老的jarsigner，也会出此提示；
3. 解压apk，查看lib下面是否有arm64-v8a库目录。

iOS类

1、启动闪退

检查build settings中other link flags中，是否有添加 -ObjC

2、运行找不到库文件

检查ATAuthSDK_D.xcframework有没有设置为Embed & Sign

服务端类

1、签名校验失败

登录认证协议，签名使用的key是SDK后台的AppKey参数；支付回调协议，签名使用的key是SDK后台的AppSecret。

2、登录认证Token失效

游戏客户端不要缓存token，每次登录都必须重新调用SDK的登录接口。

3、重复收到支付回调通知

1. 游戏服务器在收到支付回调后，需要给SDK服务器返回SUCCESS字符串，前后不要有空格和换行符。 如果SDK服务器收不到或收到了错误的结果，会自动重试，多次尝试；
2. 极端情况下，可能会因为网络问题， 导致SDK服务器没有收到游戏服务器返回的SUCCESS，导致SDK重复尝试。 所以建议游戏服务器，需要对同一个订单状态做好校验，如果已经给玩家发货过了，再次收到回调时，直接给SDK服务器返回SUCCESS，而忽略给玩家发放道具。