Appearance
SDK接入FAQ
综合类
1、SDK是否提供隐私政策弹窗?
海外目前政策并没有强制要求游戏启动时有隐私弹窗, 直接在Google Play或AppStore后台配置隐私链接即可。 SDK后台可以将隐私弹窗关闭。
2、SDK知否含有实名认证和防沉迷
海外目前无实名认证和防沉迷要求,无须实现。
3、SDK接口调用无反应
- 请检查Application或AppDelegate中,是否有实现UGApplication或iOS的生命周期函数;
- 请检查初始化接口中的参数,包括appID、appKey等,是否和SDK后台一致;
- 请检查SDK相关依赖库是否有添加到游戏工程;
- 以上检查都无问题,请提供logcat日志或xcode控制台供技术分析。
4、游戏内支付后订单所属的角色ID非当前登录的账号
- 请检查游戏层在收到onLogout回调时,是否有强制玩家返回到游戏登录界面重新进入游戏。 如果此时玩家没退出,那游戏内角色ID还是老的,玩家可能已经切换到新SDK账号了。
- 请检查玩家在服务端发货逻辑中,是否有验证当前角色ID和uid的一致性。如果不一致,请不要给玩家发货。避免黑产代充漏洞。
5、SDK登录后,悬浮球未展示
- 请检查SDK后台是否关闭了悬浮球的开关
- 请检查日志,确认SDK登录是否成功
6、Android和iOS平台,同一个SDK账号返回的uid是否相同?
相同的。
7、SDK是否必须申请敏感权限
海外平台对敏感权限很严格,SDK中无须敏感权限,SDK不会主动申请这些敏感权限。
Android类
1、编译报错 error: unexpected element queries found in manifest
请升级gradle以及AS中的android sdk gradle插件版本
2、SDK登录失败排查
- 请检查初始化接口中的参数,包括appID、appKey等,是否和SDK后台一致;
- 请检查SDK后台,登录注册开关,是否有关闭;
- 请检查网络配置, application节点是否有配置:
android:usesCleartextTraffic="true",允许http明文请求。
3、游戏进入提示:此APP专为低版本系统打造
- 工程中targetSdkVersion请设置为30;
- 另外检查签名工具,保证使用的是apksigner,如果使用老的jarsigner,也会出此提示;
- 解压apk,查看lib下面是否有arm64-v8a库目录。
iOS类
1、启动闪退
检查build settings中other link flags中,是否有添加 -ObjC
服务端类
1、签名校验失败
登录认证协议,签名使用的key是SDK后台的AppKey参数;支付回调协议,签名使用的key是SDK后台的AppSecret。
2、登录认证Token失效
游戏客户端不要缓存token,每次登录都必须重新调用SDK的登录接口。
3、重复收到支付回调通知
- 游戏服务器在收到支付回调后,需要给SDK服务器返回
SUCCESS字符串,前后不要有空格和换行符。 如果SDK服务器收不到或收到了错误的结果,会自动重试,多次尝试; - 极端情况下,可能会因为网络问题, 导致SDK服务器没有收到游戏服务器返回的SUCCESS,导致SDK重复尝试。 所以建议游戏服务器,需要对同一个订单状态做好校验,如果已经给玩家发货过了,再次收到回调时,直接给SDK服务器返回
SUCCESS,而忽略给玩家发放道具。