OPPO SDK配置说明(网游)
一、接入前的准备
1、商务在开发者网站:http://open.keke.cn/ ,注册您的开发者账号
2、登陆账号后选择“我的APP”,点击“创建APP”,如图所示,
注意事项:
网游、棋牌游戏的包名需要统一以nearme.gamecenter结尾,否则无法通过审核;
应用发布后,请不要修改包名,一旦您修改了包名,就会被当做一个新的应用, 旧版用户也无法收到应用商店的升级提醒。
3、创建完app后,点击创建的应用,获取游戏所需的参数:游戏ID、AppKey和SecretKey
4、支付回调地址配置:在代码中已经配置,用户无需配置。
二、游众工具参数说明
1、游戏ID:商务在oppo后台申请的参数
2、游戏secret:商务在oppo后台申请的参数APPSecret
3、游戏key:商务在oppo后台申请的参数APPKey
4、横竖屏:设置登陆和支付界面的横竖屏,oppo的支付界面目前只能支持竖屏
三、注意事项
1、包名的要求:包名必须添加后缀 .nearme.gamecenter,应用发布后,请不要修改包名。
2、有游戏中心浮标,请确保onPause、onResume已经调用
四、常见问题
1、关于渠道SDKID
OPPO的渠道SDKID:{164B940D-82A0EC42}
游众服务器同步回调的SDKID格式为:164B940D82A0EC42。
2、如何切换账号以及切换账号的处理
浮标上点击切换账号,输入新的账号和密码,登录成功后会收到loginsuccess的回调, 失败后会收到loginfailed的回调。
3、登陆和支付界面是否支持横竖屏切换?
登陆界面支持,支付界面不支持,登陆界面的横竖屏可在游众工具上配置。
4、上传apk时,游戏名已经存在,如何解决?
把旧包删除,再上传新包或者把新包改名后再上传
如果只是为了拿到appkey,可以先创建应用,拿到appkey,等接完SDK后再上传apk 包,更新apk包名。
5、测试登录时,点击“快速注册”后,出现“获取验证码”,点击“获取验证码”,没有收到验证短信的原因。
手机号已经注册了,或者卡号不支持。
Oppo sdk只支持移动卡和联通卡快速注册,电信卡不支持快速注册。
6、支付拓展接口,调用实例:详情可参考demo。
public static void payExtend(Context context,intunitPrice,
String unitName, String itemCode, String remain,intcount,
String callBackInfo, String callBackUrl,
SFOnlinePayResultListener payResultListener)
该接口用于支付扩展接口函数。在支付时,可以设置商品描述。
参数描述:
参数名称 |
类型 |
注释 |
context |
Context |
上下文Activity |
unitPrice |
int |
游戏道具价格,单位为人民币分 |
unitName |
String |
商品名称,如60金币、100钻石等 |
itemCode |
String |
虚拟货币名称,如金币、钻石等 |
remain |
String |
商品描述。(限制长度为100) |
count |
int |
用户选择购买道具界面的默认道具数量。(总价为 count*unitPrice) |
callBackInfo |
String |
由游戏开发者定义传入的字符串,会与支付结果一同发送给游戏服务器,游戏服务器可通过该字段判断交易的详细内容(金额角色等) |
callBackUrl |
String |
将支付结果通知给游戏服务器时的通知地址url,交易结束后,系统会向该url发送http请求,通知交易的结果金额callbackInfo等信息 |
payResultListener |
SFOnlinePayResultListener |
支付回调接口 |
7、游戏必须调用setRoleData接口,确保zoneid、rolename、rolelevel传入正确。
8、游戏接入setdata接口:
public static void setData(Context context, String key,Object value)
1)若需要调用oppo的显示游戏中心接口,key 传入gamecenter,value的传入可参考以下例子:
SFOnlineHelper.setData(UserLoginView.this.getActivity(),"gamecenter", "");
2)若需要调用oppo的显示论坛接口,key 传入showforum,调用如下:
SFOnlineHelper.setData(UserLoginView.this.getActivity(),"showforum", "");