幫助文檔

快發助手Object-C接入文檔

1.介紹

快發助手SDK針對繁瑣的越獄CP SDK接入過程,通過整合三方渠道,提供統一的功能函數入口,并提供多渠道一鍵打包方式,達到了高度簡化接入流程、縮短項目周期、更加專注游戲本身的目的。

2.接入前準備

2.1 官網下載資源包,詳細閱讀快發助手參考文檔。解壓后文件目錄如下:

ios-1.jpg

2.2 聯系運營或者官網注冊獲取GameKey等信息,供后面游戲接入使用。

2.3 收集CP參數配置信息(參數配置:參見3.8)。

2.4 接入環境(推薦xcode6.0++)。

3.接入流程

3.1 將之前準備階段下載的資源包解壓,將目錄下的lib文件夾下面的所有文件拖放項目目錄中,并且勾選Copy items if needed選項。效果參見下圖:

ios-2.jpg

3.2 設置屬性:targets ->Build phases ->Link Binary With Libraries & targets ->build phases ->Embed Frameworks;效果如下:

ios-3.jpg

3.3 設置屬性:targets ->Build Settings ->Linking ->Runpath Search Paths屬性,添加依賴項:@executable_path/;targets ->Build Settings ->Linking ->Mach-O Type屬性,添加依賴項Executable;效果圖如下:

ios-4.jpg

3.4 設置屬性:targets ->Build Settings ->Code Signing Resource Rules Path屬性,添加依賴項:$(SDKROOT)/ResourceRules.plist;效果圖如下:

ios-5.jpg

3.5 設置屏幕支持方向

3.6 設置屬性:targets –>Info ->URL Types,添加2個URL Schemes,Identifier分別為MyGameSchemes和alipay。推薦URL Schemes值為Identifier + your bundleID的方式,效果圖如下:

ios-6.jpg

3.7 設置游戲Icon Image和LaunchImage(請注意iOS圖標尺寸標準,快發助手打包過程只添加角標,不對尺寸做出更改)。

3.8 根據準備階段收集的KEY,填寫Configure.xml配置文件,如下:

<?xml version="1.0" encoding="UTF-8"?>
<!-- 平臺初始化配置文件-->
<confingure>
    
    <!-- 整合平臺key -->
    <PTGameKey>0e0e978cb50c65f5e725ce0f5b5095f5</PTGameKey>
    <!-- 整合平臺渠道號 -->
    <PTGameChannel></PTGameChannel>
    
    <!-- 渠道名稱 -->
    <CPName>dl</CPName>
    <!-- 渠道版本號 -->
    <CPVersion>1.0.0</CPVersion>
    <!-- 渠道分配appid -->
    <CPAppID>195</CPAppID>
    <!-- 渠道分配appKey -->
    <CPAppKey>j5VEvxhc</CPAppKey>
    <!-- 渠道 Gamekey -->
    <CPGameKey></CPGameKey>
    <!-- 渠道 GameChannel -->
    <CPGameChannel></CPGameChannel>
    <!-- 給平臺預留的私有key 比如:cukey -->
    <CPPrivateKey></CPPrivateKey>
    <!-- 是否開啟自動登錄 1:開啟 2:關閉 -->
    <CPAutoLogin>1</CPAutoLogin>
    <!-- 是否強制更新 1:開啟 2:關閉 -->
    <CPForceUpdate>1</CPForceUpdate>
    <!-- 是否強制登錄 1:開啟 2:關閉 -->
    <CPForceLogin>1</CPForceLogin>
    
    <!-- 是否調試模式 1:調試模式(debug)  0:發布模式(release)  -->
    <DEV_ISDebugModel>1</DEV_ISDebugModel>
    <!-- 是否顯示浮動框或者操作條 1:顯示   0:不顯示 -->
    <DEV_ShowFloatWindowOrBar>1</DEV_ShowFloatWindowOrBar>
    <!-- 懸浮框??康奈恢?1:上左 2:上中 3:上右 4:中左  5:中右 6.底左 7:底中 8:底右 -->
    <DEV_FloatWindowOrBarScreenPlace>6</DEV_FloatWindowOrBarScreenPlace>
    <!-- 支持屏幕方向 1:豎屏正向 2:豎屏倒立 3:橫屏左方向 4:橫屏右方向 
        5:橫屏雙方向(不支持則3)6:橫屏雙方向(不支持則4) 7:所有方向(不支持則6)-->
    <DEV_SupportScreenOrientation>3</DEV_SupportScreenOrientation>
    
    <!-- 設置充值頁面初始化金額 -->
    <PAY_DefaultPayAmount>10</PAY_DefaultPayAmount>
    <!-- 商戶私有信息 -->
    <PAY_ShopingPrivateInfo>商戶私有信息</PAY_ShopingPrivateInfo>
    <!-- 支付回調地址 -->
    <PAY_PayNotifyUrl>www.baidu.com</PAY_PayNotifyUrl>
    <!-- 商戶ID -->
    <PAY_MerchantId>101</PAY_MerchantId>
    <!-- app 之間通信  支付寶 -->
    <PAY_AlipayScheme>alipay-com.gameworks.GameKitDemo</PAY_AlipayScheme>
    <!-- 應用Scheme -->
    <PAY_AppScheme>com.gameworks.GameKitDemo</PAY_AppScheme>

</confingure>

4.SDK接口說明

4.1 Configure.xml配置文件說明

參數 定義說明 取值說明
PTGameKey 整合平臺key 快發助手提供
PTGameChannel 整合平臺渠道號 快發助手提供
CPName 渠道名稱 CP提供
CPVersion 渠道版本號 CP提供
CPAppID 渠道分配appid CP提供
CPAppKey 渠道分配appKey CP提供
CPGameKey 渠道的GameKey CP提供
CPGameChannel 渠道的GameChannel CP提供
CPPrivateKey 給平臺預留的私有key CP提供
CPAutoLogin 是否開啟自動登錄 游戲方設定
1:自動登錄 0:不自動登錄
CPForceUpdate 是否強制更新 游戲方設定
1:開啟 0:關閉
CPForceLogin 是否強制登錄 游戲方設定
1:開啟 0:關閉
DEV_ISDebugModel 是否為調試模式 游戲方設定
1:開啟 0:關閉
DEV_ShowFloatWindowOrBar 是否顯示懸浮框或者操作條 游戲方設定
1:顯示 0:不顯示
DEV_FloatWindowOrBarScreenPlace 懸浮框??课恢?/td> 游戲方設定,必填
1.上左 2.上中 3.上右 4.中左 5.中右 6.底左 7.底中
8.底右
DEV_SupportScreenOrientation 屏幕方向 游戲方設定
1.豎屏正向 2.豎屏倒立
3.橫屏左方向 4.橫屏右方向
5.橫屏雙方向(不支持則3)
6.橫屏雙方向(不支持則4)
7.所有方向(不支持則6)
PAY_DefaultPayAmount 設置充值頁面初始化金額 游戲方設定
PAY_ShopingPrivateInfo 商戶私有信息 游戲方設定
PAY_PayNotifyUrl 支付回調地址 游戲方設定
PAY_AlipayScheme app之間通信 支付寶 游戲方設定,同URL Types的alipayScheme一致
PAY_MerchantId 商戶ID 游戲方設定
PAY_AppScheme 應用Scheme 游戲方設定,同URL Types的MyGameSheme一致

4.2 函數接入流程

ios-7.jpg

4.3 CP功能點檢測調用說明(可不接入)

函數定義 注釋說明
-(BOOL)hasProvide_nomal_login_service; 檢測渠道是否提供 用戶名登錄 服務
-(BOOL)hasProvide_guest_login_service; 檢測渠道是否提供 快速登錄 服務
-(BOOL)hasProvide_gusetTonomal_service; 檢測渠道是否提供 快速登錄用戶轉為注冊用戶 服務
-(BOOL)hasProvide_isLogined_service; 檢測渠道是否提供 檢查是否登錄 服務
-(BOOL)hasProvide_getloginedUser_service; 檢測渠道是否提供 獲取登錄用戶信息 服務
-(BOOL)hasProvide_loginout_service; 檢測渠道是否提供 注銷登錄 服務
-(BOOL)hasProvide_usercenter_service; 檢測渠道是否提供 進入用戶中心 服務
-(BOOL)hasProvide_changeuser_service; 檢測渠道是否提供 切換用戶 服務
-(BOOL)hasProvide_openurl_service; 檢測渠道是否提供 openUrl 服務
-(BOOL)hasProvide_checkupdate_service; 檢測渠道是否提供 檢查更新 服務
-(BOOL)hasProvide_pay_service; 檢測渠道是否提供 支付充值 服務
-(BOOL)hasProvide_checkorder_service; 檢測渠道是否提供 訂單查詢 服務
-(BOOL)hasProvide_showFloatWindowOrBar_service; 檢測渠道是否提供 顯示/隱藏浮動窗口或者操作欄 服務
-(BOOL)hasProvide_statistics_UserLogin_service; 檢查渠道是否提供 統計用戶登錄 服務
-(BOOL)hasProvide_statistics_Pay_service; 檢查渠道是否提供 統計支付 服務
-(BOOL)hasProvide_statistics_CreateRole_service; 檢查渠道是否提供 統計玩家創建角色 服務
-(BOOL)hasProvide_statistics_UserUpGrade_service; 檢查渠道是否提供 統計玩家升級 服務
-(BOOL)hasProvide_statistics_BtnClickEvent_service; 檢查渠道是否提供 統計按鈕點擊 服務
-(BOOL)hasProvide_response_continueEvent_service; 檢查渠道是否提供 響應游戲繼續 事件處理服務
-(BOOL)hasProvide_response_suspendEvent_service; 檢查渠道是否提供 響應游戲暫停 事件處理服務
-(BOOL)hasProvide_response_stopEvent_service; 檢查渠道是否提供 響應游戲停止 事件處理服務

4.4 SDK 回調函數接入API

函數定義 注釋說明
-(void)gameKitInitCompletedISSucceedStatus:(BOOL) isSucceed error:(GWError *)error; 平臺初始化回調函數
-(void)rigisterCompletedWithResponseData:(GWUserInfo *)obj; 注冊成功回調函數
-(void)loginCompletedWithLoginStatus:(LoginStatus)loginStatus responseObj:(GWUserIn
fo *)obj error:(GWError *)error;
登錄回調接口
-(void)payCompletedWithPayStatus:(PayStatus)payStatus responseObj:(GWPayBackInfo *
)obj error:(GWError *)error;
支付回調接口
-(void)LoginOutCompletedISSucceedStatus:(BOOL) isSucceed error:(GWError *)error; 登錄注銷完成回調
-(void)checkOrderCompletedWithData:(GWCheckOrderInfo *)obj error:(GWError *)error; 訂單查詢
-(void)checkUpdateCompletedWithData:(GWUpdateInfo *)obj error:(GWError *)error; 檢查更新獲取回調數據

4.5 功能函數API調用說明

函數定義 注釋說明
+(GameKitSDK *)defaultSdk; 獲取單例對象
-(void)initWithObserver:(id) observer params:(GameKitInitParam *)params; 注冊統一回調函數&&初始化參數
-(void)nomalLogin; 登錄
-(void)guestLogin; 游客登錄(快速登錄)
-(void)guestRegist; 游客轉為注冊賬號
-(bool)isLogined; 是否登錄
-(void)loginOut; 注銷登錄
-(void)userCenter; 用戶中心
-(void)swapAccount; 切換用戶
-(GWUserInfo *)loginUserInfo; 獲取登錄用戶信息
-(void)pay:(GWPayOrder *)order; 提交訂單
-(void)checkOrder:(NSString *)orderId; 查詢訂單(非必須接入)
-(void)showFloatWindowOrBar:(BOOL) isShow; 是否顯示浮動窗口或者操作欄
-(void)checkUpdate; 檢查更新
-(void)statisticsUserLogin:(NSDictionary *)info; 用戶登錄統計(非必須接入)
-(void)statisticsPay:(NSDictionary *)order; 支付統計(非必須接入)
-(void)statisticsUserUpGrade:(NSDictionary *)info; 玩家升級統計(非必須接入)
-(void)statisticsCreateRole:(NSDictionary *)info; 玩家創建角色統計(非必須接入)
-(void)statisticsBtnClickEvent:(NSDictionary *)info; 按鈕點擊統計(非必須接入)
-(void)gameContinueEvent; 繼續游戲(非必須接入)
-(void)gameSuspendEvent; 暫停游戲(非必須接入)
-(void)gameStopEvent; 停止游戲
-(void)application:(UIApplication *)application openURL:(NSURL *)url sourceAp
plication:(NSString *)sourceApplication annotation:(id)annotation;
open url 跳轉

5.常見接入錯誤處理

參見:demo

6.技術支持

點擊訪問:快發助手開發者社區
QQ:940111913
Email:support@haojieru.com

為了盡快響應您的反饋,請提供您的gamekey及log中的詳細出錯日志,您所提供的內容越詳細越有助于我們幫您解決問題。


国内2020揄拍人妻在线视频_亚洲日韩色欲色欲com_欧美日韩一区不卡在线观看