IOS 内购开发:In-App Purchase

前述:最近刚刚和后台的同事完成了IOS的内购项目功能开发,用以替换之前的支付宝、微信支付功能。这里,梳理出大体的步骤,已经其中踩过的坑。我只梳理了什么事IAP、为什么要用IAP、IAP功能的架构设计、IAP的具体实现代码以及IAP的一些问题

一》 In-App Purchase的相关知识
这里我就不罗列大量的理论了,只谈谈我自己的认识。首先,In-App Purchase功能是用来在IOS生态内,购买App相关产品的功能。每一笔交易,它都会从中提取30%的手续费,也就是说别人为你内购项目支付1元,它要收取0.3元钱。其实,将App Store理解为一个百货商场,那么各家App就是一个个品牌的柜台,而我们的In-App Purchase Products就是柜台里的商品了。这也就解释了,为什么每一笔交易App Store会收取30%的资金:商场提供给你场地、支付渠道,那最终他肯定会有“手续费”要收。个人猜测,最近闹的沸沸扬扬的微信“打赏”功能,估计也与此有关吧,那么庞大的流动资金,无限制的抽取30%,谁也受不了啊。
In-App Purchase功能的开发,既费神也要蒙受收入损失,那么所有涉及支付功能的都需要它么?不尽然。我只说,完全不能绕开它的情况:那就是你的产品是虚拟的,并购买该产品是在使用你的App的一定情境下的必然环节,或者说购买的产品是App环境内使用的,那么你就必须使用In-App Purchase功能。举个例子:我的App里有一篇付费文章,那么我就必须花钱才能在App内看这篇文章,那么这个商品就是必须使用In-App Purchase功能来支付的。那么反过来说,比如“百度外卖”、“膜拜单车”等一系列产品,为什么可以使用非In-App Purchase功能来付费、充值呢?因为外卖也好、自行车也好、金融理财类产品也好,他们或实体商品、或购买的商品,所使用的情景等是在App环境外的,所产生的资金不在平台内,那么这时也就可以使用支付宝、微信、银行卡等第三方API直接开发支付功能了。
更为官方性的内容可以在这里查看:https://developer.apple.com/in-app-purchase/

二》 In-App Purchase开发的准备工作
这里我只说明全过程,重点在架构的设计和开发部分,政策性的过程可以参考以下文章:
http://www.jianshu.com/p/86ac7d3b593a
简要来说答题步骤如下:
第一步:创建一个APP ID,注意需要勾选In-App Purchase功能。
第二步:在iTunes Connect的“我的App”里,创建一个App,所使用的APP ID就是刚刚创建的APP ID。
第二步:完善开发者账号的协议、税务和银行业务相关资料。这里网上有很多资料,不再赘述,唯一提醒:把所有资料都要填写,包括联系方式等等。只为什么,后边会说。
第三步:在iTunes Connect的“我的App”里,创建几项App的内购项目,注意地区选择:中国。
第四步:在刚刚创建的App中,内购项目中添加刚刚创建的几项购买项目。
--------------至此,开发前的准备工作就差不多了------------

三》 In-App Purchase功能的架构设计
首先看看Xcode给出的一个开发过程的流程图:

屏幕快照 2017-04-28 20.49.58.png

下来,看看Xcode里给出的功能框架图:

屏幕快照 2017-04-28 20.49.50.png

大体的过程就是:从我们的Service获取到商品ID ——> 用商品ID向苹果市场请求产品相关信息 ——> 用获取到的商品信息购买商品——>购买成功后获取购买凭证——>讲凭证发回Service验证——>购买成功
总体来说,可归结为下图的详细流程:


屏幕快照 2017-05-03 20.01.46.png

*** 如上图所示,已经是一个相当完善的IAP支付流程图了。只是在这里我希望做一点补充:在第9步至14步返回结果的中间,应该先讲App Store返回给客户端的支付凭证做本地保存,然后待14步完成服务端的校验后,再将本地保存的改凭证删除。这样做的好处是,10~13步中间任何校验的环节出现问题,可以重新发送未校验的凭证,这样可更大化的保证用户资金凭证的安全,避免出现误差。至于保存的方式,可以使用单例、本地化持久等等。我的方式是本地单例存储了一个设计的队列,验证成功一条,队列出一条。至于二次校验触发的环节,因人而异,自行设计。如下图:


屏幕快照 2017-05-04 14.37.29.png

另注:就像集成AVPlayer一样,我还是倾向于功能模块化,封装起来,做成单独的功能类。这样做的益处非常大,利于日后的维护、扩展等等。加上相应的注解,日后也好维护,自己看着整齐的代码也很舒服啊。我的主要功能如下:

@protocol IAPManagerDelegate <NSObject>

-(void)IAPFailedWithWrongInfor:(NSString *)informationStr;

-(void)IAPPaySuccessFunctionWithBase64:(NSString *)base64Str;

@end

@interface IAPManager : NSObject

@property(nonatomic ,weak) id<IAPManagerDelegate> IAPDelegate;

+(instancetype)sharedManager;

/**
 *  @brief     检查本地是否具有未成功校验的IAP订单
 *
 *  @parameter 无
 *
 *  @returning 无
 */
+(void)checkTheIAPStatusFunction;

/**
 *  @brief     添加IAP观察者
 *
 *  @parameter 无
 *
 *  @returning 无
 */
-(void)addTheIAPObserver;

/**
 *  @brief     删除IAP观察者
 *
 *  @parameter 无
 *
 *  @returning 无
 */
-(void)removeTheIAPOberver;

/**
 *  @brief     从appleStore获取商品信息
 *
 *  @parameter productIdentifier  商品编号(服务器获取)
 *
 *  @returning 无
 */
- (void)getProductInfo:(NSString *)productIdentifier;

四》代码实现
首先,我们需要在类里引入<StoreKit/StoreKit.h>,并且执行该类的代理

#import <StoreKit/StoreKit.h>
@interface IAPManager()<SKProductsRequestDelegate, SKPaymentTransactionObserver>

然后集成的步骤就像上边我们梳理的那样,首先我们要根据商品ID向App Store发送请求,用来验证商品是否存在已经它的详细信息

/*
 从Apple查询用户点击购买的产品的信息
 获取到信息以后,根据获取的商品详细信息
 */
- (void)getProductInfo:(NSString *)productIdentifier
{
    if (![SKPaymentQueue canMakePayments])
    {
        if (_IAPDelegate && [_IAPDelegate respondsToSelector:@selector(IAPFailedWithWrongInfor:)])
        {
            [_IAPDelegate IAPFailedWithWrongInfor:@"不允许程序内付费购买"];
        }
        return;
    }
    
    if (productIdentifier.length > 0)
    {
        NSArray * product = [[NSArray alloc] initWithObjects:productIdentifier, nil];
        NSSet *set = [NSSet setWithArray:product];
        SKProductsRequest * request = [[SKProductsRequest alloc] initWithProductIdentifiers:set];
        request.delegate = self;
        [request start];
    }
    else
    {
        if (_IAPDelegate && [_IAPDelegate respondsToSelector:@selector(IAPFailedWithWrongInfor:)])
        {
            [_IAPDelegate IAPFailedWithWrongInfor:@"商品ID为空"];
        }
    }
}

返回结果会呈现在StoreKit代理的函数里

/*
 查询成功后的回调
 经由getProductInfo函数发起的产品信息查询,成功后返回执行的回调。再更具回调内容发起购买请求
 */
- (void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response
{
    NSArray *myProduct = response.products;
    if (myProduct.count == 0)
    {
        if (_IAPDelegate && [_IAPDelegate respondsToSelector:@selector(IAPFailedWithWrongInfor:)])
        {
            [_IAPDelegate IAPFailedWithWrongInfor:@"无法获取商品信息"];
        }
        return;
    }
    
    //发起购买操作,下边的代码

}

获取到了商品的详细信息,就可以根据该详细信息发起对商品的购买请求了

SKPayment * payment = [SKPayment paymentWithProduct:myProduct[0]];
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
[[SKPaymentQueue defaultQueue] addPayment:payment];

同样的,查询不存在或网络通信失败等一系列查询失败的函数执行如下代理

/*
 查询失败后的回调
 */
- (void)request:(SKRequest *)request didFailWithError:(NSError *)error
{
    if (_IAPDelegate && [_IAPDelegate respondsToSelector:@selector(IAPFailedWithWrongInfor:)])
    {
        [_IAPDelegate IAPFailedWithWrongInfor:@"购买失败"];
    }
    NSLog(@"打印错误信息:%@",[error localizedDescription]);
}

发起购买请求,就会开始客户端与App Store之间的往来通信,此时在测试阶段需要使用沙箱测试账号来测试!
购买的结果,Ios会统一在下边的函数中反馈,状态通过枚举获得:

- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions {
    for (SKPaymentTransaction *transaction in transactions)
    {
        switch (transaction.transactionState)
        {
            //交易完成
            case SKPaymentTransactionStatePurchased:
           //发送购买凭证到服务器验证是否有效
                break;
                
            //交易失败
            case SKPaymentTransactionStateFailed:
                [self failedTransaction:transaction];
                break;
                
            //已经购买过该商品
            case SKPaymentTransactionStateRestored:

                break;
                
            //商品添加进列表
            case SKPaymentTransactionStatePurchasing:

                break;
                
            default:
                break;
        }
    }
    
}

接下来就是最终交易凭证的验证了,我们的步骤是:获取凭证——>保存——>校验——>删除

//交易成功,与服务器比对传输货单号
- (void)completeTransaction:(SKPaymentTransaction *)transaction
{
    //目前苹果公司提倡的获取购买凭证的方法
    NSURL *receiptUrl = [[NSBundle mainBundle] appStoreReceiptURL];
    NSData *receiptData = [NSData dataWithContentsOfURL:receiptUrl];
    //base64位的产品验证码单,base64是服务端和苹果进行校验所必须的,苹果的文档要求凭证经过Base64加密
    NSString * transactionReceiptString = [receiptData base64EncodedStringWithOptions:0];
    //将加密后的transactionReceiptString发送给后台服务端进行校验,在此之前,记得先保存购买凭证
    //完整结束此次在App Store的交易,没有这句代码的调用,下次购买会提示已经购买该商品
    [[SKPaymentQueue defaultQueue] finishTransaction: transaction];
}

接下来的服务端与客户端的校验,就是我们本地的事情了。苹果的功能集成大致如此了。

五》所遇见的问题以及解决办法
1.沙箱测试账号无法登陆App Store的问题
解决方案:
a.手机操作系统不可以是越狱版本的
b.手机退出原有账号以后,在测试的过程中直至点击IAP内购按钮以后,等它自己弹出提示框登陆
c.删除测试App,重启手机后重新安装,发起购买请求,填写沙箱账号登陆
d.沙箱账号在创建时的购买区域选中国
e.银行税务账户信息未填写完全
f.沙箱账号是在税务信息填写完整前创建的,无法登陆链接。在完善税务信息后重新创建一个沙箱账号登陆(这一条,很诡异,但是我创建的10个账号,确实是信息完善前的两个没用,其他都可以)。
g.沙箱账号和真实账号冲突

2.调用- (void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response时查不到商品信息,或者说产品标识符在invalidProductIdentifiers数组中被退返
解决方案:
a.App的App ID和内购项目的App的App ID不对应,请检查
b.App ID没有开启IAP功能。登陆IOS开发者后台,找到改App ID,重新edit,选择上IAP功能后保存
c.在iTunes Connect中,苹果拒绝了你最新向iTunes Connect提交的二进制码。
d.你没有清除iTunes Connect中在售的IAP产品。
e.可能修改了商品,但是这些修改没有在所有App Store的服务器中生效。有时候会有延时,等等再说
f.你的商品由苹果托管上,内容尚未上传至iTunes Connect上。
g.商品的标识符不对。检查传给苹果的标识符和创建的是否完全一致。
h.没有向即将提交的新版本的内购项目中添加已经创建的内购项目。
i.没有填完税务信息。这一条重点说明下,税务信息中,所有的信息都要填写,包括联系方式等等。只要你的信息有一点不完善,IAP的功能就无法测试,你也获取不到商品的信息。

以上就是这次开发的心得了,还是欢迎一起讨论,共同进步涨姿势哈~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容