iOS客户端接入引导

iOS客户端接入引导

1

2

SDK接入 查看

2.1 登录http://www.ixsdk.com, 获取appId

接入时若遇到问题,请联系接入服务QQ群: 307199213


2.2 导入SDK资源包,解压后如下图内容所示:

开发者需要将lib文件夹下的头文件和.a文件导入到自己的项目工程。


2.3 找到项目build Setting中的Other Linker Flags,添加-all_load参数:

3

API说明 查看

使用IXClick来调用以下各个方法。

3.1 初始化API(必接)

游戏程序在初始化时调用该初始化API.

/**
 * 游戏启动后调用
 *
 * @param appId @param appId 游戏识别号
 * @param cId   渠道名称,为nil或@""时, 默认为@"App Store"渠道
 */
+ (void)clickWithAppId:(NSString *)appId channelId:(NSString *)cId;

3.2 玩家统计API(必接)

游戏程序在玩家登录成功后调用该玩家统计API.

/**
 *  @param playerId 玩家标识
 *  @param name     玩家名称
 *  @param age      年龄
 *  @param gender   性别
 *  @param source   玩家来源,玩家自定义。
 *  @param rank     玩家等级
 *  @param server   区域服务器名称
 *  @param comment  其他备注信息
 */
+ (void)player:(NSString *)playerId name:(NSString *)name age:(int)age gender:(int)gender source:(NSString *)source rank:(NSString *)rank server:(NSString *)server comment:(NSString *)comment;

3.3 支付统计API(必接)

游戏程序在支付成功的回调中调用该支付统计API.

/**
 *  玩家支付货币兑换虚拟币
 *
 *  @param cash   成功支付金额(货币单位为分)
 *  @param coin   虚拟币数量
 *  @param source 支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 */
+ (void)pay:(int)cash coin:(int)coin source:(int)source;

/**
 *  玩家支付货币兑换虚拟币
 *
 *  @param cash     成功支付金额(货币单位为分)
 *  @param cashType 支付货币类型(游戏自定义)
 *  @param coin     虚拟币数量
 *  @param source   支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 */
+ (void)pay:(int)cash cashType:(NSString *)cashType coin:(int)coin source:(int)source;

/**
 *  玩家支付货币兑换虚拟币
 *
 *  @param cash   成功支付金额(货币单位为分)
 *  @param coin   虚拟币数量
 *  @param source 支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 *  @param level  关卡名称
 *  @param rank   玩家等级
 */
+ (void)pay:(int)cash coin:(int)coin source:(int)source level:(NSString *)level rank:(NSString *)rank;

/**
 *  玩家支付货币兑换虚拟币
 *
 *  @param cash     成功支付金额(货币单位为分)
 *  @param cashType 支付货币类型
 *  @param coin     虚拟币数量
 *  @param source   支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 *  @param level    关卡名称
 *  @param rank     玩家等级
 */
+ (void)pay:(int)cash cashType:(NSString *)cashType coin:(int)coin source:(int)source level:(NSString *)level rank:(NSString *)rank;

/**
 *  玩家支付货币购买道具
 *
 *  @param cash   成功支付金额(货币单位为分)
 *  @param props  道具名称
 *  @param number 道具数量
 *  @param source 支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 */
+ (void)pay:(int)cash props:(NSString *)props number:(int)number source:(int)source;

/**
 *  玩家支付货币购买道具
 *
 *  @param cash     成功支付金额(货币单位为分)
 *  @param cashType 支付货币类型
 *  @param props    道具名称
 *  @param number   道具数量
 *  @param source   支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 */
+ (void)pay:(int)cash cashType:(NSString *)cashType props:(NSString *)props number:(int)number source:(int)source;

/**
 *  玩家支付货币购买道具
 *
 *  @param cash   成功支付金额(货币单位为分)
 *  @param props  道具名称
 *  @param number 道具数量
 *  @param source 支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 *  @param level  关卡名称
 *  @param rank   玩家等级
 */
+ (void)pay:(int)cash props:(NSString *)props number:(int)number source:(int)source level:(NSString *)level rank:(NSString *)rank;

/**
 *  玩家支付货币购买道具
 *
 *  @param cash     成功支付金额(货币单位为分)
 *  @param cashType 支付货币类型
 *  @param props    道具名称
 *  @param number   道具数量
 *  @param source   支付渠道(游戏自定义,给每个支付渠道定义的整型值)
 *  @param level    关卡名称
 *  @param rank     玩家等级
 */
+ (void)pay:(int)cash cashType:(NSString *)cashType props:(NSString *)props number:(int)number source:(int)source level:(NSString *)level rank:(NSString *)rank;

3.4 关卡统计API

开始关卡:

/**
 *  @param level 关卡名称
 */
+ (void)startLevel:(NSString *)level;

结束关卡:

/**
 *  @param level 关卡名称
 */
+ (void)finishLevel:(NSString *)level;

失败关卡:

/**
 *  @param level 关卡名称
 */
+ (void)failLevel:(NSString *)level;

3.5 任务统计API

开始任务:

/**
 *  @param task 任务名称
 *  @param type 任务类型
 */
+ (void)startTask:(NSString *)task type:(NSString *)type;

结束任务:

/**
 *  @param task 任务名称
 *  @param type 任务类型
 */
+ (void)finishTask:(NSString *)task type:(NSString *)type;

失败任务:

/**
 *  @param task 任务名称
 *  @param type 任务类型
 */
+ (void)failTask:(NSString *)task type:(NSString *)type;

3.6 虚拟币购买物品统计API

/**
 *  @param name   物品名称
 *  @param number 物品数量
 *  @param coin   消费的虚拟币数量
 */
+ (void)buy:(NSString *)name number:(int)number coin:(int)coin;

/**
 *  @param name   物品名称
 *  @param number 物品数量
 *  @param method 物品获取方式
 */
+ (void)buy:(NSString *)name number:(int)number method:(NSString *)method;

/**
 *  @param name     物品名称
 *  @param number   物品数量
 *  @param coinType 虚拟币类型
 *  @param coin     消费的虚拟币数量
 */
+ (void)buy:(NSString *)name number:(int)number coinType:(NSString *)coinType coin:(int)coin;

/**
 *  @param name   物品名称
 *  @param number 物品数量
 *  @param coin   消费的虚拟币数量
 *  @param level  关卡名称
 */
+ (void)buy:(NSString *)name number:(int)number coin:(int)coin level:(NSString *)level;

/**
 *  @param name   物品名称
 *  @param number 物品数量
 *  @param method 物品获取方式
 *  @param level  关卡名称
 */
+ (void)buy:(NSString *)name number:(int)number method:(NSString *)method level:(NSString *)level;

/**
 *  @param name     物品名称
 *  @param number   物品数量
 *  @param coinType 虚拟币类型
 *  @param coin     消费的虚拟币数量
 *  @param level    关卡名称
 */
+ (void)buy:(NSString *)name number:(int)number coinType:(NSString *)coinType coin:(int)coin level:(NSString *)level;

/**
 *  @param name   物品名称
 *  @param type   物品类型
 *  @param number 物品数量
 *  @param coin   消费的虚拟币数量
 */
+ (void)buy:(NSString *)name type:(NSString *)type number:(int)number coin:(int)coin;

/**
 *  @param name   物品名称
 *  @param type   物品类型
 *  @param number 物品数量
 *  @param coin   消费的虚拟币数量
 */
+ (void)buy:(NSString *)name type:(NSString *)type number:(int)number method:(NSString *)method;

/**
 *  @param name     物品名称
 *  @param type     物品类型
 *  @param number   物品数量
 *  @param coinType 虚拟币类型
 *  @param coin     消费的虚拟币数量
 */
+ (void)buy:(NSString *)name type:(NSString *)type number:(int)number coinType:(NSString *)coinType coin:(int)coin;

/**
 *  @param name   物品名称
 *  @param type   物品类型
 *  @param number 物品数量
 *  @param coin   消费的虚拟币数量
 *  @param level  关卡名称
 */
+ (void)buy:(NSString *)name type:(NSString *)type number:(int)number coin:(int)coin level:(NSString *)level;

/**
 *  @param name   物品名称
 *  @param type   物品类型
 *  @param number 物品数量
 *  @param method 物品获取方式
 *  @param level  关卡名称
 */
+ (void)buy:(NSString *)name type:(NSString *)type number:(int)number method:(NSString *)method level:(NSString *)level;

/**
 *  @param name     物品名称
 *  @param type     物品类型
 *  @param number   物品数量
 *  @param coinType 虚拟币类型
 *  @param coin     消费的虚拟币数量
 *  @param level    关卡名称
 */
+ (void)buy:(NSString *)name type:(NSString *)type number:(int)number coinType:(NSString *)coinType coin:(int)coin level:(NSString *)level;

3.7 物品消耗统计API

/**
 *  @param name     物品名称
 *  @param type     物品类型
 *  @param number   物品数量
 *  @param coinType 虚拟币类型
 *  @param coin     物品对应的虚拟币数量
 *  @param level    关卡名称
 */
+ (void)use:(NSString *)name type:(NSString *)type number:(int)number coinType:(NSString *)coinType coin:(int)coin level:(NSString *)level;

3.8 角色统计API

/**
 *  @param role 当前玩家标识设置的角色名
 */
+ (void)role:(NSString *)role;

3.9 自定义事件统计API

自定义事件

/**
 *  @param eventId    事件标识
 *  @param attributes 事件属性键值对
 */
+ (void)event:(NSString *)eventId attributes:(NSDictionary *)attributes;

开始自定义事件

/**
 *  @param eventId    事件标识
 *  @param attributes 事件属性键值对
 */
+ (void)eventBegin:(NSString *)eventId attributes:(NSDictionary *)attributes;

结束自定义事件

/**
 *  @param eventId    事件标识
 *  @param attributes 事件属性键值对
 */
+ (void)eventEnd:(NSString *)eventId attributes:(NSDictionary *)attributes;