@capgo/native-purchases

概要

@capgo/native-purchases をラップします StoreKit 2 と Google Play Billing 単一の Capacitor API で、サブスクリプション、消耗品、復元フローを管理できます。ストアから製品メタデータを読み込み、アプリ内購入を行い、個別のネイティブブリッジを維持することなく権限を更新できます。

サードパーティのサブスクリプション SDK を使わずに、ファーストパーティの課金を利用したい場合にこのプラグインを選択してください。

プラットフォーム対応

プラットフォーム	課金スタック
iOS	StoreKit 2
Android	Google Play Billing 7以降

主要機能

• StoreKit 2とGoogle Play Billingを使用した、ネイティブなアプリ内課金とサブスクリプションの実装。
• ローカライズされたタイトルや価格を含む、ストアから直接取得する商品メタデータ。
• 12ヶ月の継続を条件とする月額サブスクリプションのiOS StoreKit価格体系。
• 購入、復元、権限のリフレッシュ、およびネイティブなサブスクリプション管理フロー。
• 旧ビジネスモデルからの移行を支援するApp Transactionヘルパー。

公開 API

メソッド	説明
restorePurchases	ユーザーの以前の情報を復元し、それらを使用している他のユーザーのappUserIDsと紐付けます。
getAppTransaction	App Transaction情報を取得します。これには、ユーザーが最初にアプリをダウンロードまたは購入した際の詳細が含まれます。
isEntitledToOldBusinessModel	App Transactionから取得した元のアプリバージョンとターゲットバージョンを比較し、ユーザーが以前のビジネスモデルの機能を利用する権利があるかを判定します。
purchaseProduct	ネイティブの購入フローを開始します。サポートされているiOSバージョンでは、以下を渡します： billingPlanType: 'monthly' 12ヶ月の継続利用を条件とした月額プランを購入します。
getProducts	製品識別子に関連付けられた製品情報を取得します。サポートされているiOSバージョンでは、サブスクリプション製品に以下を含めることができます： pricingTerms.
getProduct	単一の製品識別子に対応する製品情報を取得します。
isBillingSupported	現在のデバイスで課金がサポートされているか確認します。
getPluginVersion	ネイティブの Capacitor プラグインのバージョンを取得します。
getPurchases	ユーザーのすべての購入履歴（アプリ内課金およびサブスクリプション）を取得します。このメソッドは、現在のユーザーのプラットフォーム上の購入履歴を照会します。
manageSubscriptions	プラットフォームのネイティブなサブスクリプション管理ページを開きます。ユーザーはここでサブスクリプションの確認、変更、解約が可能です。
acknowledgePurchase	購入トランザクションを手動で承認または完了させます。
consumePurchase	Androidでのアプリ内課金を消費（Consume）します。
addListener	AppleのTransaction.updatesから配信されるStoreKitのトランザクション更新をリッスンします。未完了のトランザクションがある場合はアプリ起動時に、その後は更新のたびに実行されます。iOSのみ。
addListener	AppleのTransaction.updatesから配信されるStoreKitのトランザクション検証失敗をリッスンします。検証結果がunverified（未検証）の場合に実行されます。iOSのみ。
removeAllListeners	登録されているすべてのリスナーを削除します。

信頼できる情報源

このリファレンスは以下から同期されています： src/definitions.ts 内の capacitor-native-purchases.

@capgo/native-purchasesの続きはこちら

以下を使用している場合： @capgo/native-purchases 決済や購入を計画するには、以下と連携してください @capgo/native-purchases の使用 @capgo/native-purchases でネイティブ機能を使用する場合、 Capgo の料金プラン Capgo Pricing のプロダクトワークフローについては、 決済システム 決済システムの実装詳細については、 はじめに Getting Started の実装詳細については、および 収益化プレイブック 実装の詳細については Revenue Playbook を参照してください。