構造体


Product.PurchaseOption


製品購入時のオプション設定。


iOS 15.0+ iPadOS 15.0+ macOS 12.0+

tvOS 15.0+ visionOS 1.0+ watchOS 8.0+

struct PurchaseOption




概観


purchase(options:) メソッドまたは Product/purchase(confirmIn:options:) メソッドを呼び出すときに、購入オプションをアプリ内購入に関連付けます。StoreKit Test またはサンドボックステスト環境で、テスト固有のオプションを使用します。


購入オプションを使用すると、アプリアカウントの徴し、プロモーションの提供、数量など、購入に関する追加情報を提供したり、ストアフロントが変更された場合の取引の動作を指定したりできます。


注意

購入オプションが無効な場合、購入は失敗し、購入メソッドで StoreKitError または Produce.PurchaseError が throw される可能性があります。

テスト中に購入オプションを使用


サンドボックステスト環境では、simulatesAskToBuyInSandbox(_:) を使用して Ask To Buy シナリオをテストします。


StoreKit Test を使用した Xcode テスト環境では、buyProduct(identifier:options:) を呼び出すときに、以下のテスト固有の購入オプションを使用します。


  • codeOffer(referenceName:)propractionalOffer(id:) を使用して、顧客による提供の換金をシミュレートします。

  • purchaseDate(_:renewalBehavior:) を使用して、取引日とサブスクリプション更新の動作を制御します。




  • トピックス


    購入オプションの設定


    static func appAccountToken(UUID) -> Product.PurchaseOption

    購入をあなたのシステム内のアカウントに関連付けるための UUID を設定します。


    static func winBackOffer(Product.SubscriptionOffer) -> Product.PurchaseOption

    購入に適用する再獲得提供を設定します。


    static func promotionalOffer(offerID: String, keyID: String, nonce: UUID, signature: Data, timestamp: Int) -> Product.PurchaseOption

    自動更新サブスクリプションに販売促進提供を適用します。


    static func promotionalOffer(offerID: String, signature: Product.SubscriptionOffer.Signature) -> Product.PurchaseOption


    static func quantity(Int) -> Product.PurchaseOption

    顧客が購入するアイテムの数量を示します。



    インスタンスプロパティ


    let appAccountToken: UUID?

    取引をあなた独自のサービス上のユーザに関連付ける UUID。



    店頭の変更に対する動作の指定


    static func onStorefrontChange(shouldContinuePurchase: (Storefront) -> Bool) -> Product.PurchaseOption

    取引中にデバイス上の App Store の店頭が変更された場合に、取引を続行する必要があるかどうかを示します。



    Xcode で StoreKit テストのオプションを設定


    static func purchaseDate(Date, renewalBehavior: Product.PurchaseOption.SubscriptionRenewalBehavior) -> Product.PurchaseOption

    テスト環境での取引の購入日を設定し、自動更新サブスクリプションの更新動作を示します。


    enum SubscriptionRenewalBehavior

    テスト環境であなたが購入した自動更新サブスクリプションの更新オプション。


    static func codeOffer(referenceName: String) -> Product.PurchaseOption

    テスト環境での取引の提供コードを設定します。


    static func promotionalOffer(id: String) -> Product.PurchaseOption

    テスト環境での取引のプロモーション提供を設定します。



    サンドボックステストのオプションの設定


    static func simulatesAskToBuyInSandbox(Bool) -> Product.PurchaseOption

    サンドボックス環境であなたのアプリをテストするときに、Ask to Buy のシナリオをシミュレートします。



    カスタム購入オプションの設定


    static func custom(key: String, value: Data) -> Product.PurchaseOption

    購入にカスタムキーのデータを追加します。


    static func custom(key: String, value: String) -> Product.PurchaseOption

    購入にカスタムキーの文字列を追加します。


    static func custom(key: String, value: Bool) -> Product.PurchaseOption

    購入にカスタムキーのブール値を追加します。


    static func custom(key: String, value: Double) -> Product.PurchaseOption

    購入時にカスタムキーの数字を追加します。





    関連


    以下に準拠


    Copyable

    CustomDebugStringConvertible

    Equatable

    Hashable

    Sendable





    以下も見よ


    製品の購入


    func purchase(options: Set<Product.PurchaseOption>) async throws -> Product.PurchaseResult

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


    enum PurchaseResult

    購入の結果。


    enum PurchaseError

    商品購入エラーに関するエラー情報。















    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ