インスタンスメソッド


purchase(options:)


App Store で製品の購入を開始し、確認シートを表示します。


iOS 15.0+ iPadOS 15.0+ macOS 12.0+

tvOS 15.0+ watchOS 8.0+

@MainActor
func purchase(options: Set<Product.PurchaseOption = []) async throws -> Product.PurchaseResult



パラメータ


options

購入に関連させることができるオプションのセット。



戻り値


Product.PurchaseResult を返します。



以下で言及


  あなたのアプリ内で促進されたアプリ内購入をサポート
(Supporting promoted In-App Purchases in your app)


  あなたのアプリ内での売買による再獲得の提供
( Merchandising win-back offers in your app)


  あなたのアプリ内での再獲得提供のサポート
(Supporting win-back offers in your app)



議論


StoreKit には、顧客が購入を開始できるようにするために使用できる API がいくつか提供されています。purchase(options:) を使用する前に、以下の API を検討し、あなたのアプリの実装に最適なものを選択してください。


  • visionOS のマルチシーンアプリなど、SwiftUI を使用するアプリには PurchaseAction を使用します。

  • UIKit を使用するアプリには Product/purchase(confirmIn:options:) を使用します。

  • あなたのアプリが watchOS または macOS で実行される場合は purchase(options:) を使用します。

    • 重要

    ProductView、StoreView、SubscriptionStoreView などの StoreKit ビューを使用する場合は、購入を開始するために他の API を呼び出す必要はありません。StoreKit は、購入確認 UI の表示など、購入アクションを自動的に管理します。詳細については、StoreKit ビュー (StoreKit views) を参照してください。

    購入 API の使用


    顧客があなたのアプリ内または App Store で促進されたアプリ内購入を選択した後に購入を開始するときに、purchase(options:) メソッドを呼び出します。このメソッドはシステム確認シートを表示します。ユーザはト取引を完了するかキャンセルするかを確認できます。


    購入に関する追加情報を提供するには、以下のような購入オプションを含めます。


  • appAccountToken(_:) は、購入と結果としての取引を関連付けます

  • promotionalOffer(offerID:keyID:nonce:signature:timestamp:)、顧客が自動更新サブスクリプションのプロモーション提供を換金する場合

  • quantity(_:)、顧客が製品を複数購入する場合

    • 以下の例は、options パラメータを使用して purchase(options:) を呼び出し、アプリアカウントの token (徴し) を提供する方法を示しています。


    1. let appAccountToken = <# Generate an app account token. #>
    2. let purchaseResult = try await product.purchase(options: [
    3. .appAccountToken(appAccountToken)
    4. ])

    サンドボックス環境内であなたのアプリをテストしている場合は、simulatesAskToBuyInSandbox(_:) 購入オプションを true に設定して、Ask to Buy (買って下さい) シナリオをテストします。Ask to Buy の詳細については、Ask to Buy を使用して子供が購入するものを承認する(Approve what kids buy with Ask to Buy) を参照してください。


    このメソッドは、Produce.PurchaseError または StoreKitError を throw する場合があります。


    ユーザが App Store で開始する購入の詳細については、アプリ内購入の促進 (Promoting In-App Purchases) を参照してください。




    以下も見よ


    購入要求と結果


    struct PurchaseAction

    アプリ内購入を開始するアクション。


    enum PurchaseResult

    購入の結果。














    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ