Lobby 错误消息#

Lobby 服务以“问题详细信息”格式 (RFC 7807) 返回错误，其中包括一些与大多数其他 UGS 服务一致的额外字段。

示例：

{
  "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"
}

错误状态

错误详细信息#

错误代码#

Lobby 服务错误响应的 code 属性可用于以编程方式确定所发生问题的类型。SDK 使用这些信息来自动解决某些问题（例如刷新已过期的令牌、重试因瞬时错误而失败的请求等等），并且这些信息在 SDK 抛出的异常中向开发者显示，以便客户端可以做出适当的响应。

通用错误代码的范围为 0-999。当客户端与 Lobby 服务之间的某些组件存在问题（例如网络连接问题、身份验证失败或速率限制）时，通常会出现这些错误代码。如果这些情况没有得到透明处理，通常表示服务存在更为严重的错误，而且通常会更为罕见。

Lobby 专用错误代码的范围为 16000-16999。这些用于标识 Lobby 服务中的特定错误情形。其中许多情形都很常见，并会在服务正常运行期间发生，游戏开发者应该妥善处理，以提供流畅的用户体验。例如，在执行加入操作时，可能会遇到 LobbyNotFound (16001) 错误，这可能只是表示在查询结果返回后，您尝试加入的大厅已被删除，游戏客户端应能够妥善地处理这种情况。

某些通用错误代码和 Lobby 专用错误代码之间可能看起来存在一定重叠（最明显的例子是 NotFound），但它们不应该以相同的方式处理。通用 NotFound 错误代码有可能表明 SDK 或 API 客户端存在功能问题（例如请求 URL 配置不正确）。您应该查看错误详细信息，以了解有关特定问题的更多信息，从而确定如何解决问题。