西瓜SDK(原生 IOS 版 )接入文档

1. 文档概述

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

1.1 文档结构

  1. 文档概述
  2. 快速接入简介
  3. 用户接口
  4. 充值接口
  5. 统计接口
  6. 扩展接口
  7. 运营活动接口

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 登陆接口(必接)

  • 登录
    接口说明:登录时调用,将拉起登录界面。
    参数说明:
    customInfo 扩展字段,暂时不用传值
    -(void)XGLoginWith:(NSString *)customInfo;

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;