次の方法で共有

ポスト サーバー最近遊んだプレイヤー グループ

  • [アーティクル]

グループ内ですべてのユーザーの最近のプレイヤーを追加または更新します (双方向)。

この API を使用すると、ゲーム サーバーは、ユーザーの最近のプレーヤーのリストに追加したり、既存の最近のプレイヤーのエントリを更新したりできます。 グループ内のすべてのユーザーは、互いの最近遊んだプレイヤーのリストに追加されます (双方向)。

最近遊んだプレイヤーのグループの例: [ [A、B、C]、[A、D]、[E、F] ]。

A は B、C、D に会いました。B は A と C に会いました。D は A としか会っていない、などです。

POST /titles/{titleId}/recentplayergroups/server

URI パラメーター

パラメーター 受信 必須 種類 説明
titleId path TRUE integer 要求の送信先ゲームの titleId。

要求ヘッダー

名前 必須 種類 説明
Authorization TRUE integer 呼び出し元は、XBL 3.0 承認形式内で XToken を提供する必要があります。 たとえば、承認: XBL3.0 x=2553948354698;>暗号化されたトークン<)
Content-Type TRUE 文字列 ContentType は application/json に設定する必要があります

リクエストの本文

名前 必須 種類 説明
recentPlayerGroups TRUE RecentPlayerGroup[] 双方向の最近遊んだプレイヤーのグループの配列。 少なくとも 1 つのグループ、最大 20 のグループが必要です。 各グループ内には、少なくとも 2 人のプレイヤー、最大 100 人のプレイヤーが必要です。

応答

名前 種類 説明
204 No Content 最近のプレイヤーのリクエストは正常に送信されました。
400 Bad Request ErrorResponse 要求の処理中にエラーが発生しました。 考えられるエラー コード: "RequestValidationError: 要求の検証に失敗しました。"、"AuthorizationError: 呼び出し元はリソースへのアクセスを許可されていません。"
その他の状態コード ThrottledEntity 要求が多すぎます。 Headers Retry-After: 整数

定義

BidirectionalRecentPlayer

名前 種類 説明
id 文字列 別のユーザーの ID (XUID 基数 10 の整数)。
network Network 他のユーザーが遭遇したネットワーク。

EncounterType

最近出会ったプレイヤーの種類。 このフィールドはオプションであり、既定値は [既定] です。 [既定] には規定の意味はありません。この値を適切に解釈するのは呼び出し元の責任です。

名前 種類 説明
既定値 文字列
Opponent 文字列
Teammate 文字列

ErrorResponse

名前 種類 説明
debugMessage 文字列 デバッグに使用できる可読版のエラー メッセージ。
errorCode 文字列 エラー コードの列挙型。

ネットワーク

名前 種類 説明
XboxLive 文字列

RecentPlayerGroup

グループ内のすべてのユーザーが、指定された時間に互いと会いました。 各グループには少なくとも 2 人、最大 100 人のユーザーが含まれる必要があります。

名前 種類 説明
encounterType EncounterType 最近出会ったプレイヤーの種類。 このフィールドはオプションであり、既定値は [既定] です。 [既定] には規定の意味はありません。この値を適切に解釈するのは呼び出し元の責任です。
recentPlayers BidirectionalRecentPlayer[]
timestamp 文字列

ServerRecentPlayerGroupsRequest

グループ内のすべてのユーザーが、指定された時間に互いと会いました。 各グループには少なくとも 2 人、最大 100 人のユーザーが含まれる必要があります。

名前 種類 説明
recentPlayerGroups RecentPlayerGroup 双方向の最近遊んだプレイヤーのグループの配列。 少なくとも 1 つのグループ、最大 20 のグループが必要です。 各グループ内には、少なくとも 2 人のプレイヤー、最大 100 人のプレイヤーが必要です。

ThrottledEntity

名前 種類 説明
currentRequests 文字列 現在のリクエスト数 - 同時接続数または割合。
debugMessage 文字列 デバッグに使用できる可読版のスロットル メッセージ。
LimitType 文字列 制限の種類、つまり同時接続数または割合。
maxRequests 文字列 許容される最大リクエスト数 - 同時接続数または割合。
periodInSeconds 文字列 割合または同時接続数の制限を超えたときに適用される秒単位の期間。
version 文字列 現在のスロットル契約バージョン。