コンテンツにスキップ

モジュール：アプリ内課金

目次

機能

機能

consumePurchaseAsync

▸ consumePurchaseAsync(token): Promise<void>

現在のプレイヤーが課金して購入した特定のコンテンツを消費します。購入したコンテンツをプレイヤーに提供する前に、ゲームはその消費を求める必要があります。消費が正常に行われると、プレイヤーに対し、購入の効果を即座に提供する必要があります。これにより、プレイヤーの購入履歴にて購入済みとしてアップデートされ、購入可能なコンテンツリストでも購入済みとして表示されます。

例

Wortal.iap.consumePurchaseAsync('abc123');

パラメーター

名前 タイプ 内容説明
token string 消費目的の購入トークン。

Returns

Promise<void>

購入が成功した場合に解決する Promise。それ以外の場合は拒否されます。

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • INVALID_PARAM
  • NETWORK_FAILURE

getCatalogAsync

▸ getCatalogAsync(): Promise<Product[]>

購入可能なコンテンツリストを取得する。

例

Wortal.iap.getCatalogAsync()
 .then(products => console.log(products));

Returns

Promise<Product[]>

プレーヤーが購入可能なコンテンツの配列で解決する Promise。

プレーヤーの国/地域で購入が許可されていない場合、空のリストを返します。

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • NETWORK_FAILURE

getPurchasesAsync

▸ getPurchasesAsync(): Promise<Purchase[]>

プレーヤーが購入したコンテンツのうち、まだ消費されていないものをフェッチします。

クライアントが支払いに関する操作を実行する準備ができたことを確認した際、すなわち、ゲーム開始時に、現在のプレイヤーの購入履歴をフェッチする必要があります。

そして、まだ消費されていなかった購入済みのコンテンツを処理し、消費することができます。

例

Wortal.iap.getPurchasesAsync()
 .then(purchases => console.log(purchases));

Returns

Promise<Purchase[]>

プレイヤーが購入したコンテンツの配列で解決する Promise。

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • NETWORK_FAILURE

isEnabled

▸ isEnabled(): boolean

このセッションでアプリ内課金が有効かどうかをチェックします。

Returns

boolean

アプリ内課金が利用可能な場合は true 、現在のプラットフォームまたはプレイヤーのデバイスでサポートされていない場合や、購入画面が正しく読み込まれなかった場合は false となります。

makePurchaseAsync

▸ makePurchaseAsync(purchase): Promise<Purchase>

特定のコンテンツの購入フローを開始します。

例

Wortal.iap.makePurchaseAsync({
    productID: 'my_product_123',
}).then(purchase => console.log(purchase));

パラメーター

名前 タイプ 内容説明
purchase PurchaseConfig 製品のIDと購入情報を定義するオブジェクト。

Returns

Promise<Purchase>

プレイヤーがプロダクトの購入に成功した場合に解決する Promise。それ以外の場合は拒否されます。

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • INVALID_PARAM
  • NETWORK_FAILURE
  • INVALID_OPERATION
  • USER_INPUT