取り引き

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

注意

在庫-取引機能はプレビュー段階にあります。 メソッドは機能しますが、完全に機能するために役立つ要素はいくつかありません。 現時点では、仮想アイテムの取引のみを行うことができます。 仮想通貨を要求またはトレードアウトすることはできません。また、PlayFab は、他のプレイヤーから利用できる取引のリストを提供しません。 貿易メソッドはクライアント API でのみ使用でき、サーバー API からは利用できません。

主要な概念

カタログカタログは、ゲームの仮想項目を管理するための簡単な方法を提供します。 これは、ゲームで利用できるすべての項目の一覧です。

カタログアイテム– Playfab 項目では、永続的なアドオンから、ロックされたコンテナーへのバンドルまで、任意の種類の仮想商品を表すことができます。

在庫-すべてのアカウント (プレーヤーアカウントと文字アカウント) には、在庫があります。 インベントリには、所有されているすべてのアイテムのインスタンスとアイテムの履歴が含まれます。

仮想通貨-playfab には、1つのタイトルにつき最大10個の仮想通貨が用意されています。 通貨は、カタログまたはストアから品目を購入するために使用できます。また、アプリ内購入からの通貨を表すことができます。または、mechanic として使用してゲームプレイを行うこともできます。

前提条件

取引には、カタログアイテムと在庫アイテムの両方の知識が必要です。 プレイヤーは、交易を希望する在庫品を所有している必要があります。

API

取引フローは、いくつかの Api によって処理されます。

オープン貿易
新しい未処理の取引を開きます。 これは、2つの特定のプレーヤー (PlayfabIDs) 間で、または1人のプレーヤーが、誰とでもオープンしているトレードを開くことができます。 1つの特定の項目インスタンスは、一度に1つのオープンなトレードにしか存在できないことを理解してください。

GetTradeStatus
現在の状態を取得して、クライアントが特定のトレードを評価できるようにします。

AcceptTrade
未処理の交易を承諾します。 通話が成功すると、提供されるアイテムと受け入れられたアイテムは、2人のプレイヤーのインベントリ間で入れ替わります。

CancelTrade
未処理の交易をキャンセルします。 Grief を防ぐため、この API 呼び出しによって、トレードを作成したプレーヤーだけがこの API を使ってキャンセルできることに注意してください。

GetPlayerTrades
GetPlayerTradesは、プレイヤーが登録または承諾したすべての取引を返します。必要に応じて、トレードの状態によってフィルター処理されます。