【支付】Cocos2d-x IOS内购（IAP支付）

【说明】

游戏开发中，集成支付是一个重要的环节，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. }