快速加入

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

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

最佳实践

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

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

C#

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);
}