【支付】Cocos2d-x IOS內購（IAP支付）

峻峰飛陽發表於2016-10-20
iOS


【說明】

遊戲開發中，整合支付是一個重要的環節，AppStore稽核指南規定，App內虛擬物品必須使用IAP支付。這篇文章主要記錄我在整合IAP的過程，我參考了泰然網的一篇文章，對其進行了封裝和擴充套件，並對結構和使用流程進行了簡單的介紹，僅供自己學習使用。

關於iTunes Connect上的商品配置，可以參考泰然網的文章，這裡只對程式碼進行討論。

更新：加入內購恢復介面，一鍵恢復購買過的非消耗型商品。（蘋果規定費消耗型商品必須要有恢復購買）

【參考】

泰然網：http://www.tairan.com/archives/5515

完整程式碼: http://download.csdn.NET/detail/ldpjay/8949991


【封裝】

1. 結構介紹：

    結構和核心程式碼還是參照泰然網的那篇文章，我主要是在其基礎上封裝做了一些封裝和強化，更加方便使用。

    > IOSiAP：支付核心類，實現各種請求，直接呼叫API的介面。（在mm檔案中會實現一些API的回撥函式）

    > IOSiAPDelegate：代理類（抽象類），方法會在API返回結果時呼叫，在IOSiAP_Birdge中實現，以達到將結果傳遞出去的目的。 

    > IOSiAP_Bridge：起到橋樑作用的中間類，主要功能是呼叫IOAiAP中的各種請求介面，並且IOSiAPDelegate中的結果會返回到此類中（通過代理）。

    > GamePayment：單例類，純粹是為了方便使用，因為我把所有支付方式介面都統一到此類管理。（目前只有支付寶和IAP）


2. 支付流程：

    如果完全按照我使用的流程說，會比較糾結，因為封裝層數太多容易混淆，這裡拋開單例那一層，直接從IOSiAP_Birdge這層開始。以下是一次正常支付的流程，都是從IOSiAP_Bridge開始請求直到其收到返回結果為止。

    > 請求商品資訊：（主動）呼叫IOSiAP_Bridge的requestProducts方法，其會呼叫IOSiAP的requestProducts方法，呼叫API介面處理請求。

    > 返回商品資訊：返回在iAPProductsRequestDelegate（.mm檔案中）的對應回撥函式，如果成功，進入requestDidFinish，如果失敗進入didFailWithEror，在這裡會分別呼叫IOSiAP_Bridge的onRequestProductsFinsih或者onRequestProductsError函式，即通過代理將結果傳遞到IOSiAP_Birdge中。

    > 請求支付商品：（主動）呼叫IOSiAP_Birdge的requestPayment方法，其會呼叫IOSiAP的paymentWithProduct方法，呼叫API介面處理請求。

    > 返回支付結果：方式與商品資訊返回一樣，但是會返回在iAPTransactionObserver（.mm檔案中）中的updatedTransactions中，注意，這裡會接收各種支付請求相關的事件，包括後面要說的回覆購買的事件。此處直接通過代理將引數傳到IOSiAP_Bridge中的onPaymentEvent進行分析處理。

    到這裡，一次完整的請求支付並回撥就完成了，下面再說下回復購買的流程。

    > 請求恢復購買：（主動）呼叫IOSiAP_Birdge的requestRestore方法，其會呼叫IOSiAP的restorePayment方法，呼叫API介面處理請求。

    > 恢復購買結果：此時updateTransactions會受到已經購買的商品資訊（返回支付結果那裡），如果有多個就會返回多次，與支付結果一樣會呼叫IOSiAP_Birdge的onPaymentEvent處理。此時我們可以處理這些資訊，完成恢復操作。

    > 恢復購買完成：當上一步資訊全部都返回完畢，在paymentQueueRestoreCompletedTransactionsFinsished會收到返回結果，如果上一步沒有內購，即沒有上一步的返回，會直接在restoreComletedTransactionsFailedWithError中返回。這兩個返回都會傳到IOSiAP_Birdge的onRestoreFinished中處理。

    好了所有流程就這些了，看起來有點亂，不明白可以直接看程式碼，下面有完整版下載地址。

3. 核心程式碼：

這裡只貼出了最核心的部分，完整版見文章後面下載地址。

> IOSiAP

[cpp] view plain copy
  1. class IOSiAP  
  2. {  
  3. public:  
  4.     IOSiAP();  
  5.     ~IOSiAP();  
  6.     void requestProducts(std::vector <std::string> &productIdentifiers); // 請求商品  
  7.     IOSProduct *iOSProductByIdentifier(std::string &identifier);  
  8.     void paymentWithProduct(IOSProduct *iosProduct, int quantity = 1); // 請求支付  
  9.     void restorePayment(); // 恢復購買  
  10.       
  11.     IOSiAPDelegate *delegate;  
  12.     // ===  internal use for object-c class ===  
  13.     void *skProducts;// object-c SKProduct  
  14.     void *skTransactionObserver;// object-c TransactionObserver  
  15.     std::vector<IOSProduct *> iOSProducts;  
  16. };  
> IOSiAPDelegate

[cpp] view plain copy
  1. class IOSiAPDelegate  
  2. {  
  3. public:  
  4.     virtual ~IOSiAPDelegate() {}  
  5.     // for request product  
  6.     virtual void onRequestProductsFinish(void) = 0;  
  7.     virtual void onRequestProductsError(int code) = 0;  
  8.     // for payment event (also for restore event)  
  9.     virtual void onPaymentEvent(std::string &identifier, IOSiAPPaymentEvent event, int quantity) = 0;  
  10.     // for restore finished  
  11.     virtual void onRestoreFinished(bool succeed) = 0;  
  12. };  
>> iAPProductsRequestDelegate

[cpp] view plain copy
  1. @interface iAPProductsRequestDelegate : NSObject<SKProductsRequestDelegate>  
  2. @property (nonatomic, assign) IOSiAP *iosiap;  
  3. @end  
  4.   
  5. @implementation iAPProductsRequestDelegate  
  6.   
  7. - (void)productsRequest:(SKProductsRequest *)request  
  8.      didReceiveResponse:(SKProductsResponse *)response  
  9. {  
  10.      ......  
  11. }  
  12.   
  13. - (void)requestDidFinish:(SKRequest *)request  
  14. {  
  15.     _iosiap->delegate->onRequestProductsFinish();  
  16.     [request.delegate release];  
  17.     [request release];  
  18. }  
  19.   
  20. - (void)request:(SKRequest *)request didFailWithError:(NSError *)error  
  21. {  
  22.     _iosiap->delegate->onRequestProductsError([error code]);  
  23. }  
  24.   
  25. @end  
> iAPTransactionObserver

[cpp] view plain copy
  1. @interface iAPTransactionObserver : NSObject<SKPaymentTransactionObserver>  
  2. @property (nonatomic, assign) IOSiAP *iosiap;  
  3. @end  
  4.   
  5. @implementation iAPTransactionObserver  
  6.   
  7. - (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions  
  8. {  
  9.      ......  
  10.      _iosiap->delegate->onPaymentEvent(identifier, event, transaction.payment.quantity);  
  11. }  
  12.   
  13. - (void)paymentQueue:(SKPaymentQueue *)queue restoreCompletedTransactionsFailedWithError:(NSError *)error  
  14. {  
  15.     _iosiap->delegate->onRestoreFinished(false);  
  16. }  
  17.   
  18. - (void)paymentQueueRestoreCompletedTransactionsFinished:(SKPaymentQueue *)queue  
  19. {  
  20.     _iosiap->delegate->onRestoreFinished(true);  
  21. }  
  22.   
  23. @end  
> IOSiAP_Bridge

[cpp] view plain copy
  1. class IOSiAP_Bridge : public IOSiAPDelegate  
  2. {  
  3. public:  
  4.     // ［請求］獲取商品資訊  
  5.     void requestProducts(std::string &identifier, iapProductCallback callback);  
  6.      
  7.     // ［請求］付款請求  
  8.     void requestPayment(int quantity, iapPaymentCallback callback);  
  9.   
  10.     // ［請求］恢復購買  
  11.     void requestRestore(iapRestoreCallback restoreCallback, iapRestoreFinishCallback finishCallback);  
  12.   
  13. public:  
  14.     IOSiAP_Bridge();  
  15.     ~IOSiAP_Bridge();  
  16.       
  17.     // ［回撥］請求商品資訊回撥  
  18.     virtual void onRequestProductsFinish(void);  
  19.     virtual void onRequestProductsError(int code);  
  20.     // ［回撥］付款結果回撥（恢復流程也走這裡）  
  21.     virtual void onPaymentEvent(std::string &identifier, IOSiAPPaymentEvent event, int quantity);  
  22.     // ［回撥］恢復購買完成回撥  
  23.     void onRestoreFinished(bool succeed);  
  24.       
  25. private:  
  26.     IOSiAP             *iap;             // IOSiAp例項  
  27.       
  28.     std::string        _identifier;      // 商品編號（獲取請求）  
  29.     int                _quantity;        // 商品數量（購買請求）  
  30.     IOSProduct         *_product;        // 商品資訊（返回資訊）  
  31.       
  32.     iapProductCallback _productCallback; // 外部回撥（商品資訊）  
  33.     iapPaymentCallback _paymentCallback; // 外部回撥（購買結果）  
  34.     iapRestoreCallback _restoreCallback; // 外部回撥（恢復購買）；  
  35.     iapRestoreFinishCallback _restoreFinishCallback; // 外部回撥（恢復完成）  
  36. };  
> GamePayment

[cpp] view plain copy
  1. class GamePayment  
  2. {  
  3. public:  
  4.     static GamePayment *getInstance();  
  5.       
  6. protected:  
  7.     GamePayment();  
  8.       
  9.     // IAP內購（IOS）  
  10. #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)  
  11. public:  
  12.     // 請求商品資訊  
  13.     void req_iap(std::string &identifier, iapProductCallback callback);  
  14.       
  15.     // 購買請求  
  16.     void pay_iap(int quantity, iapPaymentCallback callback);  
  17.       
  18.     // 恢復購買  
  19.     void restore_iap(iapRestoreCallback restoreCallback, iapRestoreFinishCallback finishCallback);  
  20.       
  21. private:  
  22.     IOSiAP_Bridge _iap;  
  23. #endif  

  1. }  

相關文章