SDK接入文档

1 开发包说明

 GameCatSDK.framework 基础包
 GameCatBundle.bundle 资源包
 Bugly.framework 统计包，

• demo只能在真机上运行

2 开发环境配置

2.0 添加依赖包

• 添加sdk依赖包
  GameCatSDK.framework
  GameCatSDKBundle.bundle
  Bugly.framework

• 添加系统依赖包：
  libz.tbd
  libsqlite3.tbd
  StoreKit.framework
  CoreTelephony.framework
  SystemConfiguration.framework

2.1 工程配置

• Deployment Target 设置，最低版本8.0
  

  86773399-CBA6-4665-80D0-FDD5446F9E0E.png

• Device Orientation 设置，sdk只支持横屏
  

  85B88BDC-A8D3-47FC-AFFA-1873FE9BFDA8.png

• info.plist 中添加，以允许http 访问
  

  图4.png

• info.plist 中添加白名单
  

  图5.png

• info.plist中添加iosSdkType，区分企业版与正式版。1:代表企业版， 2:代表appStore版
  

  5A95E7E4-804C-464E-868D-214BE8FC83AB.png

• Other Linker Flags 添加-ObjC
  

  图2.png

• Enable Bitcode设置为NO
  

  C99D3F36-F2AF-4D55-9F19-AEA29295DEB7.png

• URL Types， 一个微信;另 另一个是支付宝
  

  947503-d62316c2588e08c5.png

• 支付宝:填写buildID，对应唯一标识
  微信:我方提供账号文档中有填写，请按照文档中填写

2.2 第三方支付回调配置

  •  以下方法在APPDelegate中添加导入头文件#import 

  - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
  {
       [GCSDK showOpenURLWithURL:url ResultMessage:^(NSInteger statusCode) {
           // 根据statusCode，写游戏业务逻辑
       }];
       return YES;
  }

  // iOS9 以前
  - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
  {
      [GCSDK showOpenURLWithURL:url ResultMessage:^(NSInteger statusCode) {
        // 根据statusCode，写游戏业务逻辑
      }];
      return YES;
  }

  // iOS9 以后
  - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url
  options:(NSDictionary *)options
  {
      [GCSDK showOpenURLWithURL:url ResultMessage:^(NSInteger statusCode) {
        // 根据statusCode，写游戏业务逻辑
      }]；
      return YES;
  }

• 配置完成

3 接口说明

3.0 导入头文件

    #import 

3.1 初始化

  说明:该接 需要在应 加载完成回调中调 ，即
  - (BOOL)application:(UIApplication *)application
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
  参数:
   /**
   * @param serverType  环境(固定写4) 必传
   * @param gameId      游戏Id 必传
   * @param aes_key     aesKey 必传
   * @param app_key     appKey 必传
   * @param chlId       渠道号 必传
   */
  返回值:  无
  调用 :
    [GCSDK  start:@"4"
           gameId:@"xxxxx"
           aesKey:@"xxxxx"
           appKey:@"xxxxx"
            chlId:@"xxxxx"];

3.2 登录

  说明:该接 在需要在初始化之后调 
  参数:
  /**
  * @param loginSuccess  登录成功回调，返回 openId 
  * @param loginFail     登录失败回调
  */
  返回值: openId
  调用:
  [GCSDK loginSuccess:^(NSString *openId) { 
      // 成功回调
  } loginFail:^(NSError *error) {
     // 失败回调
  }];

3.3 登出

  说明：登出时调用
  参数：无
  返回值：无
  调用:
  [GCSDK loginOut:^{
      // ...
  }]；

3.4 充值

  说明:购买游戏道具时调 ，这个接 block 回调是内 付回调
  参数:
  /**
  * @param price                 价格, 必填
  * @param description           产品名称，必填
  * @param codeNo                订单号，必填
  * @param notifyUrl             付成功通知地址，必填
  * @param extend                透传字段
  * @param productId             内支付对应的产品ID，必填
  * @param roleId                角色ID，必填
  * @param roleName              角色名称，必填
  * @param roleServerName        服务名称
  * @param pppSuccess            支付成功回调
  * @param pppFail               支付失败回调
  */
  返回值:  无
  调用:
  [GCSDK recharge:@10 
      description:@” 箱元宝”
           codeNo:@"CodeNo200008"
              url:@"http://xxxxxxxxxx/mockjsdata/11/sdk/notify"
              ext:@"ext"
          product:@"xxxxxxxxxx"
           roleId:@"ziwei"
         roleName:@" 天" 
   roleServerName:@"22222"
          success:^ {
              //  支付成功
           } fail:^(NSError *error) {
              //  支付失败
           }];

3.5 同步角色

  说明：选择角色进入游戏、角色等级变更、昵称修改调用该接口
  参数：
  /**
  * @param roleName     角色名称，必传
  * @param roleServer   角色区服
  * @param roleGrade    角色等级
  * @param roleCamp     角色阵营
  * @param roleId       角色Id，必传
  */
  返回值： 无
  调用：
  [GCSDK  syncRole:@"后羿"
        roleServer:@"王者荣耀"
         roleGrade:@"23" 
          roleCamp:@"123" 
            roleId:@"111"];

3.6 闪屏

  说明:调用显示闪屏接口 ，2秒后自动消失

  调用:
  [GCSDK splash];