Skip to main content

最初の仮想通貨をセットアップする

Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラム を参照してください。
PlayFab Services SDK を使用して最初の仮想通貨をセットアップし、PlayFab Economy を始めましょう。API を介してタイトルと対話するためのエンティティ トークンを取得したら、仮想通貨を作成および構成します。

前提条件

タイトル エンティティ トークンを取得する

API を介してタイトル構成データを変更するには、まずタイトル エンティティ トークンを取得する必要があります。詳細については、Postman クイックスタート を参照してください。

新しい仮想通貨を作成する

新しい仮想通貨を作成するには、Currency タイプの下書きアイテムを作成する必要があります。

Game Manager

  1. Game Manager の Economy タブに移動し、Catalog (V2) を選択します。
  2. Currency を選択し、New currency を選択します。
  3. Title を編集し、Description を追加します - たとえば、DiamondsOur in-game currency of choice.
  4. Save and publish を選択して変更を完了します。
  5. Currency リストで通貨を確認します。

REST API

CreateDraftItem を呼び出します。次の本文を使用します。

  • FriendlyId は通貨コードで、1 ~ 3 個の英数字値を含むことができます
  • Title はプレイヤーに表示される表示名です
  • ContentType は Economy アイテムのカテゴリ分けです。まず ⚙️ > Title Settings > Economy > Catalog (V2) Settings で Content Type を設定する必要があります。
  • StartDate は通貨がプレイヤーに表示される日時を表す datetime 文字列です (デフォルトは作成時刻)

トラブルシューティング

  • 欠落した/期限切れのエンティティ トークン
    • CreateDraftItem を呼び出そうとして 401: Unauthorized エラーが返された場合、タイトル エンティティ トークンの取得を忘れたか、期限切れの可能性があります
  • コンテンツ タイプ '' はサポートされていません
    • CreateDraftItem を呼び出そうとして上記のメッセージを含む CatalogBadRequest が返された場合、まず Game Manager のタイトル設定ページの下のカタログ設定タブで content type を作成する必要があります

次のステップ

最初の仮想通貨をセットアップしたので、次のことができます。
  1. アプリ ストアで販売する PlayFab バンドルに通貨を追加します。
  2. AddInventoryItems を使用して、ゲーム サーバーからプレイヤーに通貨を報酬として与えます。
  3. 通貨に対応する価格をカタログ アイテムに割り当てます。
  4. PurchaseInventoryItems を使用して、プレイヤーがその通貨でカタログ アイテムを購入できるようにします。
最終更新日 2026年8月13日