【说明】
游戏开发中,集成支付是一个重要的环节,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
- class IOSiAP
- {
- public:
- IOSiAP();
- ~IOSiAP();
- void requestProducts(std::vector <std::string> &productIdentifiers);
- IOSProduct *iOSProductByIdentifier(std::string &identifier);
- void paymentWithProduct(IOSProduct *iosProduct, int quantity = 1);
- void restorePayment();
-
- IOSiAPDelegate *delegate;
-
- void *skProducts;
- void *skTransactionObserver;
- std::vector<IOSProduct *> iOSProducts;
- };
> IOSiAPDelegate
- class IOSiAPDelegate
- {
- public:
- virtual ~IOSiAPDelegate() {}
-
- virtual void onRequestProductsFinish(void) = 0;
- virtual void onRequestProductsError(int code) = 0;
-
- virtual void onPaymentEvent(std::string &identifier, IOSiAPPaymentEvent event, int quantity) = 0;
-
- virtual void onRestoreFinished(bool succeed) = 0;
- };
>> iAPProductsRequestDelegate
- @interface iAPProductsRequestDelegate : NSObject<SKProductsRequestDelegate>
- @property (nonatomic, assign) IOSiAP *iosiap;
- @end
-
- @implementation iAPProductsRequestDelegate
-
- - (void)productsRequest:(SKProductsRequest *)request
- didReceiveResponse:(SKProductsResponse *)response
- {
- ......
- }
-
- - (void)requestDidFinish:(SKRequest *)request
- {
- _iosiap->delegate->onRequestProductsFinish();
- [request.delegate release];
- [request release];
- }
-
- - (void)request:(SKRequest *)request didFailWithError:(NSError *)error
- {
- _iosiap->delegate->onRequestProductsError([error code]);
- }
-
- @end
> iAPTransactionObserver
- @interface iAPTransactionObserver : NSObject<SKPaymentTransactionObserver>
- @property (nonatomic, assign) IOSiAP *iosiap;
- @end
-
- @implementation iAPTransactionObserver
-
- - (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions
- {
- ......
- _iosiap->delegate->onPaymentEvent(identifier, event, transaction.payment.quantity);
- }
-
- - (void)paymentQueue:(SKPaymentQueue *)queue restoreCompletedTransactionsFailedWithError:(NSError *)error
- {
- _iosiap->delegate->onRestoreFinished(false);
- }
-
- - (void)paymentQueueRestoreCompletedTransactionsFinished:(SKPaymentQueue *)queue
- {
- _iosiap->delegate->onRestoreFinished(true);
- }
-
- @end
> IOSiAP_Bridge
- class IOSiAP_Bridge : public IOSiAPDelegate
- {
- public:
-
- void requestProducts(std::string &identifier, iapProductCallback callback);
-
-
- void requestPayment(int quantity, iapPaymentCallback callback);
-
-
- void requestRestore(iapRestoreCallback restoreCallback, iapRestoreFinishCallback finishCallback);
-
- public:
- IOSiAP_Bridge();
- ~IOSiAP_Bridge();
-
-
- virtual void onRequestProductsFinish(void);
- virtual void onRequestProductsError(int code);
-
- virtual void onPaymentEvent(std::string &identifier, IOSiAPPaymentEvent event, int quantity);
-
- void onRestoreFinished(bool succeed);
-
- private:
- IOSiAP *iap;
-
- std::string _identifier;
- int _quantity;
- IOSProduct *_product;
-
- iapProductCallback _productCallback;
- iapPaymentCallback _paymentCallback;
- iapRestoreCallback _restoreCallback;
- iapRestoreFinishCallback _restoreFinishCallback;
- };
> GamePayment
- class GamePayment
- {
- public:
- static GamePayment *getInstance();
-
- protected:
- GamePayment();
-
-
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
- public:
-
- void req_iap(std::string &identifier, iapProductCallback callback);
-
-
- void pay_iap(int quantity, iapPaymentCallback callback);
-
-
- void restore_iap(iapRestoreCallback restoreCallback, iapRestoreFinishCallback finishCallback);
-
- private:
- IOSiAP_Bridge _iap;
- #endif
- }