「要把大象裝冰箱,總共分三步。」
這篇不是完整的 In-App Purchase 教程,而是把核心的程式步驟抽離出來,用一個清晰簡潔的視角幫助你理解內購買的整體流程。
前置作業是在 iTunes Connect 中建立商品並取得 Product ID,這部分不在本文範圍。以下假設商品已經建立完成。
你可能會想「我知道自己的商品資訊啊」,但這一步不能跳過——後續的支付請求需要一個 SKProduct 物件,而它只能由系統回傳。
if ([SKPaymentQueue canMakePayments]) {
SKProductsRequest *request =
[[SKProductsRequest alloc] initWithProductIdentifiers:
[NSSet setWithObject:productID]]; // productID 是 NSString
request.delegate = self;
[request start];
}
這段程式建立並送出一個商品查詢請求。蘋果伺服器回傳結果時,會觸發委派方法:
#pragma mark - SKProductsRequestDelegate
- (void)productsRequest:(SKProductsRequest *)request
didReceiveResponse:(SKProductsResponse *)response {
NSArray *products = response.products;
if (products.count != 0) {
_product = products[0]; // _product 是 SKProduct 型別
} else {
NSLog(@"Product not found");
}
for (SKProduct *invalidId in response.invalidProductIdentifiers) {
NSLog(@"Product not found: %@", invalidId);
}
}
這裡有個實務上很常被忽略的細節:invalidProductIdentifiers。如果商品 ID 打錯、商品尚未在 iTunes Connect 中進入「Ready to Submit」狀態、或 Paid Applications Agreement 尚未簽妥,商品就會出現在這個清單裡而不是 products。除錯時優先看這個陣列,能省下大量時間。
首先要為交易佇列註冊一個觀察者:
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
接著建立交易並加入佇列:
SKPayment *payment = [SKPayment paymentWithProduct:_product]; [[SKPaymentQueue defaultQueue] addPayment:payment];
注意觀察者應該在 App 啟動時就註冊,而不是等到使用者按下購買鈕才加。原因是:使用者可能中途離開 App,交易在你沒有觀察者的期間完成;也可能是 previous 交易尚未 finish,需要靠觀察者來補處理。
蘋果伺服器處理完請求後,會把結果回傳並呼叫這個方法:
#pragma mark - SKPaymentTransactionObserver
- (void)paymentQueue:(SKPaymentQueue *)queue
updatedTransactions:(NSArray *)transactions {
for (SKPaymentTransaction *transaction in transactions) {
switch (transaction.transactionState) {
case SKPaymentTransactionStatePurchased:
// 購買成功:在這裡寫入後續程式碼
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
break;
case SKPaymentTransactionStateFailed:
// 購買失敗:在這裡寫入後續程式碼
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
break;
case SKPaymentTransactionStateRestored:
// 恢復購買:在這裡寫入程式碼
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
break;
default:
break;
}
}
}
基本流程到此結束,但要真正上線,至少還得處理下面幾件事:
1. 一定要呼叫 finishTransaction。不呼叫的話,該交易會一直留在佇列中,每次啟動 App 都會重複觸發 Purchased。這是最常見的內購買 Bug 來源。
2. 憑證驗證不能只在前端做。應該把 receipt 送到自己的伺服器,再由伺服器向蘋果驗證。前端的判斷可以被越獄工具偽造,只有伺服器端驗證才是可靠的。
3. 購買結果要持久化。使用者付了錢,你的 App 必須確保下次啟動時功能仍然解鎖。這通常意味著把購買狀態寫進自己的伺服器與本地快取。
4. 必須實作「恢復購買」。使用者換新手機、重裝 App 之後,需要一個入口讓他們不花錢取回已購買的內容。這不但是使用者體驗問題,也是審核的重點項目。
5. 留意 transactionState 的其他值。Purchasing 表示正在向使用者確認,Deferred 表示需要家長同意(例如兒童帳戶),這兩種狀態都不該急著 finish。
理解基本步驟之後,就如同蓋房子打好了地基。後續可能還會遇到各種問題,但都能循序漸進地解決。細節部分建議直接查閱蘋果官方的 Store Kit 文件。