美生元SDK接入指南

美生元iOS端SDK接⼊文档(V5.0.6)

一、开发环境

支持iOS 9.0以上系统。

二、接入准备

1、导入以下文件，如图：

导入的文件

2、导入系统库，如图：

需要的库文件

3、配置msyconf.plist文件

plist设置.png

4、在Build Setting 中搜索Other Link Flags添加-Objc如下图：

-Objc设置

5、HTTP网络配置，允许HTTP网络请求，在info.plist中设置如图：

HTTP网络请求设置

三、接入SDK

导入头文件：

1、SDK初始化

在APP周期的 didFinishLaunchingWithOptions 中调⽤SDK初始化方法，并传参packageKey：

#define PACKAGEKEY @"5a19da00-eccf-11e9-8337-00163e0053a4"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //1、SDK初始化
    [[sdk shareInstance] initWithPackageKey:PACKAGEKEY];
   //2、获取SDK的回调，必须遵守代理。
    [sdk shareInstance].myDelegate = self;
    return YES;
}

2、登录接口

//登录界面
- (void)login:(UIViewController *)vctrl;

登录接⼝口参数说明：

参数名	参数类型	参数说明
vctrl	UIViewController	当前页面的ViewController

3、登录回调

- (void)addObserver:(id)info loginResult:(resultType)loginResult;

登录回调参数：

参数名	参数类型	参数说明
info	id	返回的登录信息
loginResult	resultType	登录结果

案例：

- (void)addObserver:(id)info loginResult:(resultType)loginResult{
    NSLog(@"登录信息++++++++info:%@",info);
    NSLog(@"登录结果++++++++++type:%d",loginResult);
    if (loginResult == JX_LoginResult) {
        NSLog(@"登陆成功");
    }else{
        NSLog(@"登陆失败");
    }
}

4、注册回调

- (void)addObserver:(id)info registerResult:(resultType)registerResult;

注册回调参数：

参数名	参数类型	参数说明
info	id	返回的注册信息
loginResult	resultType	注册结果

案例：

- (void)addObserver:(id)info registerResult:(resultType)registerResult{
    NSLog(@"注册信息++++++++info:%@",info);
    NSLog(@"注册结果++++++++++type:%d",registerResult);
    if (registerResult == JX_RegisterResult) {
        NSLog(@"注册成功");
    }else{
        NSLog(@"注册失败");
    }
}

5、退出登录

- (void)logout:(UIViewController *)vc;

注销登录参数说明：

参数名	参数类型	参数说明
vctrl	UIViewController	当前页面的ViewController

6、支付接口

 - (void)jxIapWithProductId:(NSString *)productID Gamename:(NSString *)gameName
                goodsTitle:(NSString *)goodsTitle
                    number:(NSString *)number
        productDescription:(NSString *)productDescription
                     price:(NSString *)price
               gameOrderId:(NSString *)gameOrderId
            userInfoString:(NSString *)userInfo
                    RoleInfo:(NSString *)roleInfo
                  payOrder:(GetPayResultOrderT )order
                 urlScheme:(NSString *)scheme
            viewController:(UIViewController *)vc;

参数名	参数类型	参数说明
productID	NSString	商品ID
gameName	NSString	游戏名称
goodsTitle	NSString	商品名称
number	NSString	商品数量
productDescription	NSString	商品描述
price	NSString	价格(单位:元)
gameOrderId	resultType	支付订单号
userInfo	NSString	透传参数(自定义)
roleInfo	NSString(json格式)	⻆角⾊色信息,请以json格式传参
payOrder	GetPayResultOrderT(block 回调)	H5⽀支付结果回调，返回⽀支付结果0000为成 功,0001为失败
scheme	NSString	与⼯工程配置的scheme⼀一致，具体值⾃自定义
vc	UIViewController	当前ViewController

其中roleInfo必需包含的信息如下：

  {
@"roleID":@"45",//⻆角⾊色ID @"roleName":@"国服第⼀一AD",//⻆角⾊色名 @"vipLevel":@"1",//@"vip等级默认值“1”", @"level":@"2",//@"等级默认值“1”",
}

IAP⽀支付回调:

- (void)jxUpdatePayResult:(UpdatePayInfo)payInfoBlock;

回调信息	类型	信息说明
0	NSString	购买失败
1	NSString	购买成功
2	NSString	用户取消交易
3	NSString	productID不不存在
"timeout"	NSString	链接itunes store超时

7、统计功能接口

a、创建⻆⾊：

-(void)createRoleWithGameRoleName:(NSString *)roleName roleId:(NSString *)roleId gameZone:(NSString *)gameZone;

参数名	必须	参数类型	参数说明
roleName	是	NSString	角色名称
roleId	是	NSString	角色ID
gameZone	是	NSString	区服信息

b、角色登录

-(void)roleLoginSuccessWithRoleName:(NSString *)roleName roleId:(NSString *)roleId gameZone:(NSString *)gameZone;

参数名	必须	参数类型	参数说明
roleName	是	NSString	角色名称
roleId	是	NSString	角色ID
gameZone	是	NSString	区服信息