ドキュメント

サポート

Lobby

Lobby

Lobby のエラーメッセージ

Reference common Lobby service error codes and messages to troubleshoot integration issues.
読み終わるまでの所要時間 3 分最終更新 2ヶ月前

Lobby サービスは、他のほとんどの UGS サービスと一貫性のある追加のフィールドを含む "問題の詳細" 形式 (RFC 7807) でエラーを返します。 *例: *
{ "title": "Bad Request", "status": 400, "code": 16000, "detail": "request failed validation", "details": [ { "errorType": "validation", "message": "count in body should be less than or equal to 100" } { "errorType": "validation", "message": "skip in body should be greater than or equal to 0" } ], "type": "http://unity3d/lobby/errors/validation-error"}

エラー状況

フィールド

説明

Code (コード)エラーの種類を一意に識別する Unity Services エラーコード
Detail (詳細)問題の今回の発生に固有の人間が判読可能な説明。
Details (詳細)特定のエラーに関する追加の詳細のリスト。下の エラー詳細 を参照してください。
Status (ステータス)レスポンスの HTTP ステータスコード。
Title (タイトル)問題タイプに関する人間が判読可能な短いサマリー。ローカライズが目的の場合を除き、問題の発生ごとに変化しません。
Type (タイプ)問題タイプを識別する URI であり、問題のドキュメントを提供する場合があります。これらの URL は現在機能しません

エラー詳細

フィールド

説明

ErrorType (エラータイプ)エラー詳細のタイプを表します。
Message (メッセージ)エラーについての詳細情報を提供します。

エラーコード

Lobby サービスからのエラーレスポンスの
code
プロパティは、発生した問題のタイプをプログラムで識別するために使用できます。これらは、特定の問題を自動的に解決する (例えば、期限切れトークンのリフレッシュ、一時的なエラーにより失敗したリクエストの再試行など) ために SDK によって使用され、クライアントが適宜反応できるように SDK によってスローされた例外で開発者に公開されます。
共通エラーコードは 0 - 999 の範囲です。これらは通常、クライアントと Lobby サービスの間のコンポーネントに問題 (ネットワーク接続、認証失敗、レート制限など) がある場合に見られます。これらが透過的に処理されない場合、通常はサービスの重大なエラーを示していますが、一般にはめったに発生しません。 Lobby 固有のエラーコードは 16000 - 16999 の範囲です。これらは、Lobby サービスの特定のエラーケースを識別するために使用されます。これらの多くは一般的で、サービスの通常の動作中に発生し、滑らかなユーザー体験を提供するためにゲーム開発者が処理する必要があります。例えば、参加アクションを実行すると、エラー
LobbyNotFound
(
16001
) が表示されることがあります。これは単に、参加しようとしたロビーが、クエリ結果が返された後に削除されたことを意味している可能性があり、ゲームクライアントはこれを適切に処理する必要があります。
特定の共通エラーコードとロビー固有のエラーコードが重複しているように見える場合がありますが (
NotFound
が最も明白な例です)、これらを同じ方法で処理しないでください。共通の
NotFound
エラーコードは、SDK または API クライアントの機能的な問題 (間違って設定されたリクエスト URL など) を示している可能性があります。特定の問題に関する詳細情報についてエラー詳細を調べて、その解決方法を特定する必要があります。

Code (コード)

名前

説明

0UnknownUnknown は、エラーが何であるかをサーバーが判断できない場合に返されます。
1TransportErrorTransportError は、DNS、TLS またはその他の転送エラーがある場合に返されます。
2TimeoutTimeout は、割り当てられた時間内にレスポンスを受信せず、リクエストがタイムアウトになった場合に返されます。
3ServiceUnavailableServiceUnavailable は、一般に、サービスが過負荷になっているかサービスメンテナンスによりダウンしているためサービスを使用できない場合に返されます。
4ApiMissingApiMissing は、API が存在しない場合に返されます。
5RequestRejectedRequestRejected は、リクエストが API に到達する前にリクエストが拒否された場合に返されます。詳細については、"Title (タイトル)" と "Details (詳細)" を参照してください。
50TooManyRequestsTooManyRequests は、クライアントがリクエストを非常に頻繁に行っているためリクエストがレート制限されている場合に返されます。"Lobby のレート制限" を参照してください。
51InvalidTokenInvalidToken は、認証トークンが無効な場合に返されます。
52TokenExpiredTokenExpired は、認証トークンが期限切れの場合に返されます。
53ForbiddenForbidden は、ユーザーがリクエストされた操作の実行権限を持たない場合に返されます。
54NotFoundNotFound は、リクエストされたリソースが見つからなかった場合に返されます。
55InvalidRequestInvalidRequest は、リクエストは理解されたものの、リクエスト検証エラーにより API がその処理を拒否した場合に返されます。
16000ValidationErrorValidationError は、ユーザーのリクエストの検証に問題がある場合に返されます。エラー詳細に、問題に関する追加情報が含まれます。
16001LobbyNotFoundLobbyNotFound は、リクエストされたロビーが見つからなかった場合に返されます。
16002PlayerNotFoundPlayerNotFound は、リクエストされたプレイヤーがロビー内に見つからなかった場合に返されます。
16003LobbyConflictLobbyConflict は、ロビーの更新の試行中に競合が発生した場合に返されます。これは、ロビーに参加しようとしているプレイヤーがすでにメンバーになっているか、ロビーに対する他の更新を試行中に解決できない問題があったことを示している可能性があります。
16004LobbyFullLobbyFull は、ユーザーが参加しようとしているロビーに最大プレイヤー数がすでに含まれている場合に返されます。
16005LobbyLockedLobbyLocked は、ロビーのメンバーシップがロックされており、新しいプレイヤーが参加できない場合に返されます。
16006NoOpenLobbiesNoOpenLobbies は、QuickJoin リクエストが、ユーザーが参加するために使用可能なスペースをロビーに見つけられなかった場合に返されます。
16007LobbyAlreadyExistsLobbyAlreadyExists は、ロビーがすでに存在するため作成できないことを示します。
16008LobbyNotModifiedLobbyNotModified は、最後に観測されたバージョン以降、ロビーリソースが変更されていないことを示します。
16009IncorrectPasswordIncorrectPassword は、プレイヤーがパスワードを使用して参加を試みたがロビーのパスワードと一致しなかったことを示します。
16010InvalidJoinCodeInvalidJoinCode は、無効な文字などの理由で参加コードが有効でないことを示します。