iOS SDK API接口文档

1.1 账号部分

1.1.1 游客登录

-(void) guestLogin:(SDKResponseBlock) sdkResponse;

1.1.2 获取SDK玩家ID

-(NSString*) getUserId;

1.1.3 获取继承ID

-(void) getMigrateId:(SDKResponseBlock) sdkResponse;

1.1.4 玩家登出

-(void) userLogout;

1.1.5 是否设定过继承密码

-(Boolean) isPasswordSet;

1.1.6 设定继承密码

-(void) setMigratePass:(NSString*)pass1 :(NSString*)pass2 :(SDKResponseBlock) sdkResponse;

1.1.7 玩家继承

-(void) migratedevice:(NSString*)migrateId :(NSString*)password :(SDKResponseBlock) sdkResponse;

1.1.8 SNS账号部分

Twitter部分

-(Boolean) isTwitterBind;
-(void) bindTwitter:(SDKResponseBlock) sdkResponse;
-(void) unbindTwitter:(SDKResponseBlock) sdkResponse;
-(void) twitterMigrate:(SDKResponseBlock) sdkResponse;
-(void) twitterShareMsgTagsAndImage:(NSString*)msg :(NSString*)imgPath :(SDKResponseBlock) sdkResponse;

Facebook部分

-(Boolean) isFacebookBind;
-(void) bindFacebook:(SDKResponseBlock) sdkResponse;
-(void) unbindFacebook:(SDKResponseBlock) sdkResponse;
-(void) facebookMigrate:(SDKResponseBlock) sdkResponse;
-(void)facebookShareTagsAndImage:(NSString *)imgPath andHashTag:(NSString*) hashTag :(SDKResponseBlock) sdkResponse;

Google部分

-(Boolean) isGoogleBind;
-(void) bindGoogle:(SDKResponseBlock) sdkResponse;
-(void) unbindGoogle:(SDKResponseBlock) sdkResponse;
-(void) googleMigrate:(SDKResponseBlock) sdkResponse;

1.2 充值部分

1.2.1 是否是越狱设备

-(BOOL) isJailbreakDevice;

1.2.2 是否开启年龄充值限制

-(BOOL) isInAppBillingAgeLimitOn;

1.2.3 是否设定生日

-(BOOL) isBirthdaySet;

1.2.4 设定生日

-(void) setBirthday:(NSString*)birthday :(SDKResponseBlock) sdkResponse;

1.2.5 是否在充值范围内

-(void) isInChargeLimit:(NSNumber*)itemPrice :(SDKResponseBlock) sdkResponse;

1.2.6 购买商品

-(BOOL) purchaseItem:(NSString *)productId withBillingPara:(NSString*) billingPara;

1.2.7 是否存留充值信息

-(NSString*) checkIsPayInfoLeft;

1.2.8 消单

-(void) clearPayInfo;

1.3 客服部分

1.3.1 打开官网首页

-(void) openHomePageUrl;

1.3.2 打开官方Twitter

-(void) openOfficialTwitterPageUrl;

1.3.3 打开客服

***此处使用的playerId请使用游戏内的角色ID(character id),不要使用SDK的userID.

-(void) openCSMail:(NSString*)playerId :(NSString*)serverId :(NSString*)serverName :(NSString*)clientVersion;

1.4 数据分析部分

a) Adjust部分

根据运营埋点进行

b)Cydonia部分

1.4.2.0新用户注册数据埋点(2019-07-02追加）

1.4.2.1 玩家登陆成功

-(void) cydoniaPlayerLoginWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId;

1.4.2.2 玩家开始新手教学

-(void) cydoniaPlayerTutorialBeginWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId;

1.4.2.3 玩家完成新手教学

-(void) cydoniaPlayerTutorialCompleteWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId;

1.4.2.4 玩家升级

-(void) cydoniaPlayerLevelUpWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId andReachedLevel:(NSString*)currentLevel;

1.4.2.5 玩家过了某个关卡(舍弃)

-(void) cydoniaPlayerCompleteStageWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId andCompleteStage:(NSString*)currentStage;

1.4.2.6 玩家获得了虚拟第一资源(舍弃)

-(void) cydoniaPlayerVCurrencyInWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId andVCurrencyName:(NSString*)vCurrencyName andVCurrencyVal:(NSString*)vCurrencyVal andVCurrencyType:(NSString*)vCurrencyType andVCurrencyInMethod:(NSString*)vCurrencyInMethod;

1.4.2.7 玩家消耗了虚拟第一资源(舍弃)

-(void) cydoniaPlayerVCurrencyOutWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId andVCurrencyName:(NSString*)vCurrencyName andVCurrencyVal:(NSString*)vCurrencyVal andVCurrencyType:(NSString*)vCurrencyType andPaidItemCategory:(NSString*)paidItemCategory andPaidItemName:(NSString*)paidItemName;

1.4.2.8 玩家充值成功

-(void) cydoniaPlayerBillingWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId  andGameUserRoleId:(NSString*)gameUserRoleId andProductId:(NSString*)productId andProductPrice:(NSString*)proiductPrice andCurrency:(NSString*)currency andReceiptId:(NSString*)receiptId;

1.4.2.2 玩家在线满一分钟(每分钟调用一次)

-(void) cydoniaPlayerHeartBeatWithAppVersion:(NSString*)currentAppVersion andGameServerId:(NSString*)gameServerId andGameUserId:(NSString*)gameUserId andGameUserRoleId:(NSString*)gameUserRoleId;