トレードのクイックスタート - XBOX Game Development Documentation

このクイックスタートでは、カタログとインベントリアイテムの両方に既に精通していることを前提としています。例のプレイヤーは、トレードで譲渡したいインベントリアイテムを既に所有している必要があります。

最初のステップは、OpenTrade API を呼び出して、別のプレイヤーがトレードを利用できるようにすることです。ギフトの受取人を識別するための playfabId と、現在アイテムをインベントリに保有しているプレイヤーの ItemInstanceID が必要です。 secondPlayerId: ギフトの受取人 (PlayFabId) を識別する一意の文字列です。 myItemInstanceId: 現在のプレイヤーが所有するアイテムインスタンス (InstanceID) を識別する一意の文字列です。

void GiveItemTo(string secondPlayerId, string myItemInstanceId) {
    PlayFabClientAPI.OpenTrade(new OpenTradeRequest {
        AllowedPlayerIds = new List<string> { secondPlayerId }, // PlayFab ID for the friend who will receive your gift
        OfferedInventoryInstanceIds = new List<string> { myItemInstanceId } // The item instanceId fetched from GetUserInventory()
    }, LogSuccess, LogFailure);
}

すべてのトレードは公開情報です。どのプレイヤーも、他のプレイヤーのオープントレードや、そのプレイヤーの取引履歴を閲覧できます (そのプレイヤーの playFabId を知っている場合)。

このスニペットでは、LogSuccess コールバックが result.Trade.TradeId も評価し、firstPlayFabId と tradeId の両方を 2 番目のプレイヤーに転送する必要があります。これらが保存されていないと、2 番目のプレイヤーはトレードを評価または受諾できません。

現在のプレビューでは、トレードが同時実行アクションからスレッドセーフであることを確認する必要があります。スレッドセーフなオプションには、カスタムゲームサーバーや、CloudScript から外部データベース/システムへの Webhook 呼び出しがあります。スレッドセーフではないオプションは、プレイヤーデータキーを直接変更する CloudScript で構築できます。後者のオプションでは、同時発生するトレードリストの更新が正しく処理されない可能性があるという同時実行性の問題があります。

最初のプレイヤーがトレードを作成し、playFabId と tradeId を 2 番目のプレイヤーに転送したら、2 番目のプレイヤーは GetTradeStatus リクエストを行うことで、トレードの要件を確認できます (ギフトであることを確認するため)。

最も関連性の高い TradeStatus 値は、Open、Filled、および Canceled です。それ以外のすべての状態は中間状態です。呼び出しの間、トレードはそれらの中間状態に目立った期間留まる場合があります。最近変更されたトレードはすぐには利用できない場合があります。

void ExamineTrade(string firstPlayFabId, string tradeId) {
    PlayFabClientAPI.GetTradeStatus(new GetTradeStatusRequest {
        OfferingPlayerId = firstPlayFabId,
        TradeId = tradeId
    }, LogSuccess, LogFailure);
}

If the requirements of that trade are acceptable, the gift can be accepted using AcceptTrade
C# snip
void AcceptGiftFrom(string firstPlayFabId, string tradeId) {
    PlayFabClientAPI.AcceptTrade(new AcceptTradeRequest {
        OfferingPlayerId = firstPlayFabId,
        TradeId = tradeId
    }, LogSuccess, LogFailure);
}

完了すると、上記の AcceptGiftFrom 関数によって、贈られたアイテムが最初のプレイヤーのインベントリから 2 番目のプレイヤーへ転送されます。