トレード

  • [アーティクル]

PlayFab クライアント API を使うと、プレイヤーは互いにアイテムをトレードできます。 これらの API メソッドは既定で有効になっています。場合によっては、タイトルのセキュリティのため、ポリシー API を使って無効にする必要があります。

注意

インベントリ トレード機能はプレビュー フェーズです。 これらのメソッドは機能しますが、完全な機能に必要な便利な要素がいくつか不足しています。 現在のところ、仮想アイテムのみトレードできます。 仮想通貨を要求またはトレードすることはできず、PlayFab では他のプレイヤーから提供されているトレードの一覧は表示できません。 トレード メソッドはクライアント API でのみ使用でき、サーバー API からは使用できません。

主要概念

カタログ - カタログを利用することで、ゲームの仮想アイテムを簡単に管理できます。 カタログは、ゲームで利用可能なすべてのアイテムのリストです。

カタログ アイテム – 非消費型アイテムからバンドル、ロックされたコンテナーまで、PlayFab のアイテムは使用可能なあらゆるタイプの仮想グッズを表します。

インベントリ - すべてのアカウント (プレイヤー アカウントとキャラクター アカウント) にはインベントリがあります。 インベントリには、すべての所有アイテム インスタンスと現在までのアイテム履歴が含まれます。

仮想通貨 - PlayFab は、タイトルごとに最大 10 種類の仮想通貨を提供します。 通貨を使用してカタログまたはストアからアイテムを購入できます。通貨は、アプリ内購入から変換されたソフト通貨を表します。また、ゲームプレイを促進するためのメカニックとして使用できます。

前提条件

トレードには、カタログとインベントリー アイテムの両方に関する知識が必要です。 プレイヤーは、トレードするインベントリー アイテムを所有している必要があります。

API

トレード フローは、少数の API によって処理されます。

OpenTrade
新しい未処理トレードをオープンします。 これは、2 人の特定のプレイヤー間 (PlayfabIDs) か、トレードをオープンするプレイヤーとすべてのプレイヤー間のいずれかです。 任意の単独アイテム インスタンスが一度に属することができる オープン トレードは 1 つだけである点に注意してください。

GetTradeStatus
クライアントが現在のステータスを取得することによって指定されたトレードをできます。

AcceptTrade
オープン トレードを受け取ります。 呼び出しが成功した場合、提供されて受け入れられたアイテムは 2 つのプレイヤーのインベントリ間でスワップされます。

CancelTrade
オープン トレードをキャンセルします。 迷惑行為を防ぐため、トレードを作成したプレイヤーだけがこの API を使ってキャンセルできる点に注意してください。

GetPlayerTrades
GetPlayerTrades は、プレイヤーがオープンしたか受け入れたすべてのトレードを返します。オプションで、トレード ステータスによってフィルター処理できます。