​

クイックスタート: プレイヤーのインベントリに最初のアイテムを追加する

​

前提条件

• PlayFab 開発者アカウント
• PlayFab Beta SDK (Postman クイックスタート で詳細情報を確認できます)
• カタログに少なくとも 1 つのアイテム (Economy v2 のクイックスタート で詳細情報を確認できます)
• アイテムを購入するのに十分な仮想通貨を持つ少なくとも 1 人のプレイヤー

​

プレイヤーとしてサインインする

​

アイテムを検索する

{
  "Search": "[Item Title]",
  "Top": 1
}

• Search は、カタログ内のすべてのアイテムの Title、Description、および Keywords に対してあいまい検索される検索文字列です
• Top は、返す結果の件数を決定する整数です。この場合は 1 件だけ必要です

• Items > Id - アイテムのカタログ ID
• Items > PriceOptions > Prices > Amounts > ItemId - アイテムの購入に使用する仮想通貨の ID
• Items > PriceOptions > Prices > Amounts > Amount - アイテムの購入に必要な仮想通貨の量

​

アイテムを購入する

{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}

• Item.Id はアイテムの ID (前のステップの Search レスポンスから取得)
• Amount はプレイヤーが購入しているアイテムの数
• ItemId はアイテムの購入に使用する仮想通貨の ID (前のステップの Search レスポンスから取得)
• Amount はアイテムの購入に必要な仮想通貨の量 (前のステップの Search レスポンスから取得)

​

プレイヤーのインベントリ アイテムを取得する

​

トラブルシューティング

• 残高不足
  • PurchaseInventoryItems を呼び出して 422: InsufficientFunds エラーが返された場合、プレイヤーはアイテムを購入するのに十分な仮想通貨を持っていません。AddInventoryItems を呼び出して (タイトル エンティティ トークンが必要)、または Game Manager の [Title] > Players > [Player] > Inventory (V2) に移動することで、プレイヤーに仮想通貨を付与できます。
• 指定された価格でアイテムを購入できません。
  • PurchaseInventoryItems を呼び出して 1071 エラー コードが返された場合、PriceAmounts フィールドがカタログで指定された価格と一致していません。

​

次のステップ