跳到主要内容
版本：国内SDK

国内游戏对接文档--IOS

版本​

当前版本及SDK下载​

当前版本 1.5.3
历史版本

SDK功能​

登录、个人中心、广告视频、数据事件上报、实名认证、注销账号、切换账号、分享功能

1.工程配置​

游戏若需要自主出包，此点必读。若为渠道代为出包，该内容可不读。

1.1 游戏首次接入​

1.游戏可以向运营拿到一份对接文件夹（下文统称为配置目录），具体内容如下图所示：

U8配置目录

游戏可以打开README.md查看打包工具和第三方SDK的下载地址，将得到一份包含打包工具与第三方SDK的文件（下文统称为打包目录），具体内容如下：

U8打包工具与SDK

2.更换游戏配置参数 将配置目录下的common文件夹直接替换打包目录下的u8test/common文件夹

U8参数替换

将配置目录下的channels文件夹直接替换打包目录下的u8test/channels文件夹

U8参数替换2

首次对接的游戏必须完成以上步骤，请参照1.3内容进行U8打包

1.2 游戏更新渠道信息​

1.游戏可以向运营拿到一份对接更新文件夹（下文统称为"更新配置目录"），具体内容如下图所示：

U8配置目录

2.若渠道参数需要更新请做如下操作

将"更新配置目录"下的common文件夹直接替换"游戏打包目录"下的u8test/common文件夹

U8参数替换

将"更新配置目录"下的channels文件夹直接替换"游戏打包目录"下的u8test/channels文件夹

U8参数替换2

3.若渠道有SDK更新 游戏可以打开README.md查看打包工具和第三方SDK的下载地址，将得到一份包含打包工具与第三方SDK的文件（下文统称为"更新打包目录"），具体内容如下：

U8打包工具与SDK

将对"更新打包目录"下的Plugins/U8SDK_MCODO文件夹直接替换"游戏打包目录下"的Plugins/U8SDK_MCODO文件夹

U8-SDK替换

完成以上步骤后，请参照1.3内容进行U8打包

1.3 U8打包​

项目需使用U8工具进行打包，请按照以下步骤进行U8打包

  1. 将U8打包工具放在任意位置，确认channels中MCODO和common目录下config.json参数是否正确

U8打包common配置

名称描述
product_name游戏简称，例如妙酷测试可写为mkcs
AppIdU8AppID，可和对接人员确认参数是否正确
AppKeyU8AppKey，可和对接人员确认参数是否正确
U8UrlU8Url，可和对接人员确认参数是否正确

U8打包config配置

MCOOS目录下config.js配置详解

名称描述
desc游戏介绍，可直接填入游戏名称，例如妙库测试
CFBundleIdentifier项目bundleID
Channelu8渠道，可和对接人员确认参数是否正确
name渠道名称，默认为MCODO，请勿修改
key渠道key，可和对接人员确认参数是否正确
gameID渠道游戏id，可和对接人员确认参数是否正确
payKey渠道游戏支付key，可和对接人员确认参数是否正确
channel渠道，可为空
appsFlyerDevKeyAppsFlyer devKey值，需要在appsFlyer进行申请
appleAppID苹果应用ID，需要在苹果应用后台获取。苹果登录或者绑定与AppsFlyer信息上报必填
googleClientID谷歌应用ClientID，需要在谷歌应用后台获取。谷歌登录或者绑定必填
fbAppIdFacebook应用ID，需要在Facebook应用后台获取。Facebook登录或者绑定必填
fbDisplayNAameFacebook应用名称，需要在Facebook应用后台获取。Facebook登录或者绑定必填
gooleAppId谷歌应用AppID，需要在谷歌应用后台获取。谷歌登录或者绑定必填
  1. cd进入buildscript目录，执行以下代码
./build.py  游戏工程的xcodeproj文件地址  ../u8test -n
  1. 运行后会选择渠道，输入‘MCODO’
  2. 成功后会生成 工程名.MCODO包
  3. 使用XCode打开 工程名.MCODO包，填入开发者账号

2.SDK接口​

注意

所有接口调用，都通过U8SDK单例类来调用。引入头文件。

#import <U8SDKCore/U8SDK+AppDelegate.h>

2.1 生命周期(必接)​

需要在AppDelegate以下对应的生命周期方法中调用U8SDK种对应这些方法：

-(void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
    [[U8SDK sharedInstance] application:application didRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
}
-(void)application:(UIApplication *)application didReceiveRemoteNotification:(nonnull NSDictionary *)userInfo
{
    [[U8SDK sharedInstance] application:application didReceiveRemoteNotification:userInfo];
}
-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler
{
    [[U8SDK sharedInstance] application:application didReceiveRemoteNotification:userInfo];
}
-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
{
    [[U8SDK sharedInstance] application:application didReceiveLocalNotification:notification];
}
- (void)applicationWillResignActive:(UIApplication *)application {
    [[U8SDK sharedInstance] applicationWillResignActive:application];
}
- (void)applicationDidEnterBackground:(UIApplication *)application {
    [[U8SDK sharedInstance] applicationDidEnterBackground:application];
}
- (void)applicationWillEnterForeground:(UIApplication *)application {
    [[U8SDK sharedInstance] applicationWillEnterForeground:application];
}
- (void)applicationDidBecomeActive:(UIApplication *)application {
    [[U8SDK sharedInstance] applicationDidBecomeActive:application];
}
- (void)applicationWillTerminate:(UIApplication *)application {
    [[U8SDK sharedInstance] applicationWillTerminate:application];
}
-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
    return [[U8SDK sharedInstance] application:application handleOpenURL:url];
}
-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    return [[U8SDK sharedInstance] application:application openURL:url sourceApplication:sourceApplication annotation:annotation];
}
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler{
    return [[U8SDK sharedInstance] application:application continueUserActivity:userActivity restorationHandler:restorationHandler];
}

2.2 初始化(必接)​

调用初始化接口，一般在游戏启动的时候调用。 后续其他接口的调用都必须在初始化接口调用之后进行。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    NSDictionary *sdkconfig = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"U8SDK"];
    [[U8SDK sharedInstance] initWithParams:sdkconfig];
    [[U8SDK sharedInstance] application:application didFinishLaunchingWithOptions:launchOptions];
    [[U8Analytics sharedInstance] startLevel:@"1"];
    return YES;
}

初始化回调详情请见 3.2 初始化成功回调

2.3 登录(必接)​

2.3.1 登录接口（无账号体系）​

登录接口需要在 OnPlatformInit 回调内调用。调用该接口，会默认登录，不会打开SDK登录界面。

[[U8SDK sharedInstance] loginCustom:@"test001"];

登录回调详情请见 3.3 登录成功回调

2.3.2 登录接口（有账号体系）​

登录接口需要在 OnPlatformInit 回调内调用。调用该接口，会打开SDK登录界面。

[[U8SDK sharedInstance] login];

登录回调详情请见 3.3 登录成功回调

2.4 个人中心接口(选接)​

调用该接口，会打开个人中心界面。该功能涉及到问卷功能的展示，需要在"进入游戏"后调用。

[[U8SDK sharedInstance] showAccountCenter];

2.5 激励视频广告接口(选接)​

2.5.1 拉取广告​

注意

拉取广告前需要判断玩家注册国家和当前位置是否为中国大陆，所以请在收到登录成功回调后再调用该接口

-(void)loadTopOnAd:(NSString *)placementID info:(NSDictionary *)info;

其中参数为NSString类型的广告位ID，只需要第一次启动游戏时候调用。 info为额外参数，其需要传的内容如下

参数名称参数类型是否必传参数说明
callbackUrlString使用服务端回调时必传用户激励视频回调地址
placementNameString否广告名
extraString否用户其它透传参数

例子

NSDictionary *dic = @{
    @"placementName":@"test",
    @"extra":@{@"type":@"zhuanpan"},
    @"callbackUrl":@"www.baidu.com"
};
[[U8SDK sharedInstance] loadTopOnAd:@"xxxx" info:dic];

激励视频load广告回调详情请见 3.6 激励视频load广告回调

2.5.2播放广告​

用户点击播放广告时，游戏需传入的参数params(NSDictionary类型)中的参数如下：

名称描述
ads_type广告位置ID，例如宝贝有转盘、登录、探险等广告位置
placementId广告位ID

scenarioId / 场景ID

NSDictionary *dic = @{
        @"ads_type" : @"zhuanpan",
        @"placementId":@"xxx",
        @"scenarioId":@"xxx"
};
[[U8SDK sharedInstance] rewardedVideo:dic];

激励视频成功回调详情请见 3.7 激励视频成功回调

2.6 数据上报接口(必接)​

接口：

-(void) submitExtraData:(U8UserExtraData*)data;

其中，UserExtraData就是游戏内玩家的数据，比如在选择服务器时，extraData中的dataType为 TYPE_SELECT_SERVER

data_type值含义
TYPE_SELECT_SERVER选择服务器
TYPE_CREATE_ROLE角色创建
TYPE_ENTER_GAME进入游戏
TYPE_LEVEL_UP角色升级
TYPE_EXIT_GAME退出游戏
TYPE_SHOW_RV看完广告
TYPE_DEVICE_START设备启动
TYPE_LOGIN_PID设备PID登陆成功
TYPE_BIND_ACCOUNT绑定账号成功
TYPE_DEVICE_ENTER_GAME设备成功进入游戏
TYPE_DEVCIE_ENTER_SERVER设备开始进入服
TYPE_OTHER_EVENT其他上报信息
TYPE_TUTORIAL_COMPLETION角色完成引导
TYPE_LOGIN_ROLE角色登录
TYPE_DEVICE_LOAD设备加载过程,可能会分几步,所以此上报需要填写lodingEvent字段
TYPE_RETENTION_2留存两天
TYPE_RETENTION_3留存三天
提示

选择服务器时，因为还没有进入游戏，无法知道角色数据，extraData中只需要传入服务器信息即可。

关于U8UserExtraData 数据结构，其中设备加载过程需填写loadingEvent字段值

参数名称参数类型参数说明
dataTypeint调用时机
serverIDString玩家所在服务器的ID
serverNameString玩家所在服务器的名称
roleIDString玩家角色ID
roleNameString玩家角色名称
roleLevelString玩家角色等级
moneyNumString当前角色身上拥有的游戏币数量
roleCreateTimelong角色创建时间，从1970年到现在的时间，单位秒,必须传入真实的数据，否则UC审核不过
roleLevelUpTimelong角色等级变化时间，从1970年到现在的时间，单位秒
vipString玩家VIP等级
loadingEventString表示加载过程的不同阶段，格式为loading_xxx
eventNameString当data_type值为TYPE_OTHER_EVENT时必填，af上报的事件名
paramNSDictionaryaf上报事件的参数
U8UserExtraData* extraData = [[U8UserExtraData alloc] init];
extraData.dataType = TYPE_ENTER_GAME;
extraData.roleID = @"testRole";
extraData.roleName = @"角色名称";
extraData.serverID = 1;
extraData.serverName = @"第一区";
extraData.roleLevel = @"1";
extraData.moneyNum = 100;
extraData.roleCreateTime = time(NULL);
extraData.roleLevelUpTime = time(NULL);
[[U8SDK sharedInstance] submitExtraData:extraData];

事件上报回调详情请见 3.5 事件上报回调

2.7 数数科技信息上报与用户属性设置(选接)​

//eventType: 0:发送事件；1：用户数据上报set；2：用户数据上报setOnce；3：用户数据上报add；4.公共属性上报；6.一次性事件上报
//trackName:事件名称，当eventType=0或eventType=6时必传，其他情况可不传
//infoDic :上报属性数据。当eventType=0或eventType=6时，infoDic可不传；其他情况必传，字典项
-(void)submitTAInfo:(int)eventType trackName:(NSString *)trackName info:(NSDictionary *)infoDic

2.8 自定义事件上报接口(选接)​

热云与AppsFlyer自定义事件使用该接口上报。 热云事件命名要求：event_xx（xx为自定义内容，xx为数字） AppsFlyer命名要求：af_xx（xx为自定义内容） 热力引擎事件命名要求：event_xx（xx为自定义内容）

-(void) gameEvent:(NSString *)eventName withValues:(NSDictionary *)values;

2.9 订阅恢复(选接)​

用户点击订阅恢复时，游戏需传入的参数params(NSDictionary类型)中的参数如下：

名称描述
extra订阅恢复时，游戏透传的参数
serverId玩家所在服id
 [[U8SDK sharedInstance] restoreCompletedTransactions:params];

订阅恢复客户端回调详情请见 3.11 订阅恢复客户端回调

2.10 获取商品信息(选接)​

调用该接口，可以获取商品返回内容

[[U8SDK sharedInstance] getProductsInfo];

获取商品回调回调详情请见 3.12 获取商品回调

2.11 支付充值(必接)​

关于U8ProductInfo对象：

参数名称参数类型参数说明
productIdNSString充值商品ID，游戏内的商品ID
productNameNSString商品名称，比如100元宝，500钻石...
productDescNSString商品描述，比如 充值100元宝，赠送20元宝
priceNSNumber充值金额(单位：元)
buyNumNSInteger购买数量，一般都是1
coinNumNSInteger玩家当前身上剩余的游戏币
userNameNSString玩家唯一标识
serverIdNSString玩家所在服务器的ID
serverNameNSString玩家所在服务器的名称
roleIDNSString玩家角色ID
roleNameNSString玩家角色名称
roleLevelNSString玩家角色等级
vipNSString玩家vip等级
notifyUrlNSString游戏服务器支付回调地址，渠道SDK支付成功，异步通知U8Server，U8Server根据该地址，通知游戏服务器发货
extensionNSString支付成功之后，U8Server通知游戏服务器时，原样返回给游戏服务器

调用实例：

U8ProductInfo* productInfo = [[U8ProductInfo alloc] init];
productInfo.productName = @"礼包1";
productInfo.productDesc = @"礼包1";
productInfo.productId = @"libao1";
productInfo.price = [NSNumber numberWithInt:30];
productInfo.buyNum = 1;
productInfo.coinNum = 900;
productInfo.userName = @"test001";
productInfo.roleId = @"12345";
productInfo.roleName = @"角色";
productInfo.roleLevel = @"66";
productInfo.serverId = @"1";
productInfo.serverName = @"桃源";
productInfo.vip = @"1";
productInfo.notifyUrl = @"http://110.54.33.45/game/pay/notify";
[[U8SDK sharedInstance] pay:productInfo];

支付成功回调详情请见 3.4 支付成功回调

2.13 实名认证接口(自定义实名认证必接)​

2.13.1 实名认证流程​

实名弹窗流程

2.13.2 上报实名认证信息​

游戏是否需要弹出游戏自定义实名认证界面，请结合3.3 登录成功回调与 3.13 可以进入游戏回调进行判断联合判断。

参数说明:

名称描述
name名字
idCard身份证号
successCallBack实名认证成功
failCallBack实名失败

其中实名认证成功返回successCallBack的内容为NSDictionary内容如下：

名称描述
userID用户userID
idCardStatus玩家身份状态 1:小于8岁; 2:大于8岁小于16岁;3:大于18岁;4:假身份(格式符合要求的身份证);5:大于16岁小于18岁

其中实名认证失败返回failCallBack的内容为NSDictionary内容如下：

名称描述
userID用户userID
idCardStatus玩家身份状态 1:小于8岁; 2:大于8岁小于16岁;3:大于18岁;4:假身份(格式符合要求的身份证);5:大于16岁小于18岁
-(void)checkUserRealName:(NSString *)name idCard:(NSString *)idCard successCallBack:(void (^)(id result))successCallBack failCallBack:(void(^)(id error))failCallBack;

SDK自带实名认证弹窗-实名成功回调详情请见 [3.10 SDK自带实名认证弹窗 实名成功回调](#310-SDK自带实名认证弹窗 实名成功回调)

2.14 注销账号接口(选接)​

调用该接口，会显示SDK内置的注销账号界面。请结合

-(void)cancelAccount;

2.15 切换账号接口(选接)​

调用该接口，会显示SDK内置的切换账号界面

-(void)switchAccount;

切换账号回调详情请见 3.9 切换账号回调

2.16 绑定账号接口(选接)​

调用该接口，会显示SDK内置的绑定账号界面

-(void)bindAccount;

账号绑定成功回调详情请见 3.8 账号绑定回调

2.17 分享接口(选接)​

分享说明
  1. 用户设置的图片大小最好不要超过250k，最好不要分享1M以上的图片。
  2. 用户分享消息给微信好友，以及分享到朋友圈，开发者将无法获知用户是否分享完成，默认分享成功。
  3. 用户分享消息给QQ好友，以及分享到QQ空间，若选择关闭分享，将无法跳转回游戏，开发者将无法获知用户是否分享完成。
  4. 若需要支持抖音分享平台，videoData参数不可为空。
  5. 支持平台分享样式总览
平台支持样式
微信好友纯文本、图片、视频
微信朋友圈纯文本、图片、视频
新浪微博纯文本、图片、视频
QQ纯文本、图片、视频
QQ空间纯文本、图片、视频
抖音图片、视频

U8ShareInfo参数内容

参数名称参数类型参数说明
shareTypeU8ShareType其中纯文本为U8ShareTypeText=0，图片为U8ShareTypeImage=1，视频为U8ShareTypeVideo=2
textNSString文字内容，当shareType为U8ShareTypeText（纯文本）该值必传
imgDataid图片，支持UIImage、NSData，image_url。当type为U8ShareTypeImage（图片）时必传
titleNSString标题，当shareType为U8ShareTypeVideo（视频）该值必传
descrNSString描述，当shareType为U8ShareTypeVideo（视频）该值必传
thumbImgid缩略图,UIImage或者NSData类型，或者image_url。当type为U8ShareTypeVideo（视频）该值必传
videoNameNSString视频名称，当shareType为U8ShareTypeVideo（视频）该值必传
videoUrlNSString视频网页的url，若shareType为U8ShareTypeVideo（视频）该值必传
videoDataNSData视频数据，若shareType为U8ShareTypeVideo（视频）且需要支持抖音平台时该值必传。
-(void)share:(U8ShareInfo*)params;

分享结果回调详情请见 3.14 分享结果回调

2.18 问卷功能接口​

初始化问卷​

传入参数说明：

参数名称参数说明
roleID角色id
serverID服务器id
callbackUrl问卷奖励回调地址
-(void)initUserSurvey:(NSString *)roleID serverID:(NSString *)serverID callbackUrl:(NSString *)callbackUrl

问卷初始化回调详情请见 3.15 问卷初始化回调。若有问卷，将收到OnInitUserSurveySuccess回调，此时可显示进入问卷中心入口。

打开问卷中心界面​

若游戏收到OnInitUserSurveySuccess回调可显示问卷中心入口，此时可以调用以下方法

-(void) openUserSurvey;

2.19 获取用户广告来源(选接)​

注意

目前只支持乐都SDK

调用该接口，获取用户广告来源

-(void)getAdInfo;

[[U8SDK sharedInstance] getAdInfo];

用户广告来源成功回调详情请见 3.16 用户广告来源回调

3. SDK回调代理​

3.0 设置代理回调(必接)​

在初始化前, 还需要设置U8SDK的回调函数, 回调对象需要实现U8SDKDelegate的各个接口

[[U8SDK sharedInstance] setDelegate:self];

渠道SDK中初始化成功，登录成功，登出成功，支付成功等，会回调到该接口。比如u8sdkdemo中DemoViewController.m中这些接口的实现。

3.1​

-(UIView *)GetView
{
    return [self GetViewController].view;
}
-(UIViewController *)GetViewController
{
    return self;
}

3.2 初始化成功回调​

//初始化成功回调。 渠道SDK初始化成功，无回调该参数
-(void) OnPlatformInit:(NSDictionary*)param
{
    [self SendCallback:"OnInitSuc" withParams:param];
}

3.3 登录成功回调​

//param(NSDictionary类型)中的参数如下：
//userID:U8Server生成的唯一用户ID
//sdkUserID:渠道SDK平台用户唯一ID，游戏服务器需要将游戏账户ID和该sdkUserID进行绑定。
//isAdult:布尔值，若为成年人返回为true，其他(未成年或未实名)返回false
//username:U8Server生成的用户名，比如234234234.uc,4353453453.baidu,65756756756.360
//sdkUserName:渠道SDK平台用户名，可能为空，部分渠道SDK没有返回用户名
//token:U8Server生成的会话ID，游戏服务器拿该字段去U8Server做二次登录验证
//extension:U8Server返回的扩展字段，部分渠道SDK需要，游戏中无需使用该字段的值
//timestamp:U8Server生成的时间戳，游戏服务器去U8Server做二次登录验证时，传给U8Server
//third_login_type 第三方登陆类型 0:游客,3:apple,4:weixin,5:qq,6:jiguang
//isCustomRealName 是否需要游戏自定义实名认证界面 Bool值
//isBindPhone 是否绑定手机号 Bool值
//idcardStatus 玩家身份状态 0:没有身份认证; 1:小于8岁; 2:大于8岁小于16岁;3:大于18岁;4:假身份(格式符合要求的身份证);5:大于16岁小于18岁
//shareOpen 是否开启分享功能 0.不开启 1.开启
-(void) OnUserLogin:(NSDictionary*)param
{
    [self SendCallback:"OnLoginSuc" withParams:param];
}

3.4 支付成功回调​

客户端调用渠道SDK支付成功，一般不需要做逻辑处理，最终支付成功，以U8Server回调通知到游戏服务器为准。

param返回值包括state与extension
其中state为支付状态

state值参数说明
0成功
1用户取消支付
2支付失败，网络错误
3支付失败，支付标识非法
4支付失败，支付信息缺失
-(void) OnPayPaid:(NSDictionary*)param
{
    [self SendCallback:"OnPaySuc" withParams:param];
}

3.5 事件上报回调​

-(void)OnEventCustom:(NSString *)eventName params:(NSDictionary *)params{
    NSLog(@"event Name %@ params %@",eventName,params);
}

3.6 激励视频load广告回调​

param返回值包括state（广告拉取状态）与placementId（广告位ID） 其中state的值为：

state值参数说明
success广告拉取成功
fail广告拉取失败
-(void)OnLoadAdBack:(NSDictionary *)info{
    NSLog(@"激励视频初始化返回 %@",info);
}

3.7 激励视频成功回调​

param返回值包括：

名称说明
state视频观看成功，fail：视频观看失败，open：视频打开，end：视频结束，star：视频开始，close:视频关闭，click：视频点击
rewardAmount若视频观看成功返回奖励金额
rewardName若视频观看成功返回奖励名称
error若视频观看失败返回错误码
msg若视频观看失败返回错误信息
-(void)OnRewardedVideoBack:(NSDictionary *)videoInfo{
    NSLog(@"激励视频返回 %@",videoInfo);
}

3.8 账号绑定回调​

param(NSDictionary类型)中的参数如下：

名称说明
userIDU8Server生成的唯一用户ID
sdkUserID渠道SDK平台用户唯一ID，游戏服务器需要将游戏账户ID和该sdkUserID进行绑定
usernameU8Server生成的用户名，比如234234234.uc,4353453453.baidu,65756756756.360
sdkUserName渠道SDK平台用户名，可能为空，部分渠道SDK没有返回用户名
tokenU8Server生成的会话ID，游戏服务器拿该字段去U8Server做二次登录验证
extensionU8Server返回的扩展字段，部分渠道SDK需要，游戏中无需使用该字段的值
timestampU8Server生成的时间戳，游戏服务器去U8Server做二次登录验证时，传给U8Server
third_login_type第三方登陆类型 0:游客 1:Google,2:facebook,3:apple,4:weixin,5:qq,6:jiguang
-(void)OnBindAccountBack:(NSDictionary *)accountInfo{
    NSLog(@"绑定账号 %@",accountInfo);
}

3.9 切换账号回调​

//param(NSDictionary类型)中的参数如下：
//userID:U8Server生成的唯一用户ID
//sdkUserID:渠道SDK平台用户唯一ID，游戏服务器需要将游戏账户ID和该sdkUserID进行绑定。
//isAdult:布尔值，若为成年人返回为true，其他(未成年或未实名)返回false
//username:U8Server生成的用户名，比如234234234.uc,4353453453.baidu,65756756756.360
//sdkUserName:渠道SDK平台用户名，可能为空，部分渠道SDK没有返回用户名
//token:U8Server生成的会话ID，游戏服务器拿该字段去U8Server做二次登录验证
//extension:U8Server返回的扩展字段，部分渠道SDK需要，游戏中无需使用该字段的值
//timestamp:U8Server生成的时间戳，游戏服务器去U8Server做二次登录验证时，传给U8Server
//third_login_type 第三方登陆类型 0:游客,3:apple,4:weixin,5:qq,6:jiguang
//isCustomRealName 是否需要游戏自定义实名认证界面 Bool值
//isBindPhone 是否绑定手机号 Bool值
//idcardStatus 玩家身份状态 0:没有身份认证; 1:小于8岁; 2:大于8岁小于16岁;3:大于18岁;4:假身份(格式符合要求的身份证);5:大于16岁小于18岁
//shareOpen 是否开启分享功能 0.不开启 1.开启

-(void)OnSwitchAccountBack:(NSDictionary *)accoutInfo{
    NSLog(@"切换账号 %@",accoutInfo);
}

3.10 SDK自带实名认证弹窗 实名成功回调​

-(void) OnRealNameRegister:(NSDictionary *)params
{
    NSLog(@"%@", params);
}

3.11 订阅恢复客户端回调​

回调返回的参数：

名称说明
state回调状态，0：成功，1：失败
restoreArray成功时返回需要恢复订阅的商品id
-(void) OnRestoreCallback:(NSInteger)state restoreArray:(NSMutableArray *)restoreArray{
    NSLog(@"demo点击订阅恢复返回");
}

3.12 获取商品回调​

productArray(NSMutableArray类型)（包含NSDictionary数据的数组），其中NSDictionary中的参数如下：

名称说明
product_id商品id
price价格
symbol货币符号
title标题
-(void) OnProductsInfoBack:(NSMutableArray*)productArray
{
    NSLog(@"%@", productArray);
}

返回值举例：

[
        {
        price = 198;
        "product_id" = "com.mco.game.ppx.m198";
        symbol = "\U00a5";
        title = "1980\U94bb\U77f3";
    },
        {
        price = 30;
        "product_id" = "com.mco.game.ppx.m30";
        symbol = "\U00a5";
        title = "300\U94bb\U77f3";
    }
]

3.13 可以进入游戏回调​

注意

当用户登陆返回isAdult为false时，必须结合此回调方法判断玩家是否可以进入游戏，若收到该回调表示可进入游戏。 当游戏自定义实名认证成功且为非成年人时，必须结合此回调方法判断玩家是否可以进入游戏，若收到该回调表示可进入游戏。

- (void)OnIntoGameBack{
    NSLog(@"可以进入游戏");
}

3.14 分享结果回调​

返回参数shareInfo（NSDictionary）包含以下内容：

名称说明
state0=成功；1=失败；2=取消；3=开始分享；4=分享参数不齐全
platform0=新浪;1=微信聊天;2=微信朋友圈;4=QQ聊天页面;5=qq空间;37=抖音
msg若state=0，返回成功；若state不为0，返回错误原因
-(void) OnShareInfoBack:(NSDictionary *)shareInfo{
    NSLog("share back %@",shareInfo);
}

3.15 问卷初始化回调​

无返回参数，问卷中心存在问卷将回调该函数

-(void) OnInitUserSurveySuccess{
    NSLog(@"可以打开问卷中心");
}

3.16 用户广告来源回调​

param(NSDictionary类型)中的参数如下：

名称说明
ad_platform用户广告来源，natural为自然量，其余为各个广告渠道
-(void) OnAdInfoBack:(NSDictionary*)param
{
    NSLog(@"OnAdInfoBack:%@",param);
}

上面代码写好之后, 这个xcode就是以后打渠道包的母工程。 接下来，就可以通过U8SDK一键打包工具， 打出各个渠道的渠道包。

最后于 更新