ポスト サーバー最近遊んだプレイヤー グループ
- [アーティクル]
-
-
グループ内ですべてのユーザーの最近のプレイヤーを追加または更新します (双方向)。
この 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 |
文字列 |
エラー コードの列挙型。 |
ネットワーク
RecentPlayerGroup
グループ内のすべてのユーザーが、指定された時間に互いと会いました。 各グループには少なくとも 2 人、最大 100 人のユーザーが含まれる必要があります。
ServerRecentPlayerGroupsRequest
グループ内のすべてのユーザーが、指定された時間に互いと会いました。 各グループには少なくとも 2 人、最大 100 人のユーザーが含まれる必要があります。
| 名前 |
種類 |
説明 |
| recentPlayerGroups |
RecentPlayerGroup |
双方向の最近遊んだプレイヤーのグループの配列。 少なくとも 1 つのグループ、最大 20 のグループが必要です。 各グループ内には、少なくとも 2 人のプレイヤー、最大 100 人のプレイヤーが必要です。 |
ThrottledEntity
| 名前 |
種類 |
説明 |
| currentRequests |
文字列 |
現在のリクエスト数 - 同時接続数または割合。 |
| debugMessage |
文字列 |
デバッグに使用できる可読版のスロットル メッセージ。 |
| LimitType |
文字列 |
制限の種類、つまり同時接続数または割合。 |
| maxRequests |
文字列 |
許容される最大リクエスト数 - 同時接続数または割合。 |
| periodInSeconds |
文字列 |
割合または同時接続数の制限を超えたときに適用される秒単位の期間。 |
| version |
文字列 |
現在のスロットル契約バージョン。 |