悠悠村SDK配置说明(网游)
一、接入前的准备
1. 向商务人员获取游戏所需参数:Appkey,应用密钥、DES密钥、渠道名称。
商务人员联系方式:
姓名:鲍能
QQ:234084010
2. 支付回调地址配置:在代码中已经配置,用户无需配置。
小于等于20元使用短代,只支持偶数计费 ,不支持的短信计费代码使用第三方支付,短代支付服务器端是没有回调的,以客户端为准;大于20元使用支付宝支付,服务器端能收到支付结果通知。
二、游众工具参数说明
SDK信息:
1.游戏名称:应用的名字
2.渠道名称:向商务申请的参数
3.Appkey:向商务申请的参数,应用的唯一标识
4.应用密钥:向商务申请的参数
5.DES密钥:向商务申请的参数
6.是否支持切换账号 切换账号的功能指的是动态切换账号的功能,如果支持的话,点击浮标进入账号管理界面内的切换账号后将不需要重启游戏就可以切换账号,如果不支持的话,必须重启游戏才能实现切换账号的功能。
三、注意事项
1. 包名必须以 uucun结尾。
2. 关于计费点:
计费点信息配置:
-
支付类型:选择支付的方式
1.计费类型:选择短信支付则必填。分为四种类型:注册,道具,下载付费,包月
2.商品名称:商品的名字
3.商品编号:长度不超过20位
4.虚拟货币名称:例如:金币
5.价格(单位分):商品的价格,短信支付价格必须是偶数
6.商品兑换比例:1元人民币对应的虚拟币值。例:一元人民币可兑换10个虚拟币,那么填10。
在调用支付接口时,对应商品名称和价格要和在游众工具上配置的计费点商品名称和价格一致。
例如:SFOnlineHelper.pay(MainActivity.this, 600, "10金币", 1,"购买钻石", CP_PAY_SYNC_URL, new SFOnlinePayResultListener()
SFOnlineHelper.charge(MainActivity.this, "10金币", 600, 1,"购买金币", CP_PAY_SYNC_URL, new SFOnlinePayResultListener()。3、支付扩展接口
使用支付拓展接口,调用实例:详情可参考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
虚拟货币名称
itemCode
String
商品编号
remain
String
自定义参数。自定义参数以; (英文)分隔
顺序如下:
第一个参数:支付类型:0:短信 1:第三方
第二个参数:计费类型:0:注册 1:道具 2:下载付费 3:包月
第三个参数:虚拟货币名称
第四个参数:商品兑换比例
count
int
用户选择购买道具界面的默认道具数量。(总价为 count*unitPrice)
callBackInfo
String
由游戏开发者定义传入的字符串,会与支付结果一同发送给游戏服务器,游戏服务器可通过该字段判断交易的详细内容(金额角色等)
callBackUrl
String
将支付结果通知给游戏服务器时的通知地址url,交易结束后,系统会向该url发送http请求,通知交易的结果金额callbackInfo等信息
payResultListener
SFOnlinePayResultListener
支付回调接口
4、关于扩展接口
public static void setData(Context context, String key,Object value)
如果需要进入账号设置界面,可以调用该接口,如果不需要,无须调用。
四、常见问题
- 关于渠道SDKID
悠悠村的渠道SDKID:{8C65AC64-3E812F5B}
游众服务器支付回调的SDKID格式为:8C65AC643E812F5B。
- 出现计费不成功的提示是什么问题?
首先请检查sim卡是否可用。比如:sim卡没有或者sim卡没有被系统识别,导致短信服务异常;sim卡已无可用金额也会导致此问题。
其次请检查传入计费的参数有没有问题。
3.“一键付”点击确认支付,出现如下界面:
这里红框的显示,是按照:“商品兑换比例率*价格(元)”+“虚拟货币名称” 来显示的。
4、点击浮标进入账号管理界面后,关闭此界面,为什么又会收到onLoginSuccess的回调呢?
悠悠村比较特殊,客户需要在onloginsuccess中保存第一次返回的channeluserid,之后接口返回的channeluserid需要与第一次保存的值相比较,相同的话就不需要处理,不同的话就说明用户已切换账号,需要游戏去做重新登录验证的处理。
5、cocos环境的游戏在点击支付之后,游戏自动退出,支付界面还在?
将manifest.xml文件中AppActivity的android:configChanges属性修改 android:configChanges="keyboardHidden|navigation|orientation|screenSize。