快速加入
快速加入 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);
}