Skip to content

Latest commit

 

History

History
148 lines (91 loc) · 4.92 KB

README_CN.md

File metadata and controls

148 lines (91 loc) · 4.92 KB

Other languages: Vietnamese | English

Get Started

iOS Appota Game SDK 是让你的应用集成Appota 用户和支付系统的最简单方式。 本SDK提供: 短信、充值卡、网络银行、支付宝、Google Play Payment等各种支付方式的解决方案。

添加SDK的步骤:

1.安装Appota SDK

  1. 配置 SDK

  2. 集成

  3. 了解 Appota SDK flow

1. 安装 Appota SDK

把Appota.framework Import 到 project

把AppotaSDK.framework 和 AppotaBundle.bundle拖放到你的project

在 checkbox: “Copy items into destination group's folder (if needed)”画勾 在 Project app’s target settings, 找到[Build phases] 然后打开 [Link Binary with Libraries]. 点击 ‘+’ 号然后添加以下的frameworks:

    AppotaSDK, QuaztCore, CoreText, StoreKit, AudioToolBox, MobileCoreServices, AVFoudation, CoreVideo,
    MessageUI, Security, SystemConfiguration, CFNetwork, OpenGLES, CoreMedia, libxml2.dylib, libsqlite3.dylib

在 [project build settings], 找到 [Other Linker Flags], 添加以下两个价值: -ObjC, -lc++ và -all_load.

把file header import到你想要使用SDK 的file code:

    #import <AppotaSDK/AppotaSDK.h>

用CLIENT_KEY来Config plist

添加一个AppotaClientId 价值为 CLIENT_ID. 再添加schema: 添加一个Array式的 URL types.建造另一个item其URL Schemes是appotaCLIENT_ID。

比如:如果 CLIENT_ID = b804d6421df6ae7dbcd51469e4d8ee0005101f540 ,那schemes将是 appotab804d6421df6ae7dbcd51469e4d8ee0005101f540.

2. 配置 SDK

** Appdelegate配置SDK:**

+AppDelegate.h

把AppotaGameSDKConfigureDelegate protocol 添加到AppDelegate

+AppDelegate.m

使用 class AppotaGameSDKConfigure 以便配置 SDK.

-初始化付费列表(在class AppotaPayment描写支付item)

  • 初始化 AppotaGameSDKConfigure 用: CLIENT_ID:在dev.appota.com 配置(在sandbox状态用SANDBOX_CLIENT_ID).
    CLIENT_SECRET: 在dev.appota.com \配置 INAPP_API_KEY: 在dev.appota.com 配置(在 sandbox状态用SANDBOX_INAPP_API_KEY).
    noticeUrl:当交易成功是叫出的URL.
    configUrl:到JSON配置文件的URL
    [AppotaGameSDKConfigure configureWithClientID:CLIENT_ID
        withClientSecret:CLIENT_SECRET
        withInAppAPIKey:INAPP_API_KEY
        withState:@"YOUR_PAYMENT_STATE" 
        withNoticeUrl:@"http://filestore9.com/test.php"
        withConfigUrl:@"http://filestore9.com/config.json" 
    ];

如果你想要集成Facebook, Google, Twitter账号登录的功能,请参考每类SDK的指导。使用FBSDK要配置info.plist 和 FacebookAppId, 使用Google SDK要配置googleClientId(参考AppotaGameTest)

-给 AppotaGameSDKConfigure 设定delegate (应该使用 Appdelegate).

    [AppotaGameSDKConfigure sharedGameConfig].delegate = self;

-用callback函数 - (void) didFinishLogin:(NSDictionary *)userInfoDict以便Handle登录状态 (UserInfo dict可在确认过程中使用). -用 callback 函数- (void) didLogOut:(NSString*) userName 以便Handle退出状态

-用callback函数 - (void) didFinishPaymentWithDictionary:(NSDictionary*)paymentDict 以便Handle交易状态 withState:(AppotaPaymentState)status withError:(NSError*) error

-如果要使用更多handle, 在 AppDelegate打开URL:

(BOOL) application:(UIApplication \*)application openURL:(NSURL \*)url sourceApplication:(NSString \*)sourceApplication annotation:(id)annotation {\
    return [AppotaGameSDKConfigure handleOpenURL:url sourceApplication:sourceApplication annotation:annotation];\
 }

配置JSON:

Appota Game SDK给开发商提供一个便利的配置方式。 您需要进行一下的步骤以便使用Appota Game SDK

  • 使用JSON Generator来 创造有配置的JSON 文件 (https://developer.appota.com/sdktool.php). -把JSON配置文件Upload 到可以访问的host
  • 设置 *[AppotaGameSDKConfigure sharedGameConfig].jsonConfigUrl 传到 file JSON的链接

3. 集成 SDK

所有的SDK实施函数都能从class AppotaGameSDKConfigure进入。 各个辅助函数:

+showSDKView: 显示 SDK界面 +logOut: 显示 logout界面 +(NSDictionary): getUserInfo*在 NSDictionary拿取 user 信息(acces_token,username, email…) +(NSString): getUserName: 拿取 username +(NSString): getUserId: 拿取 userid +(NSString): getAccessToken: 拿球 access token +showPaymentView: 显示交易界面 +showLoginView: 显示login界面 +showSwitchUserView:显示switch user 界面 +showPaymentButton, hidePaymentButton:显示/隐藏Appota SDK默认按钮 +sharedGameConfig: AppotaGameSDKConfigure 的Singleton shared instance

4. Appota SDK Flow

User login flow using Appota SDK

Payment flow using Appota SDK

关于 该flow的更详细信息,请进入Wiki: https://github.com/appota/ios-game-sdk/wiki