기술 자료

지원

Lobby

Lobby

빠른 참여

Find and join an available lobby that matches your criteria without manually browsing results from a list.
읽는 시간 1분최근 업데이트: 한 달 전

Quick Join API를 사용하면 플레이어가 쿼리에서 특정 로비를 수동으로 선택하지 않고도 신속하게 로비를 찾아 참여할 수 있습니다. 플레이어가 쿼리 필터를 설정하고 Quick Join 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);}