靠谱助手 SDK配置说明

一、接入前的准备

1、联系靠谱助手，获取渠道参数APPID、APPKEY、APPSECRET等。联系方式：（QQ）1141259905

2、配置支付回调地址联系靠谱助手，配置支付回调地址。靠谱助手的支付回调地址。（使用时请把回调地址中的{APPID}替换为在游众注册的应用ID,使用时去掉appid的{}和-）

二、游众工具参数说明

1）SDK配置

1.APPID：联系渠道获取。

2.APPKEY：联系渠道获取。

3.APPSECRET：联系渠道获取。

4.CHANNELID：联系渠道获取。

5.后台加密json文件：选择加密json文件，由靠谱助手客服提供。

2）计费点配置：

①若使用支付拓展接口payextend，工具上可以不填写计费点信息，支付拓展接口的使用如下：

 public static void payExtend(Context context,int unitPrice,
		String unitName, String itemCode, String remain,int count, 
		String callBackInfo, String callBackUrl,
		SFOnlinePayResultListener payResultListener) 

该接口用于支付扩展接口函数。在支付时，可以设置不同商品的兑换比例，此时游众工具上设置的商品兑换比例无效,支付界面会根据比率和价格计算出商品的数量

参数描述:

参数名称	类型	注释
context	Context	上下文Activity
unitPrice	int	游戏道具价格，单位为人民币分
unitName	String	商品名称
itemCode	String	可以传null，这里填的是虚拟货币名称
remain	String	这里填的是商品兑换比率：比如100。
count	int	用户选择购买道具界面的默认道具数量。（总价为 count*unitPrice）
callBackInfo	String	由游戏开发者定义传入的字符串，会与支付结果一同发送给游戏服务器，游戏服务器可通过该字段判断交易的详细内容（金额角色等）
callBackUrl	String	将支付结果通知给游戏服务器时的通知地址url，交易结束后，系统会向该url发送http请求，通知交易的结果金额callbackInfo等信息
payResultListener	SFOnlinePayResultListener	支付回调接口

②使用pay或者charge接口，需要配置计费点。

1、商品名称：所购买的商品的名称，需要与pay（或charge）接口传入的itemName保持一致。

2、价格：商品的价格，单位为分。要与pay接口的count和unitPrice的乘积一致。

3、一元兑换的游戏币：一元可以购买的游戏币数量，同SDK配置界面的第7个参数，此时SDK配置界面的比例无效，而是使用计费点界面的比例。

4、虚拟货币名称：货币名称，不带有数字。如商品名称为“60钻石”，虚拟币填写“钻石”。

三、注意事项

1、包名要与在靠谱后台填写的包名保持一致,已.kaopu结尾。

2、无闪屏，无角标。

3、有浮标，登陆后自动出现，确保调用了onDestroy、onPause和onResume。

4、游戏必须接入设置角色接口，请确保zoneid，roleName参数传入正确，例如：

 SFOnlineHelper.setRoleData(UserLoginView.this.getActivity(), "1", "猎人", "100", "1", "默认区间"); 

四、常见问题

1、如何切换账号以及切换账号的处理

进入浮标里的“账户”，点击【切换账号】即可进行账号的切换。要求在登出里调用登录接口，具体可以参考demo。

2、登陆和支付界面是否支持横竖屏切换？

支付界面的横竖屏可以在工具上设置，登陆界面横竖屏可自动切换。

3、关于渠道SDKID

靠谱助手的渠道SDKID为：{11AEE396-DB063871}

4、参数都正确，但是为什么点击登陆游戏会闪退？

这一般是由于靠谱助手客服给的加密json文件有些问题造成的，需要寻找靠谱助手技术支持重新给一份json文件。