快速加入

快速加入 API 让玩家可以快速查找并加入大厅，而不必从查询列表中手动选择具体的大厅。在玩家设置查询过滤器并调用快速加入 API 后，Lobby 服务会尝试将玩家放入符合其过滤条件且有空缺的大厅。

快速加入功能旨在解决以下常见问题：玩家手动进行查询，查看结果并选择大厅尝试加入，然后由于玩家尝试加入时大厅已满员而反复失败。它还可以用作基本的配对方式（只适用于现有的大厅，它不会创建新的大厅）。

最佳实践

快速加入功能并不保证请求一定会成功。如果没有符合查询条件的大厅，或者如果尝试加入后失败，则可能会发生失败。在这些情况下，客户端应该预期会收到 **404 Not Found（未找到）**错误。如果出现失败，客户端可以尝试再次使用快速加入功能（请参阅速率限制），或者可以返回创建新的大厅并承担厅主角色。

以下代码示例展示了如何设置快速加入功能：

try
{
    // Quick-join a random lobby with a maximum capacity of 10 or more players.
    QuickJoinLobbyOptions options = new QuickJoinLobbyOptions();

    options.Filter = new List<QueryFilter>()
    {
        new QueryFilter(
            field: QueryFilter.FieldOptions.MaxPlayers,
            op: QueryFilter.OpOptions.GE,
            value: "10")
    };

    var lobby = await LobbyService.Instance.QuickJoinLobbyAsync(options);

    // ...
}
catch (LobbyServiceException e)
{
      Debug.Log(e);
}

快速加入

最佳实践#

最佳实践