Lobby 오류 메시지
Reference common Lobby service error codes and messages to troubleshoot integration issues.
읽는 시간 1분최근 업데이트: 한 달 전
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 서비스 오류 코드입니다. |
| Detail | 문제의 발생과 관련된 설명이며 읽을 수 있습니다. |
| Details | 특정 오류에 관한 추가 세부 정보 목록입니다. 아래의 오류 세부 정보를 참고하십시오. |
| Status | 응답의 HTTP 상태 코드입니다. |
| Title | 읽을 수 있게 문제 유형이 간략하게 요약된 형태입니다. 현지화 목적이 아닌 이상 문제가 발생할 때마다 바꾸면 안 됩니다. |
| Type | 문제 유형을 식별하고 문제에 대한 기술 자료를 제공할 수 있는 URI입니다. 이러한 URL은 현재 작동하지 않습니다. |
오류 세부 정보
필드 | 설명 |
|---|---|
| ErrorType | 오류 유형의 세부 정보를 나타냅니다. |
| Message | 오류의 자세한 정보를 담고 있습니다. |
오류 코드
Lobby 서비스에서 발생한 오류 응답의codeLobbyNotFound16001NotFoundNotFound코드 | 이름 | 설명 |
|---|---|---|
| 0 | Unknown | Unknown은 서버에서 오류 유형을 결정할 수 없을 때 반환됩니다. |
| 1 | TransportError | TransportError는 DNS, TLS, 기타 전송 오류가 있을 때 반환됩니다. |
| 2 | Timeout | Timeout은 요청 시간이 초과되어 할당된 시간 내에 응답을 수신하지 못했을 때 반환됩니다. |
| 3 | ServiceUnavailable | ServiceUnavailable은 일반적으로 서비스 유지 관리로 인해 서비스가 과부하 상태이거나 다운되어 서비스를 사용할 수 없을 때 반환됩니다. |
| 4 | ApiMissing | ApiMissing은 API가 존재하지 않을 때 반환됩니다. |
| 5 | RequestRejected | RequestRejected는 요청이 API에 도달하기 전에 거부되었을 때 반환됩니다. 자세한 내용은 Title과 Details를 참고하십시오. |
| 50 | TooManyRequests | TooManyRequests는 클라이언트가 너무 자주 요청을 생성하여 요청에 속도 제한이 적용되는 경우에 반환됩니다. Lobby 속도 제한을 참고하십시오. |
| 51 | InvalidToken | InvalidToken은 인증 토큰이 유효하지 않은 경우에 반환됩니다. |
| 52 | TokenExpired | TokenExpired는 인증 토큰이 만료된 경우에 반환됩니다. |
| 53 | Forbidden | Forbidden은 사용자에게 요청된 작업을 수행할 권한이 없을 때 반환됩니다. |
| 54 | NotFound | NotFound는 요청된 리소스를 찾을 수 없을 때 반환됩니다. |
| 55 | InvalidRequest | InvalidRequest는 요청이 파악되었지만 요청 확인 오류로 인해 API에서 처리를 거부한 경우에 반환됩니다. |
| 16000 | ValidationError | ValidationError는 사용자의 요청을 확인하는 데 문제가 있을 때 반환됩니다. 오류 세부 정보에서 문제 관련 자세한 내용을 확인할 수 있습니다. |
| 16001 | LobbyNotFound | LobbyNotFound는 요청된 로비를 찾을 수 없을 때 반환됩니다. |
| 16002 | PlayerNotFound | PlayerNotFound는 요청된 플레이어를 로비에서 찾을 수 없을 때 반환됩니다. |
| 16003 | LobbyConflict | LobbyConflict는 로비를 업데이트하는 동안 충돌이 있을 때 반환됩니다. 로비에 참여하려는 플레이어가 이미 멤버였거나, 로비에 일부 다른 업데이트를 시도하는 동안 해결할 수 없는 문제가 있었음을 나타낼 수 있습니다. |
| 16004 | LobbyFull | LobbyFull은 사용자가 참여하려는 로비에 이미 최대 플레이어 수가 충족된 경우에 반환됩니다. |
| 16005 | LobbyLocked | LobbyLocked는 로비의 멤버십이 잠겨 있고 신규 플레이어 참여를 받지 않을 때 반환됩니다. |
| 16006 | NoOpenLobbies | NoOpenLobbies는 QuickJoin 요청을 통해 사용자가 참여할 수 있는 로비를 찾을 수 없을 때 반환됩니다. |
| 16007 | LobbyAlreadyExists | LobbyAlreadyExists는 로비가 이미 존재하기 때문에 로비를 만들 수 없음을 나타냅니다. |
| 16008 | LobbyNotModified | LobbyNotModified는 마지막 관찰된 버전 이후 로비 리소스가 수정되지 않았음을 나타냅니다. |
| 16009 | IncorrectPassword | IncorrectPassword는 플레이어가 로비의 비밀번호와 일치하지 않는 비밀번호로 참여하려고 시도했음을 나타냅니다. |
| 16010 | InvalidJoinCode | InvalidJoinCode는 유효하지 않은 문자 등 어떠한 이유로든 참여 코드가 유효하지 않음을 나타냅니다. |