回到顶部
TOP

常见接入问题

1、Icon问题
2、闪屏问题
3、更新问题
4、登录问题
5、支付问题
6、登出或切换帐号问题
7、退出问题
8、环境问题
9、apk无法安装问题
10、打包失败问题
11、接口检测不通过问题
12、横竖屏问题
13、游戏崩溃问题
14、游戏黑屏问题
15、换母包问题
16、混淆问题

Icon问题

01.上传自定义ICON后,打出的游戏包ICON无角标

替换的自定义ICON,不会自动进行角标添加操作,请联系运营同学获取渠道角标进行图标合成后上传。

02.游戏包安装后,桌面出现多个游戏ICON

请检查AndroidManifest.xml文件中是否有多个程序主入口,程序主入口为有如下声明的Activity。

< action android:name=”android.intent.action.MAIN” />
< category android:name=”android.intent.category.LAUNCHER” />

03.游戏安装后ICON显示不正常,如在大屏显示小图标,图片拉伸、图片模糊等

请检查是否有对应不同屏幕分辨率的ICON资源,且在正确的文件夹下,如hdpi文件夹下放置的ICON大小为72*72像素

闪屏问题

01.闪屏未铺满全屏,两侧存在边框

传入的闪屏图片大小不合适
传入的闪屏图片横竖屏错误
未设置正确的闪屏背景颜色,与闪屏图片不一致

02.游戏出现多个闪屏界面

游戏闪屏与我方闪屏同时存在

03.闪屏时间是多少

每屏闪屏显示为2秒,暂时无法控制显示时间

04.闪屏设置的背景颜色显示不对

设置背景颜色传入的RGB值格式不正确
设置背景颜色传入了错误的颜色值

05.游戏出现渠道无要求的闪屏图片

请勿添加渠道不要求或者不接受的闪屏图片

06.Android原生,Cocos2dx接入的游戏退出后又重启

闪屏的SplashActivity没有finish,造成重新回到闪屏界面

请在闪屏结束后finish掉SplashActivity

07.闪屏结束后,游戏崩溃

游戏包不完整,缺少游戏的so文件
载入游戏so文件的路径错误,请检查获取so路径的包名是否写死

更新问题

01.渠道、游戏、我方三者更新选其一,不可同时使用

我方提供了增量更新功能,可大大提高更新效率

登录问题

01.调不出渠道的登录窗口

检查后台配置参数是否正确,或者核实相关权限是否还未在渠道方申请。
检查母包(接入我方接口的游戏包)是否正确处理登录逻辑,因为存在通过CP在通过接口检测后重新上传母包的情况
游戏逻辑是否为打开游戏直接调用登录接口,如果是请延时调用登录接口看是否可以解决该问题,因为部分渠道有初始化操作,可能会出现渠道还未初始化完成调用登录的情况。

02.调出渠道的登录窗口,窗口无内容或者提示参数错误

检查后台配置参数是否正确,或者核实相关权限是否还未在渠道方申请。
检查游戏逻辑是否为开启游戏直接调用登录接口,如果是请延时调用登录接口看是否可以解决该问题,因为部分渠道有初始化操作,可能会出现渠道还未初始化完成调用登录的情况。

03.调出渠道的登录窗口,输入账号密码后点击登录按钮无反应

检查后台配置参数是否正确,或者核实相关权限是否还未在渠道方申请。
游戏逻辑是否为打开游戏直接调用登录接口,如果是请延时调用登录接口看是否可以解决该问题,因为部分渠道有初始化操作,可能会出现渠道还未初始化完成调用登录的情况。建议CP在游戏中加入登录按钮

04.调出渠道的登录窗口,提示安装服务或应用框架,游戏闪退或崩溃

部分渠道会在登录时如果手机没有安装渠道相关的服务或应用框架时,会先安装自己服务或应用框架,渠道会在这种情况下先给出登录失败的回调,查看游戏在登录失败时做了什么操作
安装服务或应用框架时有时会用到网络下载最新的框架包,如果出现网络异常或者下载的包有问题时,安装可能会出现闪退或崩溃的现象,如果多次复现,请联系运营解决

05.调出渠道的登录窗口,该渠道窗口是半透明窗口,窗口后面的游戏界面黑屏

检查游戏渲染是否有问题

06.调出多个登录窗口

建议游戏做防重复登录的操作

07.渠道账号登录成功,但是进入不了游戏

检查checkLogin的参数channel和productCode是否传错
检查登录成功后处理获取的token逻辑是否兼容多种情况,如token是json字符串
是否客户端和服务端都做了checkLogin,此时会出现部分渠道token无效,建议游戏在服务端的一方做checkLogin操作

08.登录成功,游戏闪退或崩溃

检查游戏处理逻辑是否正确,如是否存在登录成功做退出游戏的处理

09.登录失败,无法再次触发登录

检查游戏登录失败后的处理逻辑,是否在登录失败时再次调用登录接口

10.登录失败,游戏闪退或崩溃

检查游戏登录失败后的处理逻辑,是否在登录失败时做了退出游戏的处理

11.登录收不到回调

检查游戏接口setUserListener处理是否正确,如果处理正确,请联系运营

支付问题

01.点击支付,无法弹出支付界面

未开通支付
游戏传入的支付参数有误

02.点击支付,游戏崩溃

游戏传入的支付参数有误
缺少必要资源

03.弹出支付界面,没有支付方式

未开通支付权限
未向渠道提交游戏包名,回调地址等

04.弹出支付界面,提示参数有误

我方后台参数配置有误
渠道分配的参数异常

05.支付不成功

请联系运营解决

07.支付成功,道具不到账

若退出游戏重新进入后到账,则检查客户端回调是否异常,检查游戏逻辑是否正确
部分渠道充值后需要手动消耗渠道代币
游戏服务器服务异常到账无法正常接收通知
CP服务端返回值不正确
游戏客户端没有传入callbackUrl参数

08.点击一次支付后,无法再次点击支付

游戏在支付完成后,将程序挂起,等待支付回调,而渠道支付并不一定存在回调

建议游戏取消等待支付回调的操作

09.部分支付方式无法点击或者支付错误,游戏崩溃

渠道对部分第三方支付方式有Android版本要求,当游戏设置的targetSdkVersion不符合要求时,会出现此现象

10.安装支付插件失败或崩溃

缺少支付插件安装文件
部分渠道在缺少插件时返回失败回调,而游戏收到失败回调后进行其他操作

11.支付完成后游戏崩溃

游戏收到回调后调用自身方法错误

12.无法创建订单

游戏channelCode或者productCode值配置错误
网络异常

13.支付界面显示错误

支付参数传入有误
渠道参数配置错误

14.支付金额不发生变化

游戏在支付参数中传入了固定的金额

15.收到成功支付回调后,显示成功提示

游戏在收到支付成功回调后,直接进行支付成功的提示

支付成功与否不能以客户端回调为准,需以服务端通知为准,因此不应在收到回调后进行成功提示

16.闪屏横竖屏和游戏界面横竖屏不一致

AndroidManifest.xml中设置的screenOrientation属性与游戏其他节目不一致
闪屏图片横竖屏与游戏横竖屏不一致

17.横竖屏切换导致游戏花屏,崩溃,重新加载

相关activity未添加android:configChanges属性,或该属性的赋值不全
游戏渲染问题

登出或切换帐号问题

01.点击游戏内登出或切换帐号没效果,停留在当前游戏界面

请检查游戏处理登出逻辑是否正确,收到登出回调后,需要清空游戏角色信息及游戏内容并进行重新登陆操作。

02.点击渠道(悬浮窗或个人中心)登出或切换帐号没效果,停留在当前游戏界面

请检查游戏处理登出逻辑是否正确,收到登出回调后,需要清空游戏角色信息及游戏内容并进行重新登陆操作。

退出问题

01.点击确认退出按钮无反应

请检查游戏退出逻辑是否正确,请参照文档说明进行修正

02.无法弹出渠道退出界面

请先检查母包退出逻辑是否正确,若不正确请参照文档要求进行修改;若正确,请检查是否渠道是否需要开通退出页面显示权限

03.弹多个退出界面,如先弹游戏退出界面再弹渠道退出界面

请检查母包退出逻辑是否正确,若不正确请参照文档要求进行修改

04.点击返回键,不弹出退出界面,直接退出

请检查母包退出逻辑是否正确,若不正确请参照文档要求进行修改

05.多次点击返回键游戏黑屏

该问题一般是由于未对退出按钮进行监控,导致弹出多个退出框叠加导致,请对游戏退出逻辑进行监控,若当前游戏退出界面未关闭,用户再次点击返回键时勿要再弹退出界面

06.游戏退出不断重启

请检查游戏处理逻辑,检查闪屏activity是否finish

环境问题

01.unity无法导入unitypackage包

因为文件夹包含中文路径

apk无法安装问题

01.使用手机助手类软件安装apk提示该应用签名有问题,无法安装

如果手机中不存在该apk,请检查apk是否被签名,如果手机中已经存在该apk,则为当前安装的apk与手机中的apk签名不同,请卸载掉手机中的apk后再次尝试安装,或者使用手机中apk相同的签名后再次尝试安装

02.使用手机助手类软件安装apk提示未知错误

如果手机中已经存在该apk,请检查当前apk的versionCode版本是否低于手机中存在的apk的versionCode
如果确定不是versionCode的原因,可使用adb命令安装定位问题

03.使用adb install –r xxx.apk命令无法安装问题

提示:【INSTALL_PARSE_FAILED_NO_CERTIFICATES】

解释:安装的当前apk没有被签名,请签名后重新安装


提示:【INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES】

解释:安装的当前apk的签名与手机中安装的apk的签名不同,请先卸载掉手机中的apk后再次尝试安装,或者使用与手机中的apk相同的签名后覆盖安装


提示:【INSTALL_FAILED_VERSION_DOWNGRADE】

解释:安装的当前apk的versionCode低于手机中安装的apk的versionCode

04.下载apk的文件大小明显小于上传母包的文件大小,安装失败

检查是否上传错了母包,或者在下载的过程中文件有损坏,如果具体无法解决可联系运营

打包失败问题

01.合并AndroidManifest文件错误

AndroidManifest中存在不可见字符,可使用Eclipse的格式化快捷键Ctrl+Shift+F进行排查
AndroidManifest中存在特殊字符,请删除特殊字符后重新打包

02.签名apk错误

签名文件与密码是否一致

03.生成APK文件错误

游戏内资源文件与渠道的资源文件命名相同,请联系运营确认冲突资源

04.SDK预处理错误

05.重新生成R文件错误

06.合并APK错误

07.处理类没找到

08.升级SDK错误

以上04-08问题请联系运营解决

接口检测不通过问题

注:以下问题多为各个引擎综合遇到的问题,如果是java原生所遇到的具体接口,请参照java原生Demo和文档,检查是否调用和正确处理接口

01.包名检测不通过

Java原生接入请检查AndroidManifest.xml中的package的值是否是要求的包名
Cocos2dx接入请检查AndroidManifest.xml中的package的值是否是要求的包名
Unity接入请检查工程中的Bundle Identifier中的值是否是要求的包名
AdobeAir接入请检查工程中xml文件中的id节点值是否是要求的包名

02.SDK初始化

XMSplashActivity接口未通过,请检查是否将闪屏设置为游戏入口

03.Activity生命周期接口

onDestory接口未通过,Unity引擎接入、Cocos2dx引擎接入和AdobeAir引擎接入请检查在游戏退出逻辑中调用了释放资源接口;java原生请检查onDestory接口是否接入。

04.用户相关接口

checkLogin接口未通过

请确认游戏服务端做了checkLogin的操作
请检查checkLogin的channel和productCode的值是否正确
请检查checkLogin的token处理是否正确

enterServer、createRole或levelUp接口未通过

请确认游戏接入用户(玩家)信息扩展接口
接入用户(玩家)信息扩展接口时,_id的三种情况(enterServer\createRole\levelUp)都在相应的情况下调用

05.支付接口

通过该接口需要真实支付1¥且充值到账才可通过,如果支付后未通过,请检查回调地址是否正确或可访问

06.退出接口

applicationDestory接口未通过,Unity引擎接入、Cocos2dx引擎接入和AdobeAir引擎接入请检查在游戏退出逻辑中调用了释放资源接口;java原生请检查applicationDestory接口是否接入。

横竖屏问题

01.闪屏横竖屏和游戏界面横竖屏不一致

AndroidManifest.xml中设置的screenOrientation属性与游戏其他节目不一致
闪屏图片横竖屏与游戏横竖屏不一致

02.横竖屏切换导致游戏花屏,崩溃,重新加载

相关activity未添加android:configChanges属性,或该属性的赋值不全
游戏渲染问题

游戏崩溃问题

01.游戏启动崩溃

缺少so文件

02.调用我方接口崩溃

参数未按规定传入

03.母包点击支付崩溃

资源未复制完整(如assets文件)

04.游戏进入后台崩溃

游戏质量不佳

游戏黑屏问题

01.弹出半透明登陆或支付框,后面游戏黑屏

渠道SDK实现方式与游戏开发引擎存在渲染问题

02.弹出半透明登陆或支付框,按HOME键返回到手机桌面,再次进入游戏,游戏黑屏

渠道SDK实现方式与游戏开发引擎存在渲染问题

换母包问题

01.之前母包没有问题,可是打出的渠道包却有问题

请确认在打渠道包测试过程中是否替换过母包,如果替换母包,请先测试母包是否有相同的问题,检查无误后请联系运营

混淆问题

01.调用我方接口不正常等

混淆游戏代码时,误将我方代码也进行混淆(参考接入文档,勿混淆我方相关代码)

 

 

向上
向下