中台游戏SDK对接模板-IOS

一双端交互代码示例:unity: unity联调注意事项-IOS-CSDN博客cocos: cocos联调注意事项-IOS-CSDN博客二游戏需要调用SDK的方法1.初始化SDKInit(String gameObjectName)String gameObjectName 游戏对象对标安卓文档里的GameApp注意cocos游戏调用不需要参数SDKInit()2.检查是否有广告显示广告之前调用SDKCheckAdReady(String jsonParms)String jsonParms: json格式字符串将下方参数存入json后转为字符串String ad_place 广告位String level_type 关卡类型normal普通关卡 challenge挑战关卡 special特殊关卡int level_id 关卡int ad_type 广告类型1banner, 2:插屏, 3:激励3.显示Banner横幅广告SDKShowBanner(String jsonParms)String jsonParms json格式字符串将下方参数存入json后转为字符串String ad_place 广告位String level_type 关卡类型normal普通关卡 challenge挑战关卡 special特殊关卡int level_id 关卡4.自定义上报事件 (埋点)SDKCustomEvent(String eventName ,String jsonParms )String eventName事件名称String jsonParms json格式字符串(没有直接传空字符串)5.根据商品id列表获取对应商品信息接口(可选)SDKQueryProducts(String jsonParms)data: jsonParms json格式字符串 商品id列表 {product_ids:[ads01]} 回调结果见文章末尾6.支付(可选)SDKPay(String data)参数说明:data: json格式字符串将下方参数存入json后转为字符串数据结构见文章末尾String money 支付金额( 单位元)String currency 货币种类 人民币RMB, 美元USD, 欧元EUR)String roleName 用户游戏角色名 (游戏方自定义参数)String itemId用户游戏内购买道具id (游戏方自定义参数)String productName 用户游戏内购买道具名称 (游戏方自定义参数)String roleId 游戏角色id (游戏方自定义参数)String serverId 游戏大区id (游戏方自定义参数只有一个区默认传1)String orderId游戏订单id (游戏方自定义参数)String callbackUrl 游戏支付回调服务器地址 (游戏方自定义参数)String extra1 支付透传参数字段1String extra2 支付透传参数字段2String serverName 游戏大区服务器名称 (游戏方自定义参数只有一个区默认传1服)String roleLevel 游戏角色等级(游戏方自定义参数默认传1级)String purchaseType 购买类型 1: 常规购买; 2: 永久购买;游戏方无永久传17.AB测试(可选)SDKAbTest(String json) 游戏收到初始化成功回调后才可调用String json json数组格式字符串[xx实验A,xx实验B,xx实验C,xx实验D]Cocos (TS)Unity (C#8. 游戏角色数据更新SDKPlayerInfo(String data) 进入游戏调用游戏关卡变更也调用参数说明:data: json格式字符串将下方参数存入json后转为字符串数据结构见文章末尾String level_type 关卡类型normal普通关卡 challenge挑战关卡 special特殊关卡int level_id 关卡三IOS回调游戏的方法//cocos的回调方法在cocos联调注意事项-IOS里有样例这里只举例unity, 数据结构和方法名称都一样1. 初始化回调//GameApp: unity游戏对象InitSuccessunity回调方法sendMessage(GameApp, InitSuccess,data);datajson格式字符串data数据结构{idfa: xxx 苹果设备idadjustAdid: xxx adjust返回的设备id}2、是否有广告回调数据//GameApp: unity游戏对象CheckAdReadyunity回调方法sendMessage(GameApp, CheckAdReady,data);data数据结构{ isBanner: 0,是否有banner: 0代表无1代表有 isInter: 0, isReward: 0, }3. 广告播放成功回调//GameApp: unity游戏对象ShowAdSuccessunity回调方法data: json格式字符串sendMessage(GameApp, ShowAdSuccess,data);data数据结构{code:xxxxx 广告类型(String code: 1 是BANNER广告2是INTERSTITIAL广告3是REWARDED广告)}4. 广告播放失败回调//GameApp: unity游戏对象ShowAdFailunity回调方法data: json格式字符串sendMessage(GameApp, ShowAdFail,data);data数据结构{code:xxxxx 广告类型(String code: 1 是BANNER广告2是INTERSTITIAL广告3是REWARDED广告)errorCode:xxxxx 平台返回错误提示码errorMsg:xxxxx 平台返回错误提示消息}5. 支付回调1 支付成功//GameApp: unity游戏对象PaySuccessunity回调方法data: json格式字符串sendMessage(GameApp, PaySuccess,data);data数据结构{message:xxx 支付成功itemId:xxx 商品idtransactionId: 苹果交易ID,originalTransactionId: 原始交易ID}6. AB测分组数据回调(可选//GameApp: unity游戏对象AbTestCallbackunity回调方法data: json格式字符串UnityPlayer.UnitySendMessage(GameApp, AbTestCallback, json);举例SDKAbTest接口传入的实验名称{xx实验A,xx实验B}返回如下{ xx实验A: 1, //String格式 xx实验A:实验名称1分组id xx实验B: 2, }