1 开发包说明
GameCatSDK.framework 基础包
GameCatBundle.bundle 资源包
Bugly.framework 统计包，<ps:如果项 中已经有 ，就 需要再接 ，避免冲突>
- 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.086773399-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设置为NOC99D3F36-F2AF-4D55-9F19-AEA29295DEB7.png
-
URL Types， 一个微信;另 另一个是支付宝947503-d62316c2588e08c5.png
- 支付宝:填写buildID，对应唯一标识
微信:我方提供账号文档中有填写，请按照文档中填写
2.2 第三方支付回调配置
• 以下方法在APPDelegate中添加导入头文件#import <GameCatSDK/GCSDK.h>
- (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<UIApplicationOpenURLOptionsKey,id> *)options
{
[GCSDK showOpenURLWithURL:url ResultMessage:^(NSInteger statusCode) {
// 根据statusCode，写游戏业务逻辑
}]；
return YES;
}
- 配置完成
3 接口说明
3.0 导入头文件
#import <GameCatSDK/GCSDK.h>
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];