• アプリでの必要なパッケージの依存関係の追加

​

開始する

​

セットアップ

1. package.jsonファイルのdependenciesセクションに、以下のライブラリ依存関係を追加します。
      "@amazon-devices/keplerscript-appstore-iap-lib": "~2.13.0",
   
2. 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

public purchase(purchaseRequestParams: IAPTypes.PurchaseParams): Promise<PurchaseResponse>;

​

IAP APIの使用例

const triggerPurchase = (sku?: string): void => {
      Logger.debug(`アイテム${sku}がクリックされました`);
      PurchasingService.purchase({ sku: sku })
            .then((res) => {
               // 購入レスポンスを処理します。
            })
            .then((user) => {
               // 必要に応じてユーザーのための操作を実行します。
            })
            .catch((err) => {
               // 例外が発生した場合は処理します。
            });

      return;
}

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フックは、メイン画面コンポーネントで呼び出す必要があります。このフックは自動的に呼び出されます