実例でみるiPhoneアプリ内課金(In App Purchase) アプリへの組み込み

はじめに

あまのです。

「iTunes Connectへの登録」から一ヶ月が経ってしまいましたが、今回はアプリへの組み込みについて書きたいと思います。
最近、Wall Calendar LiteというGoogle Calendarのスケジュールを壁紙にするアプリにも組み込みましたので前回のブログを見直すこともできました。

App Storeへのアクセスの流れ

アプリ内課金はStore KitというAPIを利用して、App Storeとやり取りを行います。
具体的にGood Choiceの「機能制限を解除」ボタンが押された時のコードを元に説明します。

流れとしては次のようになっています。

1. 「機能制限を解除」ボタンを用意
2. アプリ内課金が許可されているかを確認
3. プロダクトの取得処理を開始
4. プロダクト情報をApp Storeから取得
5. プロダクト購入処理を開始
6. プロダクト購入処理結果の取得
7. 購入完了

コードを書く前に

プロダクトIDを確認

アプリ内課金を行う前に、前回設定したプロダクトIDを確認します。
Good Choiceではわかりやすいように、{Bundle identifier}.{プロダクト名}みたいな形にしています。具体的には jp.kray.goodchoice.unlock というような感じになります。

Store Kit Frameworkをリンク

Store Kit Frameworkをアプリに組み込みます。

1. 「機能制限を解除」ボタンを用意

押されると、upgradePlusメソッドが呼ばれます。

[upgradeButton addTarget:self action:@selector(upgradePlus) forControlEvents:UIControlEventTouchUpInside];

2. アプリ内課金が許可されているかを確認

次はアプリ内課金が許可されているかを判別するコードになります。
これはiPhoneの「設定」→「一般」→「機能制限」で「App内での購入」がオンになっているかを確認します。

// アプリ内課金が許可されているかを確認
if ([SKPaymentQueue canMakePayments] == NO) {
// ... アラートを表示 ...
return;
}

3. プロダクトの取得処理を開始

App Storeからプロダクト情報の取得を開始します。

[[SKPaymentQueue defaultQueue] addTransactionObserver:self];

NSSet *productIds = [NSSet setWithObject:PRODUCT_ID];
skProductRequest = [[SKProductsRequest alloc] initWithProductIdentifiers:productIds];
skProductRequest.delegate = self;
[skProductRequest start];

4-5. プロダクト情報の取得と購入処理を開始

「プロダクト情報をApp Storeから取得」と「プロダクト購入処理の開始」はSKProductsRequestDelegateの次のメソッド内で行います。

- (void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response {
if (response == nil) {
NSLog(@"Product Response is nil");
return;
}

// 確認できなかったidentifierをログに記録
for (NSString *identifier in response.invalidProductIdentifiers) {
NSLog(@"invalid product identifier: %@", identifier);
}

for (SKProduct *product in response.products ) {
NSLog(@"valid product identifier: %@", product.productIdentifier);
SKPayment *payment = [SKPayment paymentWithProduct:product];
[[SKPaymentQueue defaultQueue] addPayment:payment];
}
}

6. プロダクト購入処理結果の取得

購入処理の結果はオブザーバのSKPaymentTransactionObserverを利用して受け取ります。
気をつけたい点として、購入処理途中の結果も送られてくるため、何度もSKPaymentTransactionStatePurchasingが送られてきます。

- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions {
BOOL purchasing = YES;
for (SKPaymentTransaction *transaction in transactions) {
switch (transaction.transactionState) {
// 購入中
case SKPaymentTransactionStatePurchasing: {
NSLog(@"Payment Transaction Purchasing");
break;
}
// 購入成功
case SKPaymentTransactionStatePurchased: {
NSLog(@"Payment Transaction END Purchased: %@", transaction.transactionIdentifier);
purchasing = NO;
[self completeUpgradePlus];
[queue finishTransaction:transaction];
break;
}
// 購入失敗
case SKPaymentTransactionStateFailed: {
NSLog(@"Payment Transaction END Failed: %@ %@", transaction.transactionIdentifier, transaction.error);
purchasing = NO;
// ... アラートを表示 ...
[queue finishTransaction:transaction];
break;
}
// 購入履歴復元
case SKPaymentTransactionStateRestored: {
NSLog(@"Payment Transaction END Restored: %@", transaction.transactionIdentifier);
// 本来ここに到達しない
purchasing = NO;
[queue finishTransaction:transaction];
break;
}
}
}

if (purchasing == NO) {
[(UIView *)[self.view.window viewWithTag:21] removeFromSuperview];
[UIApplication sharedApplication].networkActivityIndicatorVisible = NO;
}
}

7. 購入完了

購入完了後の処理は、もちろんアプリ毎に違いますが流れとして書いておきます。

// 課金が行われた後、呼び出す
- (void)completeUpgradePlus {
// アップグレード済みとする
[[ZConfig instance] setPlus:YES];
[self.tableView reloadData];
}

サンドボックスでのテスト

前回作成した決済用テストユーザを使ってテストします。
画面のように [Environment: Sandbox] というサンドボックスであることがわかるようになっています。
この時に入力するユーザ名は、決済用テストユーザとパスワードを使うようにします。

有料版と無料版について

「有料版と無料版が両方あって、無料版にアプリ内課金を組み込む意味はあるの？」という突っ込みが知り合いからありました。

元々、弊社で作っているアプリはアプリ内課金が無かった頃に作ったもので、アプリ内課金は最近組み込んだため、両方存在してしまっています。

例えば、Good Choiceはアプリ内課金込みの無料版と230円の有料版であるPlusが存在します。
Wall Calendarは、115円のアプリと無料版のLiteが存在します。

両方に組み込んで思ったことですが、実際メンテナンスや開発はかなり面倒です。わかりにくさを補うための説明も余分に必要になる感じです。

確かに有料版とアプリ内課金の無料版があれば、販売機会が増えるため、売上は上がるかもしれません。ただメンテナンスコスト、両方存在するわかりにくさを考えると片方のみでいいのではと思いました。

正直、アプリ内課金はデバッグが大変です。
いろいろ共有して開発やデバッグが少しでも楽になればいいですね！

最後に

この後に、今回の一連のソースをそのまま載せておきます。
そのまま組み込みやすいようにしてありますので、参考にしてみてください。