【说明】
游戏开发中,集成支付是一个重要的环节,AppStore审核指南规定,App内虚拟物品必须使用IAP支付。这篇文章主要记录我在集成IAP的过程,我参考了泰然网的一篇文章,对其进行了封装和扩展,并对结构和使用流程进行了简单的介绍,仅供自己学习使用。
关于iTunes Connect上的商品配置,可以参考泰然网的文章,这里只对代码进行讨论。
更新:加入内购恢复接口,一键恢复购买过的非消耗型商品。(苹果规定费消耗型商品必须要有恢复购买)
【参考】
泰然网:http://www.tairan.com/archives/5515
【封装】
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; // === internal use for object-c class === void *skProducts;// object-c SKProduct void *skTransactionObserver;// object-c TransactionObserver std::vector<IOSProduct *> iOSProducts; };> IOSiAPDelegate
class IOSiAPDelegate { public: virtual ~IOSiAPDelegate() {} // for request product virtual void onRequestProductsFinish(void) = 0; virtual void onRequestProductsError(int code) = 0; // for payment event (also for restore event) virtual void onPaymentEvent(std::string &identifier, IOSiAPPaymentEvent event, int quantity) = 0; // for restore finished 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; // IOSiAp实例 std::string _identifier; // 商品编号(获取请求) int _quantity; // 商品数量(购买请求) IOSProduct *_product; // 商品信息(返回信息) iapProductCallback _productCallback; // 外部回调(商品信息) iapPaymentCallback _paymentCallback; // 外部回调(购买结果) iapRestoreCallback _restoreCallback; // 外部回调(恢复购买); iapRestoreFinishCallback _restoreFinishCallback; // 外部回调(恢复完成) };> GamePayment
class GamePayment { public: static GamePayment *getInstance(); protected: GamePayment(); // IAP内购(IOS) #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 }
【附录】
完整代码:http://download.csdn.net/detail/ldpjay/8949991