文档中心 | 一键联接，全心服务

更新日期：2017年 12月 01日QuickSDK-Objective-C（iOS）

<h3>1.Development kit instructions</h3>      · <span style="color: rgb(102, 102, 102); font-family: Tahoma,Arial,宋体,"Malgun Gothic"; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; background-color: rgba(255, 255, 255, 0.8); display: inline ! important; float: none;">SMPCQuickSDK. The framework is the foundation library, libSMPCQuickChannel. Each channel a is the implementation of the library.<h3>2.Access to the steps</h3><h4>      2.1 QuickSDK process</h4><span id="tran_0" data-aligning="#tran_0,#src_0" class="copied" style="margin: 0px; padding: 0px; border: 0px; outline: 0px; color: rgb(102, 102, 102); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);">    <span id="tran_0" data-aligning="#tran_0,#src_0" class="copied" style="margin: 0px; padding: 0px; border: 0px none; outline: 0px none; color: rgb(102, 102, 102); font-family: Tahoma,Arial,宋体,"Malgun Gothic"; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; background-color: rgba(255, 255, 255, 0.8);">Games, access to the SDK comes with female package library interface.<br style="color: rgb(67, 67, 67); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);"/><span id="tran_1" data-aligning="#tran_1,#src_1" class="copied" style="margin: 0px; padding: 0px; border: 0px none; outline: 0px none; color: rgb(102, 102, 102); font-family: Tahoma,Arial,宋体,"Malgun Gothic"; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; background-color: rgba(255, 255, 255, 0.8);">    In the channels of QuickSDK add background, configuration parameters.<br style="color: rgb(67, 67, 67); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);"/><span id="tran_2" data-aligning="#tran_2,#src_2" class="copied highLight" style="margin: 0px; padding: 0px; border: 0px none; outline: 0px none; color: rgb(102, 102, 102); font-family: Tahoma,Arial,宋体,"Malgun Gothic"; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; background-color: rgba(255, 255, 255, 0.8);">    Test after use, packaging tools to generate channel, part of the channel to escape equipment test.<span id="tran_2" data-aligning="#tran_2,#src_2" class="copied highLight" style="margin: 0px; padding: 0px; border: 0px; outline: 0px; color: rgb(102, 102, 102); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);"><h4>     2.2 Development environment configuration</h4>    will SMPCQuickSDK. Framework and female bag libSMPCQuickChannel. A added to the project, and select the corresponding target<br style="color: rgb(67, 67, 67); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);"/>    Will Architectures, in the Build Settings set to armv7 + arm64, need support arm64 project itself.<br style="color: rgb(67, 67, 67); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);"/>    Other would add - ObjC Flags      <img src="http://data.quicksdk.net//data/newFiles/image/20171130/1512034210825893.png" title="1452827233624023.png" alt="123.png"/>       The direction of the selected game compatible, Device Orientation.Common configuration      <img src="/data/newFiles/image/20171130/1512029869283756.png" title="1458789174161068.png" alt="1.png"/>      <img src="/data/newFiles/image/20171130/1512029872714529.png" title="1458789178689621.png" alt="2.png"/>           info. Plist add to allow HTTP access      <img src="/data/newFiles/image/20171130/1512029873666777.png" title="1457597955974009.png" alt="2.png"/>      Game is configured<span style="margin: 0px; padding: 0px; border: 0px none; outline: 0px none; color: rgb(102, 102, 102); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; font-size: 16px; font-family: 微软雅黑,Microsoft YaHei; background-color: rgb(255, 255, 255);">The Version of the game (CFBundleShortVersionString) and Build (CFBundleVersion) must be consistent, and using the point X.Y.Z fraction, such as: 1.2.1<span id="tran_0" data-aligning="#tran_0,#src_0" class="copied inactive" style="font-size: 16px; margin: 0px; padding: 0px; border: 0px none; outline: 0px none; color: rgb(102, 102, 102); background-color: rgb(238, 238, 238); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px;"><br style="color: rgb(67, 67, 67); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8);"/><span id="tran_1" data-aligning="#tran_1,#src_1" class="copied" style="font-size: 16px; margin: 0px; padding: 0px; border: 0px none; outline: 0px none; color: rgb(102, 102, 102); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; background-color: rgba(255, 255, 255, 0.8);">In front of the Numbers don't add 0.Because each channel update reads the Version number is different, set Version and Build consensus to ensure that all channels to update all, if this is not willing to set up, debugging can be generated through the engineering manual package there is a requirement for such channels, require the Version and Build consistent channel is not much, can after audit can modify again.      <img src="/data/newFiles/image/20171130/1512029873388943.png" title="1458034056773242.png" alt="1.png"/> <h3>3.Interface specification</h3>       <span style="color: rgb(102, 102, 102); font-family: Tahoma,Arial,宋体,"Malgun Gothic"; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; text-align: justify; text-indent: 0px; text-transform: none; word-spacing: 0px; background-color: rgba(255, 255, 255, 0.8); display: inline ! important; float: none;">First configuration project information<h4 style="line-height: 3em;">     3.1 Initialize（necessarily）</h4>      3.1.1  instance       Class：SMPCQuickSDK      function：+ (SMPCQuickSDK *)defaultInstance;      instructions：Get QuickSDK instance        3.1.2 init QuickSDK      Class：SMPCQuickSDK      function：<pre class="brush:java;toolbar:false">- (int)initWithConfig:(SMPCQuickSDKInitConfigure *)configure application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions; </pre>      instructions：Use productKey, productCode, initialize the SDK, by QuickSDK distribution platform, on the iOS packaging tools as you can see, the need when packaging and iOS packaging tools on the choice of product parameters.      parameter：Configure encapsulates the productKey and productCode      application: Application of application, the parameters of the function call intact incoming      launchOptions:Application launchOptions, calls the function of the parameters of the intact incoming.      instructions：The interface need to call in the application loaded callback, namely      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{}    function：    - (int)initWithConfig:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;<span style="color: rgb(102, 102, 102); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgba(255, 255, 255, 0.8); display: inline !important; float: none;">/ / design for QuickSDK technician test used to initialize interface.When using this initialization scheme, QuickSDK will use packaging tools on the choice of product configuration corresponding to the background of SMPCQuickSDKInitConfigure, so suitable for mother not debugging package engineering directly out of the channel package engineering and channels to debug the situation.        Example：<pre class="brush:java;toolbar:false">[[NSNotificationCenter defaultCenter] addObserver:self             selector:@selector(smpcQpInitResult:)             name:kSmpcQuickSDKNotiInitDidFinished             object:nil];     - (void)smpcQpInitResult:(NSNotification *)notify {          NSLog(@"%@",notify);    }    SMPCQuickSDKInitConfigure *cfg = [[SMPCQuickSDKInitConfigure alloc] init];    cfg.productKey = @”09633196”;    cfg.productCode = @”50840817638746911281319234382938”;        int error = [[SMPCQuickSDK defaultInstance] initWithConfig:cfg application: application didFinishLaunchingWithOptions:launchOptions];    if (error != 0) {        NSLog(@"Initialization failed：%d",error);    } </pre> <h4 style="line-height: 3em;">     3.2 Uesr API </h4>       3.2.1 Log in（necessarily）      Class：SMPCQuickSDK      function：- (int)login;      instructions：Log in procedure      return value<span style="color: rgb(102, 102, 102); font-family: Tahoma, Arial, 宋体, 'Malgun Gothic'; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 24px; orphans: auto; text-align: justify; text-indent: 0px; text-transform: none; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(238, 238, 238); display: inline !important; float: none;">：If the returned value is 0 the calling API is succeed, if there’s other value refer to returned value instruction         After receiving log in notification kSmpcQuickSDKNotiLogin，that you can get returned value userInfo, user uid,user name and user_token，or obtain uid by using API,Name, reference demo(which is optional) by obtaining the user information by user_token from the server.There is relevant example of using the API. this uid is only identification which is provided by markets SDK, and there may be repeated uid in different markets.      Example：<pre class="brush:java;toolbar:false">5..(void)smpcQpLoginResult:(NSNotification *)notify { NSDictionary *userInfo  = [notify userInfo]; int error = [userInfo objectForKey:@”error”] intValue]; if (error == 0) {             NSString *uid = [[SMPCQuickSDK defaultInstance] userId];         NSString *userNick = [[SMPCQuickSDK defaultInstance] userNick];         NSString *user_token = [[SMPCQuickSDK defaultInstance] userToken]; } } </pre>      3.2.2 Log out API       Class：SMPCQuickSDK      function： - (int)logout;      instructions：Log out the current users.      return value：0 stands for success, other value refer to instructions      Attention：Calling Log out API ,QuickSDK will send a log out notificationkSmpcQuickSDKNotiLogout。       3.2.3 User uid      Class：SMPCQuickSDK      function：- (NSString *)userId;      instructions：To obtain currently logged in user uid, this uid is only identification which is provided by markets SDK, and there may be repeated uid in different markets.      return value:Current logged in user uid        3.2.4 User userToken      Class：SMPCQuickSDK      function：- (NSString *)userToken      instructions：Obtain the last log in user userToken to test user identity on server.      return value：The userToken of current log in user or the last log in user       3.2.5 User name       Class：SMPCQuickSDK      function：- (NSString *)userNick;       3.2.6 updating role information (necessarily)      Class：SMPCQuickSDK      function：- (void)updateRoleInfoWith:(SMPCQuickSDKGameRoleInfo *)info isCreate:(BOOL)isCreate;      instructions：Updating role information.isCreate means whether create role when accessing game calling role updating.      parameter：info role information object,reference class  SMPCQuickSDKGameRoleInfo returned value;      return value:  <h4 style="line-height: 3em;">     3.3 Recharge API </h4>      3.3.1 Recharge (necessarily)      Class：SMPCQuickSDK      function：- (int)payOrderInfo:(SMPCQuickSDKPayOrderInfo *)orderInfo      roleInfo:(SMPCQuickSDKGameRoleInfo *)roleInfo;      instructions：Order payment      parameter：orderInfo   order information       roleInfo    player role information     <pre class="brush:java;toolbar:false">instructions： productName of orderinfo is just a general name , such as ‘Gold’,’Ingot’, quantity of product is not included in productName; quantifier means unit ; count means quantity ; amount means total prices, the unit price is integer or decimal that can be calculated by integer via dividing 10, and total price must equal unit price multiply by quantity. The product name of market recharge API: count+quantifier+productName;Price is amount.</pre>             Asynchronous recharge, Game client will receive the recharge result notification if players recharged.kSmpcQuickSDKNotiRecharge，SDK notification is for reference only, the official result is subjected to QuickSDK server synchronization.<h4 style="line-height: 3em;">     3.4 Extension API </h4>        3.4.1 AppDelegate Events call(necessarily)      Instruction： There’s no need for Unity3D and Cocos2d-x game to access following code while QuickTool will auto add them. <pre class="brush:java;toolbar:false">- (void)applicationWillResignActive:(UIApplication *)application {     [[SMPCQuickSDK defaultInstance] applicationWillResignActive:application]; } - (void) applicationDidEnterBackground:(UIApplication *)application {     [[SMPCQuickSDK defaultInstance] applicationDidEnterBackground:application]; } - (void) applicationWillEnterForeground:(UIApplication *)application {              [[SMPCQuickSDK defaultInstance] applicationWillEnterForeground:application]; } - (void) applicationDidBecomeActive:(UIApplication *)application {     [[SMPCQuickSDK defaultInstance] applicationDidBecomeActive:application]; } - (void) applicationWillTerminate:(UIApplication *)application {     [[SMPCQuickSDK defaultInstance] applicationWillTerminate:application]; } - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken     {     [[SMPCQuickSDK defaultInstance] application:application didRegisterForRemoteNotificationsWithDeviceToken:deviceToken]; } - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error     {     [[SMPCQuickSDK defaultInstance] application:application didFailToRegisterForRemoteNotificationsWithError:error]; } - (void)application:(UIApplication *)application didReceiveRemoteNotification:(nonnull NSDictionary *)userInfo{     [[SMPCQuickSDK defaultInstance] application:application didReceiveRemoteNotification:userInfo]; } -(UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(nullable UIWindow *)window {     [[SMPCQuickSDK defaultInstance] application:application supportedInterfaceOrientationsForWindow:window];     return  UIInterfaceOrientationMaskAll; }     - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{     [[SMPCQuickSDK defaultInstance] openURL:url application:application];     return YES; }     - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{     [[SMPCQuickSDK defaultInstance] openURL:url sourceApplication:sourceApplication application:application annotation:annotation];     return YES; }    - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options{     [[SMPCQuickSDK defaultInstance] openURL:url application:app options:options];     return YES; } </pre>        3.4.2 Showing Floating menu      Class：SMPCQuickSDK      function：- (void)showToolBar:(SMPC_QUICK_SDK_TOOLBAR_PLACE)place;      instructions：Showing floating toolbar,if there’s no such corresponding API to market, the calling is failed.      Example：calling when user log in succeed      [[SMPCQuickSDK defaultInstance] showToolBar:SMPC_QUICK_SDK_TOOLBAR_TOP_LEFT];       3.4.3 Hiding Floating menu      Class：SMPCQuickSDK      function：- (void)hideToolBar;      instructions：Hiding floating toolbar,if there’s no such corresponding API to market, the calling is failed.      Example：Hiding if it is necessary.       3.4.4 Access in User center      Class：SMPCQuickSDK      function：- (int)enterUserCenter;      instructions：Access in user center, if there’s no such corresponding API to market, the calling is failed.       3.4.5 Access in customer service center     Class：SMPCQuickSDK      function：- (int)enterCustomerCenter;      instructions：Access in customer service center.      if there’s no such corresponding API to market, call it directly will return the unsupported error code to API.        3.4.6 Access in BBS      Class：SMPCQuickSDK      function： - (int)enterBBS;      instructions：Access in BBS      if there’s no such corresponding API to market, call it directly will return the unsupported error code to API.       3.4.7 Whether to support the assigned method      Class：SMPCQuickSDK      function：-(BOOL)isFunctionTypeSupported:(SMPC_QUICK_SDK_FUNC_TYPE)type;      instructions：To judge market SDK whether support the API, the APIs such as user center,customer service center,BBS and pause etc,are not all availiable to each market,so it can be judged in code. if there’s no such corresponding API to market, call it directly will return the unsupported error code to API, calling failed,noting would happen.<h4 style="line-height: 3em;">      3.5 Other APIs </h4><pre class="brush:java;toolbar:false">- (int)channelType; //  the only identification of market #pragma mark The basic information platform - (NSString *)getConfigValue:(NSString *)key; // obtain the user-defined parameter which was configured in Quick background. </pre><h2 style="line-height: 3em;">4.SDKnotify instruction</h2><h4 style="line-height: 3em;">     4.1 Initialization notification</h4>      attribute：kSmpcQuickSDKNotiInitDidFinished      instructions：Calling initialization API,then asynchronization.Whether the SDK initialization successed can be judge by error code after receiving the notification.<pre class="brush:java;toolbar:false">SMPC_QUICK_SDK_ERROR_NONE、SMPC_QUICK_SDK_ERROR_INIT_FAILED。 NSDictionary *userInfo = notify.userInfo; int errorCode = [userInfo[kSmpcQuickSDKKeyError] intValue]; switch (errorCode) {        case SMPC_QUICK_SDK_ERROR_NONE:        {        } break;        case SMPC_QUICK_SDK_ERROR_INIT_FAILED:        default:        {        } break; } </pre><h4>     4.2 Login success notification</h4>      attribute：kSmpcQuickSDKNotiLogin      instructions：Once market SDK user login successed,it will receive the notification.If the error code shows user identification failed, user information can not pass the market user login second test,that need to call log out API.Recalling login in log out notification, contact us to obtain relevant user test failed information.<h4 style="line-height: 3em;">      4.3 Log out notification</h4>      attribute：kSmpcQuickSDKNotiLogout      instructions：There are 2 situations      A）Users successfully log out from market SDK user management interface.      B）Game client call QuickSDK user log out,to judge whether the log out successed by error code. <h4 style="line-height: 3em;">     4.4 Recharge result notification</h4>      attribute：kSmpcQuickSDKNotiRecharge      instructions：Calling QuickSDK recharge API successed.      There are 3 notification results situation which was judged by error code （SMPC_QUICK_SDK_ERROR_NONE、SMPC_QUICK_SDK_ERROR_RECHARGE_FAILED、         SMPC_QUICK_SDK_ERROR_RECHARGE_CANCELLED）      The result is for reference only, the official result according to server synchronization.       userInfo notification instruction：<pre class="brush:java;toolbar:false">int error = [[userInfo objectForKey:kSmpcQuickSDKKeyError] intValue]; //QuickSDK OrderID、cpOrderID NSString *orderID = userInfo[kSmpcQuickSDKKeyOrderId]; NSString *cpOrderID = userInfo[kSmpcQuickSDKKeyCpOrderId];     </pre> <h4 style="line-height: 3em;">     4.5 Suspended over notice</h4>      attribute：kSmpcQuickSDKNotiPauseOver      instructions：Don't listen, some source SDK pause at the end of the notice <h3 style="line-height: 3em;"> 5.API instructin</h3>      All markets of QuickSDK support initialization API, User API, Recharge API. All APIs can be called directly,if market does not support, the calling is failed.