拇指游玩SDK接入说明（网游）

一、接入前的准备

游众

1、拇指官网：www.91muzhi.com

2、向拇指相关人员获取游戏所需参数appid、appkey等参数。商务:谢海源 电话：13500064025 QQ:158370213微信：tianya13143邮箱：xiehaiyuan@91muzhi.com网站:www.91muzhi.com具体申请流程，可以与商务交流。

3、支付结果地址配置：获取该渠道的游众平台回调地址。使用时请把回调地址中的APPID替换为在游众注册的应用ID，去掉大括号{}和中间的-。

二、游众工具参数说明

SDK配置：

1、应用ID：商务申请的应用ID

2、应用key：商务申请的应用key

3、ZTY_PACKET_ID：渠道号ID（可以设为“100”+应用ID+“001”）

4、兑换比例：一元兑换的游戏币。

5、横竖屏：设置登陆和支付界面的横竖屏。

6、游戏登录背景图片路径：选择游戏登录背景图片。

三、注意事项

1、包名的要求：包名无特殊要求。

2、无角标、闪屏、悬浮窗，如想自定义角标可在游众界面配置，如图

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

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

4、支付接口，通过增加计费点，设置虚拟币名称。

1、商品名称：要和pay接口传入的商品名称保持一致。

2、价格：单位为分，与pay接口的price*count保持一致，或者填0，则直接使用pay接口传入的金额。

3、亿元兑换的游戏币：1元兑换的游戏币数量，若填0，支付界面显示为套餐。

4、虚拟货币名称：不可带有数字。

上图为计费点截图；

如果用户需要设置虚拟货币，可在游众工具上增加相应的计费点，如上图，填写虚拟货币名称，商品兑换比例。

注意：在工具中添加计费点的信息确保正确。如果没有添加计费点，则虚拟货币的名称为pay接口传入的商品名称，商品兑换比例为游众工具参数中的商品兑换比例。如果有添加计费点，则虚拟货币的名称为计费点的虚拟货币名称，商品兑换比例为计费点的商品兑换比例。

支付拓展接口，调用实例：详情可参考demo。

 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	支付回调接口

四、常见问题

1、关于渠道SDKID

拇指的渠道SDKID：{C5486653-AD4CC696}

游众服务器支付回调的SDKID格式为：C5486653AD4CC696

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

点击登陆按钮会出现登录界面，点击登录后，如需切换账号，只需调用登出即可，然后在登录界面输入新的账号和密码登录即可。