@amazon-devices/keplerscript-appstore-iap-lib
@amazon-devices/keplerscript-appstore-iap-lib
オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。
アプリ内課金（IAP）APIには、Amazonアプリストアの課金フレームワークとやり取りするためのメソッドが用意されています。
IAPを実装するには、以下を行う必要があります。
開始する
セットアップ
-
package.jsonファイルの
dependenciesセクションに、以下のライブラリ依存関係を追加します。"@amazon-devices/keplerscript-appstore-iap-lib": "~2.13.0", -
manifest.tomlに、以下の権限を追加します。
[wants] [[wants.service]] id = "com.amazon.iap.core.service" [[wants.module]] id = "/com.amazon.iap.core@IIAPCoreUI" [needs] [[needs.module]] id = "/com.amazon.kepler.appstore.iap.purchase.core@IAppstoreIAPPurchaseCoreService"
使用方法
PurchasingService
Amazonアプリストアの課金フレームワークとやり取りするための主要なメソッドを表します。
すべてのメソッドは、Promiseを使用してレスポンスを返します。
public purchase(purchaseRequestParams: IAPTypes.PurchaseParams): Promise<PurchaseResponse>;
詳細については、PurchasingServiceを参照してください。
IAP APIの使用例
以下の例は、IAPメソッドの使用方法を示しています。
const triggerPurchase = (sku?: string): void => {
Logger.debug(`アイテム${sku}がクリックされました`);
PurchasingService.purchase({ sku: sku })
.then((res) => {
// 購入レスポンスを処理します。
})
.then((user) => {
// 必要に応じてユーザーのための操作を実行します。
})
.catch((err) => {
// 例外が発生した場合は処理します。
});
return;
}
以下は、getProductDataメソッドの使用方法を示しています。
useEffect(() => { // 商品画面のレンダリング前に商品SKUを検証
// ...
// コンポーネントのレンダリング時にgetProductDataを呼び出します。
PurchasingService.getProductData({ skus: Constants.SKUS })
.then((res) => {
const [productData, unavailableSkus] = handleProductDataResponse(res);
})
.catch((err) => {
Logger.error(`getProductDataの呼び出し中に例外が発生しました：${err}`);
});
}, []);
関連トピック
APIリファレンス
クラス
- PurchasingService - Amazonアプリストアの課金フレームワークとやり取りするための主要なAPIを提供します。
インターフェイス
- CoinsReward - 関連付けられた商品の購入後にユーザーが獲得できる、Amazonコインに関するデータを格納します。
- ModifySubscriptionRequest - 定期購入型アイテムの変更リクエストの入力パラメーターを表します。
- ModifySubscriptionResponse - 呼び出しの結果を表します。
- NotifyFulfillmentRequest - アイテム付与ステータスの通知リクエストの入力パラメーターを表します。
- NotifyFulfillmentResponse - 呼び出しの結果を表します。
- Price - 価格のデータモデルを表します。
- Product - 消費型アイテム、非消費型アイテム、定期購入型アイテムのコンテンツなど、アプリ内課金（IAP）商品を表します。取得
- ProductDataRequest - 商品データを取得するリクエストの入力パラメーターを表します。
- ProductDataResponse - 呼び出しの結果を表します。
- Promotion - 設定されたプロモーションを表します。
- PromotionPlan - 「3週間、週あたり3.00 USDの導入プロモーション」などのプロモーションプランを表します。
- PurchaseRequest - 購入リクエストの入力パラメーターを表します。
- PurchaseResponse - 呼び出しの結果を表します。
- PurchaseUpdatesRequest - 購入に関するアップデートの取得リクエストの入力パラメーターを表します。
- PurchaseUpdatesResponse - 呼び出しの結果を表します。
- Receipt - 消費型アイテム、非消費型アイテム、定期購入型アイテムのコンテンツの購入と、定期購入型アイテムの更新を表します。
- RequestId - アプリ内課金（IAP）リクエストのIDを表します。
- UserData - アプリ内課金（IAP）に使用されるユーザー情報を表します。
- UserDataRequest - ユーザーデータ取得リクエストの入力パラメーターを表します。
- UserDataResponse - 呼び出しの結果を表します。
- UserProfileAccessResponse - 呼び出しの結果を表します。
列挙型
- FulfillmentResult - アプリ内課金（IAP）のアイテム付与の結果を表します。
- LwaConsentStatus - サポートされているLWA同意ステータス。
- ModifySubscriptionResponseCode - 開始された定期購入型アイテムの変更リクエストに対するレスポンスコードを表します。
- NotifyFulfillmentResponseCodeアイテム付与通知リクエストに対するレスポンスコードを表します。
- ProductDataResponseCode - 開始された商品データリクエストに対するレスポンスコードを表します。
- ProductType - 商品のタイプを表します。消費型アイテム、非消費型アイテム、定期購入型アイテムのいずれかになります。
- ProrationMode - サブスクリプションの比例配分モード。
- PurchaseResponseCode - 開始された購入リクエストに対するレスポンスコードを表します。
- PurchaseUpdatesResponseCode - 開始された購入の更新リクエストに対するレスポンスコードを表します。
- UserDataResponseCode - 開始されたユーザーデータの取得リクエストに対するレスポンスコードを表します。
- UserProfileAccessConsentStatus - サポートされているユーザープロフィールへのアクセスの同意ステータス。
- UserProfileAccessResponseCode - 開始されたUserProfileAccessリクエストに対するレスポンスコードを表します。
関数
- useIapProductData - 通常、useIapProductDataフックは商品ページで呼び出され、IAP商品情報を取得して表示します。
- useIapPurchaseUpdates - useIapPurchaseUpdatesフックは、メイン画面コンポーネントで呼び出す必要があります。このフックは自動的に呼び出されます
- useIapUserData - useIapUserDataフックは、メイン画面コンポーネントで呼び出す必要があります。このフックは自動的に呼び出されます
Last updated: 2026年7月22日
