西瓜SDK（原生 IOS 版）接入文档

1. 文档概述

此文档为使用原生 IOS 游戏客户端的接入文档。接入前请先根据iOS打包工具使用指南注入西瓜资源。本文介绍如何在原生平台下，IOS 游戏客户端快速接入西瓜SDK。
文档包括了2种类型的接口，主动调用接口和回调函数接口其中主动调用分别为： 必选接口、可选接口、统计接口、扩展接口、分享接口、推送接口、绑定手机号接口、问卷调查接口 ，便于游戏方的接入人员可以按照需求更加快速便捷的进行接入。

1.1 文档结构

文档概述
- 文档结构
快速接入简介
用户接口
充值接口
- 支付接口（必接）
- 支付回调
统计接口
扩展接口
运营活动接口

2. 快速接入简

iOS开发环境如下:
适用于iOS7.0及其以上操作系统的设备
开发工具: Xcode

3. 用户接口

导入头文件

#import "XGSDK.h"

3.1 初始化接口（必接）

初始化
接口说明：应用加载结束后，即： - (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions {}中调用。
参数说明：

customInfo 扩展字段，暂时不用传值

xgsdkDelegate 回调接收类。请先实现XgsdkDelegate中的方法

-(void)XGInitWith:(NSString *)customInfo xgsdkDelegate:(id) xgsdkDelegate;

3.2 初始化回调

初始化回调参数说明：

code 0为成功，其他为失败

msg 消息描述

-(void) onInitFinishWithResultCode:(NSInteger) code resultMsg: (NSString*) msg;

3.3 登陆接口（必接）

3.4 登陆回调

登录成功
参数说明：

code 登录成功结果码，固定为0

authInfo 用于做登录验证的加密串

-(void) onLoginSuccessWithResultCode:(NSInteger) code authInfo: (NSString*) authInfo;
登录失败参数说明：

code 登录失败结果码，固定为1

msg 消息描述

channelCode 渠道返回的登录错误码

-(void) onLoginFailWithResultCode:(NSInteger) code resultMsg: (NSString) msg channelCode:(NSString) channelCode;
登录取消参数说明：

code 登录取消结果码，固定为2

msg 消息描述

-(void) onLoginCancelWithResultCode:(NSInteger) code resultMsg:(NSString*) msg;

3.5 登出接口

登出
接口说明：退出游戏时调用。
参数说明：

customInfo 扩展字段，暂时不用传值

-(void)XGLogout:(NSString *)customInfo;

3.6 登出回调

登出回调参数说明：

code 登出结果码，固定为0

msg 消息描述

-(void) onLogoutFinishWithResultCode:(NSInteger) code resultMsg:(NSString*) msg;

4.充值接口

4.1 支付接口（必接）

支付
接口说明：购买时调用。将拉起支付界面。
参数说明：

buyInfo 值对象，其属性定义和安卓一致

-(void)XGPaymentWithBuyInfo:(XGBuyInfo*)buyInfo;

关于 PayInfo 的成员说明

所有必字段必须进行接入，否则会导致部分渠道无法支付！

请严格按照西瓜规定的字段长度进行设置，否则可能发生游戏服务器端长度不够问题。</p>

参数	参数类型	最大长度	说明	必须
uid	String	128	用户ID,游戏必须使用登录时西瓜服务器返回的uid	Y
productId	String	64	商品ID	Y
productName	String	64	商品名称	Y
productDesc	String	128	商品描述	Y
productUnit	String	64	商品单位，例如元宝	Y
productUnitPrice	int	10	商品单价,单位分（无需传，以后版本会去掉）	N
productQuantity	int	10	产品数量，例如购买60元宝则传60	Y
totalAmount	int	10	商品总金额,单位分	Y
payAmount	int	10	实际支付总额,单位分	Y
currencyName	String	64	海外渠道必传：实际支付的国际标准货币代码，比如CNY(人民币)/USD(美元)	Y
roleId	String	32	角色ID	Y
roleName	String	64	角色名称	Y
roleLevel	int	32	角色等级	Y
roleVipLevel	String	32	角色vip等级	Y
serverId	String	32	服ID：必须为纯数字，且不能超过2147483647（应用宝渠道要求）	Y
zoneId	String	32	区ID	Y
partyName	String	32	帮会名称	N
virtualCurrencyBalance	String		虚拟货币余额，需要此字段的渠道：快发、小米、VIVO	Y
customInfo	String	2000	扩展字段，订单支付成功后，透传给游戏	N
gameTradeNo	String	64	游戏订单ID，支付成功后，透传给游戏	N
gameCallbackUrl	String	128	支付回调地址，如果为空，则后台配置的回调地址	N
additionalParams	String		扩展参数	N

常用的国际货币

国家	货币中文名	货币英文名	货币代码
中国	人民币元	RenminbiYuan	CNY
韩国	韩圆	Korean Won	KRW
日本	日元	Japanese Yen	JPY
美国	美元	U.S.Dollar	USD

支付场景

场景一：某个玩家，购买750钻石（价值80元），创建订单参数是：

productId	11111
payAmount 实际支付总额(单位分)	8000
totalAmount 商品总金额(单位分)	8000
productName 商品名称	750钻石
productQuantity 商品数量	750
productUnit 商品单位	钻石
productUnitPrice 商品单价(单位分)	无需传

场景二：某个玩家，遇到商品打折优惠：购买750钻石（价值80元）可享受8.5折优惠，这样其实玩家是用68元购买了750钻石，创建订单参数是：

productId	222
payAmount 实际支付总额(单位分)	6800
totalAmount 商品总金额(单位分)	8000(折前原价)
productName 商品名称	750钻石
productQuantity 商品数量	750
productUnit 商品单位	钻石
productUnitPrice 商品单价(单位分)	无需传

场景三：某个玩家，购买月卡（价值30元），创建订单参数是：

productId	333
payAmount 实际支付总额(单位分)	3000
totalAmount 商品总金额(单位分)	3000
productName 商品名称	月卡
productQuantity 商品数量	1
productUnit 商品单位	月卡
productUnitPrice 商品单价(单位分)	无需传

4.2 支付回调

在调用 pay 接口时，需要实现 pay 支付回调 (支付的四种状态：支付成功，支付失败，支付取消,支付其他状态）。

支付成功
参数说明：

code 支付成功结果码，固定为0

msg 消息描述

gameTradeNo 游戏订单号

xgTradeNo 西瓜sdk订单号

-(void) onPaySuccessWithResultCode:(NSInteger) code resultMsg:(NSString) msg gameTradeNO:(NSString) gameTradeNo xgTradeNO:(NSString*) xgTradeNo;

支付取消
参数说明：

code 支付取消结果码，固定为1

msg 消息描述

gameTradeNo 游戏订单号

channelCode 渠道结果码

channelMsg 渠道结果信息

-(void) onPayCancelWithResultCode:(NSInteger) code resultMsg:(NSString) msg gameTradeNO:(NSString) gameTradeNo channelCode:(NSString) channelCode channelMsg:(NSString) channelMsg;

支付失败
参数说明：

code 支付失败结果码，固定为2

msg 消息描述

gameTradeNo 游戏订单号

channelCode 渠道结果码

channelMsg 渠道结果信息

-(void) onPayFailWithResultCode:(NSInteger) code resultMsg:(NSString) msg gameTradeNO:(NSString) gameTradeNo channelCode:(NSString) channelCode channelMsg:(NSString) channelMsg;
支付正在进行
参数说明：

code 支付失败结果码，固定为5

msg 消息描述

gameTradeNo 游戏订单号

channelCode 渠道结果码

channelMsg 渠道结果信息

备注：此时说明支付过程尚未完成，需等待。建议游戏给玩家以提示，并限制玩家的再次购买请求。
-(void) onPayProgressWithResultCode:(NSInteger) code resultMsg:(NSString) msg gameTradeNO:(NSString) gameTradeNo channelCode:(NSString) channelCode channelMsg:(NSString) channelMsg;

支付完成、结果未知
参数说明：

code 支付失败结果码，固定为3

msg 消息描述

gameTradeNo 游戏订单号

channelCode 渠道结果码

channelMsg 渠道结果信息

-(void) onPayOthersWithResultCode:(NSInteger) code resultMsg:(NSString) msg gameTradeNO:(NSString) gameTradeNo channelCode:(NSString) channelCode channelMsg:(NSString) channelMsg;

5.统计接口

5.1 创建角色（必接）

角色注册

接口说明：角色注册时调用（游戏接入监控数据时调用）。

参数说明：

roleInfo 值对象，属性定义和Android一致

-(void) onCreateRole:(XGRoleInfo*) roleInfo

关于 RoleInfo 的成员说明：

所有必字段必须进行接入，否则会导致统计不完全，部分渠道审核无法通过！

请严格按照西瓜规定的字段长度进行设置，否则可能发生游戏服务器端长度不够问题。

参数	参数类型	最大长度	说明	必须
uid	string	128	用户ID,游戏必须使用登录时西瓜服务器返回的uid	Y
serverId	string	32	服ID：必须为纯数字，且不能超过2147483647（应用宝渠道要求）	Y
serverName	string	64	游戏必须传入真实的游戏服名称,建议中文	Y
zoneId	string	32	游戏区ID	Y
zoneName	string	64	游戏大区名称：要与界面显示名称一致，如：界面显示（一区桃园结义），zoneName也必须传（一区桃园结义）	Y
roleId	string	32	角色ID	Y
roleName	string	64	角色名	Y
roleType	string	20	角色类型，如法师，道士，战士	N
roleCreateTime	string	10	角色创建时间（Unix时间戳，单位秒），如：1461722392	Y
roleLevel	int	32	角色等级,游戏必须传入真实的角色等级	Y
roleVipLevel	int	32	角色vip等级	N
partyName	string	32	公会名	N
gender	string	枚举值：m,f;分别代表男女	角色性别	N
balance	string	128	角色账户余额	N

5.2 角色升级（必接）

等级提升
接口说明：角色提升时调用。
参数说明：

roleInfo 值对象，参考xgsdk.h中其属性定义即可

-(void) onRoleLevelUp:(XGRoleInfo*) roleInfo;

5.3 进入游戏（必接）

进入游戏
接口说明：登录成功后，正式进入游戏时调用。
参数说明：

roleInfo 值对象，属性定义和安卓平台一致

-(void) onEnterGame:(XGRoleInfo*) roleInfo;

5.3 账号注册

账号注册
接口说明：账号注册时调用（游戏接入监控数据情况下调用）
参数说明:

accountId 账号ID

serverId 服务器ID

serverName 服务器名称

serverVersion 服务器版本号

zoneId 区ID

zoneName 区名称

extendParams 扩展参数

-(void)XGAccountCreateWithAccountId:(NSString )accountId serverId:(NSString )serverId serverName:(NSString *)serverName
```
                 serverVersion:(NSString *)serverVersion
                        zoneId:(NSString *)zoneId
                      zoneName:(NSString *)zoneName
                       extends:(NSDictionary *)extendParams;
```

6.扩展接口

6.1 切换账号

切换账号
接口说明：切换账号时使用
参数说明：无
-(void)XGSwitchUser;

6.2 自定义事件

自定义事件接口说明：使用自定义事件方式上报。
参数说明:

roleInfo 值对象，参考xgsdk.h中其属性定义即可

eventId 事件id

eventDesc 事件描述

eventValue 事件内容

eventBody JSON字符串

-(void) onEvent:(XGRoleInfo) roleInfo eventId:(NSString) eventID enventDesc:(NSString)eventDesc eventValue:(NSString)eventValue eventBody:(NSString*) eventContent;

6.3 任务开始

任务开始
接口说明：进入某个任务或关卡时调用。
参数说明：

roleInfo 值对象，参考xgsdk.h中其属性定义即可

missionId 任务号

missionName 任务名称

customParams 自定义参数（json格式字符串）

-(void) onMissionBegin:(XGRoleInfo) roleInfo missionId:(NSString) missionId missionName:(NSString)missionName customParams:(NSString)customParams;

6.4 任务成功

任务成功
接口说明：任务或关卡成功时调用。参数说明：

roleInfo 值对象，参考xgsdk.h中其属性定义即可

missionId 任务号

missionName 任务名称

customParams 自定义参数（json格式字符串）

-(void) onMissionSuccess:(XGRoleInfo) roleInfo missionId:(NSString) missionId missionName:(NSString)missionName customParams:(NSString)customParams;

6.5 任务失败

任务失败
接口说明：任务或关卡失败时调用。参数说明：

roleInfo 值对象，参考xgsdk.h中其属性定义即可

missionId 任务号

missionName 任务名称

customParams 自定义参数（json格式字符串）

-(void) onMissionFail:(XGRoleInfo) roleInfo missionId:(NSString) missionId missionName:(NSString)missionName customParams:(NSString)customParams;

6.6 购买虚拟货币

虚拟货币购买
接口说明：购买虚拟货币（如元宝）成功时调用。
参数说明：

amount	数量
gameTradeNo	订单号
name	可选字段，包括元宝、绑定元宝、银两、声望、真气、家族贡献、侠义、天梯阅历
currencyTotal	可选字段，最新的代币数量

-(void) onVirtualCurrencyPurchaseWithAmount:(NSString)amount gameTradeNo:(NSString )gameTradeNo currencyName:(NSString )name andCurrencyTotal:(NSString )currencyTotal;

6.7 赠送虚拟货币

虚拟货币获赠
接口说明：获得奖励时调用。
参数说明：

reason	获得奖励的原因
amount	数量
gameTradeNo	订单号
name	可选字段，包括元宝、绑定元宝、银两、声望、真气、家族贡献、侠义、天梯阅历
currencyTotal	可选字段，最新的代币数量

-(void) onVirtualCurrencyRewardWithReason:(NSString)reason amount:(NSString)amount gameTradeNo:(NSString )gameTradeNo currencyName:(NSString )name currencyTotal:(NSString )currencyTotal andGainChannelType:(NSString )gainChannelType;

6.8 消费虚拟货币

虚拟货币消费
接口说明：消费虚拟货币（如元宝）时调用。
参数说明：

itemName	消费项目
amount	数量
currencyName	可选字段，包括元宝、绑定元宝、银两、声望、真气、家族贡献、侠义、天梯阅历
currencyTotal	可选字段，最新的代币数量
itemNum	标示消费得到的道具的数量
itemType	道具分类

-(void)onVirtualCurrencyConsumeWithItemName:(NSString)itemName amount:(NSString)amount currencyName:(NSString )currencyName currencyTotal:(NSString )currencyTotal itemNum:(NSString )itemNum andItemType:(NSString )itemType;

6.9 通用接口（选接，在西瓜api 2.2.7版本以上使用）

通用接口
接口说明：通过当前接口，来调用部分渠道的特殊接口

参数	说明
methodName	特殊接口的方法名
param	调用接口时，所需要的参数
callback	回调信息，具体内容按照各接口区分
customInfo	透传信息，会在回调信息中透传回来

-(void)XGCallMethod:(NSString )methodName methodParam:(NSDictionary )methodParam customInfo:(NSString *)customInfo;

6.10 游戏加载完成

接口说明：游戏加载资源完成时调用该接口，发送相关信息（如有该过程则必接)。
-(void) onGameLoadResource;

6.11 游戏加载配置完成

接口说明：游戏加载配置完成时调用该接口，发送相关信息（如有该过程则必接）。
-(void) onGameLoadConfig;

6.12 用户打开公告

接口说明：用户打开公告时调用该接口，发送相关信息（如有该过程则必接）。
-(void) onOpenAnnouncement;

6.13 用户关闭公告

接口说明：用户关闭公告时调用该接口，发送相关信息（如有该过程则必接）。
-(void) onCloseAnnouncement;

6.14 用户完成新手任务

接口说明：用户完成新手任务时调用该接口，发送相关信息（如有该过程则必接）。参数说明：

roleInfo

值对象，参考xgsdk.h中其属性定义即可 </tr> </table>
-(void) onNewUserMission:(XGRoleInfo *)roleInfo;

6.15 用户使用专用的功能码

接口说明：用户使用专用的功能码（激活码、礼品码等）时，调用该接口，发送相关信息。参数说明：

roleInfo

值对象，参考xgsdk.h中其属性定义即可 </tr>

funCode

码值 </tr>

funCodeDesc

码的描述 </tr>

funCodeType

码的类型 </tr>

funCodebatchId

码的批号 </tr> </table>
-(void) onPrivateFunCodeUse:(XGRoleInfo )roleInfo funCode:(NSString )funCode funCodeDesc:(NSString )funCodeDesc funCodeType:(NSString )funCodeType funCodeBatchId:(NSString *)funCodeBatchId;

6.16 用户使用公用的功能码

接口说明：用户使用公用的功能码（激活码、礼品码等）时，调用该接口，发送相关信息。参数说明：

roleInfo

值对象，参考xgsdk.h中其属性定义即可 </tr>

funCode

码值 </tr>

funCodeDesc

码的描述 </tr>

funCodeType

码的类型 </tr>

funCodebatchId

码的批号 </tr> </table>
-(void) onPublicFunCodeUse:(XGRoleInfo )roleInfo funCode:(NSString )funCode funCodeDesc:(NSString )funCodeDesc funCodeType:(NSString )funCodeType funCodeBatchId:(NSString *)funCodeBatchId;

6.17 推送接口

若游戏选择接入xgsdk的推送功能，则需要调用本接口。
-(void)setPushActivityBlock:(void (^)(NSString activity ,NSString jsonParam))block;

7.运营活动接口

7.1 礼包码兑换，绑定手机号(西瓜提供页面)

开启活动页面
接口说明：
```
  <td>uid</td>
  <td>玩家uid</td>
```
</tr>
```
  <td>roleId</td>
  <td>玩家角色ID</td>
```
</tr>
```
  <td>zoneId</td>
  <td>游戏区ID</td>
```
</tr>
```
  <td>serverId</td>
  <td>游戏服ID</td>
```
</tr> </table> -(void) showGiftViewWithUid:(NSString )uid roleId:(NSString )roleId zoneId:(NSString )zoneId serverId:(NSString )serverId;

参数说明

7.2 礼包码兑换（游戏提供界面）

礼包码兑换接口说明:

  <td>uid</td>
  <td>玩家uid</td>

</tr>

  <td>roleId</td>
  <td>玩家角色ID</td>

</tr>

  <td>zoneId</td>
  <td>游戏区ID</td>

</tr>

  <td>serverId</td>
  <td>游戏服ID</td>

</tr>

  <td>giftCode</td>
  <td>礼包码</td>

</tr>

  <td>success</td>
  <td>兑换成功回调</td>

</tr>

  <tr>
  <td>failure</td>
  <td>兑换失败回调</td>

</tr> </table> -(void) convertGiftUid:(NSString )uid roleId:(NSString )roleId zoneId:(NSString )zoneId serverId:(NSString )serverId andCode:(NSString )giftCode success:(void(^)(id responseObject)) success failure:(void(^)(NSError error)) failure;

参数

说明

7.3 绑定手机号（游戏提供界面）

发送验证码
接口说明：发送验证码
参数说明：

bindMobileInfo 发送手机短信验证码所需信息

-(void) xgSendCaptcha:(XGBindMobileInfo *)bindMobileInfo;

关于 XGBindMobileInfo 的成员说明：

所有必字段必须进行接入

参数	参数类型	最大长度	说明	必须
mobile	string	11	手机号	Y
uid	string	128	用户ID,游戏必须使用登录时西瓜服务器返回的uid	Y
serverId	string	32	游戏服ID	Y
zoneId	string	32	区ID	Y
roleId	string	32	角色ID	Y
roleName	string	64	角色名	Y

发送验证码回调接口说明：发送验证码回调参数说明：

code 0为成功，其他为失败

msg 消息描述

-(void) onSendCaptchaFinish:(NSString )code msg:(NSString )msg;

绑定手机号
接口说明:绑定手机号
参数说明:

bindMobileInfo 值对象，参考xgsdk.h中其属性定义即可

captcha 手机收到的验证码

-(void) xgBindMibile:(XGBindMobileInfo )bindMobileInfo captcha:(NSString )captcha;

关于 BindMobileInfo 的成员说明：

所有必字段必须进行接入

参数	参数类型	最大长度	说明	必须
mobile	string	11	手机号	Y
uid	string	128	用户ID,游戏必须使用登录时西瓜服务器返回的uid	Y
serverId	string	32	游戏服ID	Y
zoneId	string	32	区ID	Y
roleId	string	32	角色ID	Y
roleName	string	64	角色名	Y

绑定手机号回调接口说明：绑定手机号回调参数说明：

code 0为成功，其他为失败

msg 消息描述

-(void) onBindMobileFinish:(NSString )code msg:(NSString )msg;
使用帐号查询绑定状态
接口说明：使用帐号查询是否已绑定手机
参数说明：

uid 登陆帐号

-(void) xgGetBindInfoByUid:(NSString *)uid;
使用帐号查询绑定状态回调
接口说明：绑定手机号回调
参数说明：

code 0为成功，其他为失败

msg 消息描述

-(void) onGetBindInfoByUid:(NSString )code msg:(NSString )msg;
使用手机号查询绑定状态
接口说明：使用帐号查询是否已绑定手机
参数说明：

mobile 手机号码

-(void) xgGetBindInfoByMobile:(NSString *)mobile;

使用手机号查询绑定状态回调
接口说明：绑定手机号回调参数说明：

code 0为成功，其他为失败

msg 消息描述

-(void) onGetBindInfoByMobile:(NSString )code msg:(NSString )msg;

7.4 问卷调查

问卷的内容和完成问卷返回的礼品信息，需要联系西瓜数据和运营人员设定完成。

7.4.1 刷新问卷

刷新问卷接口说明: 游戏初始化问卷后手动调用刷新问卷，查看问卷是否更新。参数说明:：

roleInfo 值对象，参考xgsdk.h中其属性定义即可

questInfo 值对象，参考xgsdk.h中其属性定义即可

-(void) refreshQuestionnaireWithRoleInfo:(XGRoleInfo )roleInfo questInfo:(XGQuestInfo )questInfo;

参数说明：

RoleInfo说明：

输入参数	数据类型	最大长度	说明	是否必填
uid	String	128	用户ID (必须传入登录时XG服务器返回的UID)	Y
roleId	String	32	角色ID	Y
roleName	String	64	游戏必须传入真实的角色名，建议中文	Y
roleType	String	20	角色类型，必须使用真实的角色类型，如法师，道士，战士，建议中文	N
roleCreateTime	Data	10	角色创建时间	Y
roleLevel	String	32	角色等级	Y
roleVipLevel	String	32	角色VIP等级	N
serverId	String	32	服ID	Y
zoneId	String	32	区ID	Y
serverName	String	64	游戏必须传入真实的游戏服名称，建议中文	Y
zoneName	String	32	游戏大区名称：要与界面显示名称一致，如：界面显示（一区桃园结义)，zoneName也必须传（一区桃园结义）	Y
partyName	String	32	公会名	N
gender	String	传入字符：m，f;分别代表男女	性别	Y
balance	String	128	角色账户余额	Y
ageInGame	String	64	角色游戏年龄（单位：天）	N
accountAgeInGame	String	64	账号游戏年龄（单位：天）	N
ext	String	1024	扩展参数	N

关于 XGQuestInfo 的成员说明：

所有必字段必须进行接入

参数	参数类型	最大长度	说明	必须
questId	string	32	任务ID	N
questName	string	64	任务名称	N
missionId	string	32	关卡ID	N
missionName	string	64	关卡名称	N
customParams	string	1024	扩展参数（Json串格式）	N

问卷更新回调
接口说明:刷新问卷回调
参数说明:

questionnaireName 任务名称

-(void) onQuestionnaireFreshed:(NSString *)questionnaireName;

7.4.2 打开问卷

打开问卷接口说明: 当游戏有通过游戏用户在线分发问卷的需求时，可以通过本SDK的接入简化开发提高效率节省成本。参数说明:：

widthPercent	打开问卷窗口的宽度占屏幕的百分比，100表示全屏
heightPercent	打开问卷窗口的高度占屏幕的百分比，100表示全屏
customParams	json串格式自定义参数

-(void) openXgQuestionnaireWithWidthPercent:(NSInteger)widthPercent heightPercent:(NSInteger)heightPercent customParams:(NSString *)customParams;

提交问卷回调
接口说明:提交问卷回调
参数说明:

giftInfo 问卷编号

-(void) onQuestionnaireFinished:(NSString *)giftInfo;

7.5 更新服务回调接口

游戏需要使用西瓜更新服务时，在西瓜后台配置打开更新

西瓜检测完更新将通过西瓜通用回调(onXGGenericCallBack)回调游戏（注：需要手动设置通用回调并处理）

参数说明:

参数说明

code 200：成功，其它失败

customInfo {"updateType":"1"} type = 0 为强制更新 type = 1 为选择更新 type = -1 为不存在更新

result "updateCallBack" </table>
-(void) onXGGenericCallBack:(NSInteger) code customInfo:(NSString *)customInfo result:(id)result;

customInfo	扩展字段，暂时不用传值
xgsdkDelegate	回调接收类。请先实现XgsdkDelegate中的方法

code	登录成功结果码，固定为0
authInfo	用于做登录验证的加密串

code	登录失败结果码，固定为1
msg	消息描述
channelCode	渠道返回的登录错误码

code	支付成功结果码，固定为0
msg	消息描述
gameTradeNo	游戏订单号
xgTradeNo	西瓜sdk订单号

code	支付取消结果码，固定为1
msg	消息描述
gameTradeNo	游戏订单号
channelCode	渠道结果码
channelMsg	渠道结果信息

code	支付失败结果码，固定为2
msg	消息描述
gameTradeNo	游戏订单号
channelCode	渠道结果码
channelMsg	渠道结果信息

code	支付失败结果码，固定为5
msg	消息描述
gameTradeNo	游戏订单号
channelCode	渠道结果码
channelMsg	渠道结果信息

code	支付失败结果码，固定为3
msg	消息描述
gameTradeNo	游戏订单号
channelCode	渠道结果码
channelMsg	渠道结果信息

accountId	账号ID
serverId	服务器ID
serverName	服务器名称
serverVersion	服务器版本号
zoneId	区ID
zoneName	区名称
extendParams	扩展参数

roleInfo	值对象，参考xgsdk.h中其属性定义即可
eventId	事件id
eventDesc	事件描述
eventValue	事件内容
eventBody	JSON字符串

bindMobileInfo	值对象，参考xgsdk.h中其属性定义即可
captcha	手机收到的验证码

roleInfo	值对象，参考xgsdk.h中其属性定义即可
questInfo	值对象，参考xgsdk.h中其属性定义即可

西瓜SDK（原生 IOS 版 ）接入文档

1. 文档概述

1.1 文档结构

2. 快速接入简

3. 用户接口

3.1 初始化接口（必接）

3.2 初始化回调

3.3 登陆接口（必接）

3.4 登陆回调

3.5 登出接口

3.6 登出回调

4.充值接口

4.1 支付接口（必接）

所有必字段必须进行接入，否则会导致部分渠道无法支付！

常用的国际货币

支付场景

4.2 支付回调

5.统计接口

5.1 创建角色（必接）

所有必字段必须进行接入，否则会导致统计不完全，部分渠道审核无法通过！

5.2 角色升级（必接）

5.3 进入游戏（必接）

5.3 账号注册

6.扩展接口

6.1 切换账号

6.2 自定义事件

6.3 任务开始

6.4 任务成功

6.5 任务失败

6.6 购买虚拟货币

6.7 赠送虚拟货币

6.8 消费虚拟货币

6.9 通用接口（选接，在西瓜api 2.2.7版本以上使用）

6.10 游戏加载完成

6.11 游戏加载配置完成

6.12 用户打开公告

6.13 用户关闭公告

6.14 用户完成新手任务

6.15 用户使用专用的功能码

6.16 用户使用公用的功能码

6.17 推送接口

7.运营活动接口

7.1 礼包码兑换，绑定手机号(西瓜提供页面)

7.2 礼包码兑换 （游戏提供界面）

7.3 绑定手机号（游戏提供界面）

所有必字段必须进行接入

所有必字段必须进行接入

7.4 问卷调查

7.4.1 刷新问卷

所有必字段必须进行接入

7.4.2 打开问卷

7.5 更新服务回调接口

西瓜SDK（原生 IOS 版）接入文档

7.2 礼包码兑换（游戏提供界面）