九游单机SDK接入常见问题

一．客户端

1.初始化相关

1.1 调用初始化接口后没有报错，但收不到任何回调

①需确保在调用初始化接口的activity内设置registeSDKEventReceiver

②需确保初始化接口以及回调事件在UI线程执行

③请检查manifest组件：cn.gundam.sdk.shell.activity.ProxyActivity 是否未配置，若无，请补齐

④请自行反编译apk对比SDK包内的此SDK资源目录是否完整无缺漏：assets/ucgamesdk/lib ，如有缺漏，请完整地重新拷贝SDK资源

⑤请反编译检查manifest是否有空的android:taskAffinity=""，如有，请删除

⑥如游戏接入的SDK版本为9.X，请确保targetSDKverison不要超过26，SDK最高仅支持到26

⑦请确保没有重复写入同一个回调事件

⑧请检查游戏设置的监控回调是否存在问题而无法正常执行

⑨需确保游戏代码是否有做混淆，如有请根据文档加入keep代码保持SDK相关不被混淆

1.2 调用初始化接口，同一设备偶现无法收到初始化成功回调，游戏运行过程中手机调出后台看到同一个游戏有2个后台应用

请检查游戏manifest内是否有个空的android:taskAffinity=""，直接删掉即可

1.3  接入正常，初始化成功回调也可以正常收到，但没有正常展示SDK悬浮窗

①检查初始化是否使用debugMode=true测试环境，如是，请修改为false生产环境，测试环境已经下线后续无法使用

②如游戏是gameId值小于500000的老游戏，请联系SDK接入技术

③请检查游戏是否有接入配置账号登录系统，可联系SDK接入技术

2.登录相关

2.1 九游单机SDK是否有账号体系？

①九游单机SDK有登录体系，如确认游戏需要接入登录，并且满足角色保存在服务器且一个账号对应一个角色，需联系对接技术获取单机登录文档(钉钉号：ztt0ula)，并提供gameId给其配置登录方可生效

③单机登录接口为非必接接口，请务必确认游戏有接登录需求再做接入

3.支付相关

3.1 单机SDK已收到初始化成功回调，调用支付接口时仍报错尚未完成初始化 Has not been initialized ，是什么原因？

①检查初始化接口参数gameId是否配置正确

②检查pay.png是否有配置(秘钥图片，必须配置)、路径是否错误(路径为：assets/UCPaySDK/pay.png，需注意大小写)、图片格式、图片命名是否有私自修改(不可更改)，如符合上述中任意一项，请重新到开发者后台-接入参数位置重新下载秘钥图片重新放置正确位置

③检查初始化接口gameId和pay.png是否为同一游戏，不可用demo包的pay.png，如不确认是否有问题请重新到开发者后台-接入参数位置重新下载图片，检查图片上游戏id信息是否一致

④如果是U3D、cocos2d等非原生引擎，请将ugpsdk-x.x.x.x-product-release.jar解压拷贝里面的assets到工程assets下

。

3.2调用支付接口无法正常调起支付，log报错

“初始化SDK过程失败!  授权失败：cn.uc.paysdk.face.commons.SDKError: Auth Server return error. status is not ok.code: INVALID_SIGN;msg:抱歉，系统异常，请稍后再试。”

以及 “初始化失败秘钥&游戏ID错误：code=-9”

游戏调用初始化接口传递的gameId跟assets/UCPaySDK/pay.png文件上展示的gameId不一致，请检查

3.3 调用支付接口无反应，log没有任何报错，已检查初始化传递gameId以及秘钥图片pay.png无误，是什么问题？

①请检查传递的支付参数格式是否和文档要求不一致，请改正

②请检查是否漏传APP_NAME 和 PRODUCT_NAME ，此为必传字段，请补齐

③如果接的SDK版本是9.X，targetSdkVersion 请不要设置超过26(当前版本SDK最高仅支持26)

3.4 调用支付接口直接走到支付失败回回调

①请检查manifest组件 cn.uc.paysdk.SDKActivity 是否漏配置，请补齐

②如果接的SDK版本是9.X，targetSdkVersion 请不要设置超过26(当前版本SDK最高仅支持26)

3.5 九游单机支付SDK有客户端支付成功回调么？

①九游单机SDK有客户端支付成功回调，在客户端支付成功回调中需要按照要求给SDK响应，否则会导致SDK一直通知而造成游戏多次发货。

②如游戏是使用服务端通知来判断发奖，客户端支付成功回调仍需要按照上面要求写死响应，避免SDK客户端的多次请求，如不按照要求，提审会被打回。

4.退出相关

4.1 游戏必须要调用SDK退出接口吗？有什么要求吗？

①游戏必须要调用SDK退出接口：exit(activity,params)

②需要在物理返回键调用，以及如果游戏内设置等功能内有设置退出游戏按钮，也需要调用SDK退出接口来退出

③SDK退出仅退出SDK，游戏资源需要自行在收到SDK退出成功回调内进行清除，否则二次启动游戏可能会闪退等：

@Subscribe(event = SDKEventKey.ON_EXIT_SUCC)

private void onExit(String desc) {

Toast.makeText(GameActivity.this, desc, Toast.LENGTH_SHORT).show();

GameActivity.this.finish();

// 退出程序

Intent intent = new Intent(Intent.ACTION_MAIN);

intent.addCategory(Intent.CATEGORY_HOME);

intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

startActivity(intent);

android.os.Process.killProcess(android.os.Process.myPid());

}

4.2 游戏在新手阶段或者游戏过程中，游戏的设计上就不允许操作返回键退出游戏，还需要调用退出SDK接口吗？

这种情况不需要调用SDK退出接口。 SDK退出接口是在返回可以大退到桌面的任何情况下，都需要调用SDK退出接口(除强制kill外)。

5.强更相关

5.1 单机SDK有强更机制么？游戏需要强更应该怎么处理？

①单机SDK没有强更功能，如游戏有强更需求，请提升游戏版本号后自行配置强更

②2019年2月份开始的新游，提审后平台会进行重签，此部分新游做游戏内置强更时，需在过审后从开发者后台提审包页面获取重签后的包回链给游戏技术配置回链。 不可直接配置游戏源包链接，否则旧包强更到新包后会因为签名不一致无法覆盖安装。 (SDK包内的《必读否则无法上线.txt》内有如何判断游戏是否是新游的方法)

6.Manifest相关

6.1 Manifest上的全部权限是否均需要添加？

是的。文档上提到的均为SDK需要用到，请全部正确地添加。

6.2 提审被打回，提示“组件：【activity】cn.uc.gamesdk.activity.PullupActivity属性android:scheme没有配置GameId: XXXX”， 应该怎么处理？

cn.uc.gamesdk.activity.PullupActivity下的属性android:scheme属性设置为ng+当前游戏的九游gameId

二．服务端

1.登录相关(非必接)

1.1 服务端接口-用户会话验证sid接口，报错返回：{"state":{"code":10,"msg":"请求校验的gameId与客户端的gameId，权限受限"},"id":1575968856,"data":{}}

客户端SDK初始化接口传递的gameId参数和sid校验接口传递的gameId不一致，请把参数日志打印出来自行检查

1.2 服务端接口-用户会话验证sid接口，报错返回：{"state":{"code":10,"msg":"系统繁忙，请稍后再试"},"id":1599033496558,"data":{}}

①打印请求原串，检查是否带有转义符号“\”，如有请去掉

②打印请求原串，检查game、data字段要求的json格式是否写成了String格式，请更正

2.支付相关

2.1 支付成功后，游戏服务器没有收到九游的回调通知

①请检查是否在客户端支付接口写入了回调地址notifyurl ，如有，优先回调到客户端写入的回调地址，而不会回调到后台配置的回调地址。 如不需要客户端回调，请直接删除

②后台配置地址成功后，需要半个小时后才生效

③可通过后台 “签约结算-支付详单” 找到对应订单信息，点击“明细”，下拉最后找到“通知CP地址”以及“通知描述”来查看当前订单通知地址以及游戏服务器响应的结果。 可手动操作补发来进行调试

④如通知描述写的是“查询不到用户的统一账户信息,延迟通知CP”，是因为下单的九游账号没有调用服务端接口1.3.1用户会话验证接口来生成对应的账号唯一标识accountId,请先调用此接口校验成功后，再进行支付测试。

2.2 支付成功后，游戏服务器收到九游的回调通知后无法正常解析

SDK回调请求内容均在body内，请正确获取body内容。例如：http_get_request_body：http://php.net/manual/it/function.http-get-request-body.php。具体请根据游戏使用的语言来处理。

三．其他

1.包名相关

1.1 单机正式包包名要求

①已经上过线的老游，包名和之前提审的正式包包名保持一致，无需更改后缀，亦不允许更换包名，否则无法覆盖老用户的旧包

②新游包名使用.aligames后缀，前缀无要求，游戏自定义即可，例如：com.abc.def.aligames

2.签名相关

2.1 提审后是否会对游戏包进行二签(重签)

①单机新有在提审过程会对游戏进行二签，老游不会重签。具体新老游区分方法在SDK包内的《必读否则无法上线.txt》文档内有说明

②二签后的回链，将在审核通过后于提审页面做返回，如有需要，请自行后台获取

③如游戏有接入微信分享，请提前把九游证书MD5：7b1a92ead48c3f489002428def69dfe7 到微信后台进行报备，否则二签后的包无法进行微信分享

④对于会被重签的新游，如游戏有做加固，请确保加固方支持平台进行二签

3.targetsdkversion相关

3.1 targetsdkversion目前最高支持到多少？最低支持到多少？

网游SDK9.X版本targetsdkversion目前最高仅支持到26，请不要设置高于26，否则强制打回。

应《移动应用软件高API等级预置与分发自律公约》要求，九游平台已强制游戏最低targetsdkversion=26。

4.角标相关

4.1 九游网游角标要求是什么

①网游游戏均需要配置九游角标

②角标素材下载地址：https://aligames.open.uc.cn/document/doc/detail/191

③角标可放置在icon的4个位置，但不可将角标的左右方向调转

④请确保apk下res内的全部icon图片均已添加角标

PS：角标已更新，请游戏使用新角标提审

5.第三方SDK接入相关

5.1 游戏是否可以使用其他第三方接入SDK例如易接SDK、quickSDK等来接入九游SDK？

不可以！并且游戏包内有任何残留其他第三方接入SDK的代码、文件夹等均不可以过审，请彻底删除。