Esta página ainda não foi traduzida: mostrando a versão em inglês.
Conectar-se a um jogo
Um Player entra em uma partida em três passos: faz login, obtém a reserva de uma vaga e conecta ao servidor da Room com ela. O PlayServ encontra a Room e entrega o ticket; o seu game server confere o ticket e deixa o Player entrar. O jogo nunca fala com as máquinas nem com o provedor de hospedagem: ele só recebe um endereço e um ticket.
Antes de começar
| Você precisa de | Onde |
|---|---|
| Um jogo conectado ao PlayServ, com uma client key | Connect Your Game |
| Um game server que registra Rooms | Hospedagem de game servers |
| Room settings para esse game server | Servers → Room settings. Sem elas, toda chamada de Room falha com RoomTypeNotFound. |
O fluxo
Faça login
PlayServ.Connect() faz login de um Player anônimo, ou o Player entra com um provedor. Toda chamada de Room é feita em nome desse Player. Veja User Login.
Obtenha uma reserva
Entre em uma Room que os seus servidores executam ou peça uma nova. Nos dois casos, a resposta é uma reserva: o nome da Room, onde conectar e um ticket de uso único.
using Playserv.Matchmaking;
using Playserv.Wrapper;
PlayServMatchReservation reservation;
try
{
var page = await PlayServMatchmaking.BrowseRoomsAsync("sky-arena",
new PlayServRoomBrowseQuery { PlacementState = "open" });
var result = page.Rooms.Count > 0
? await PlayServMatchmaking.JoinRoomAsync("sky-arena", page.Rooms[0].RoomName)
: await PlayServMatchmaking.HostRoomAsync(new PlayServHostRoomRequest { FunctionSlug = "sky-arena" });
reservation = result.Reservation;
}
catch (PlayServMatchmakingException e)
{
ShowError(e.RoomFailureCode);
return;
}Todas as opções e recusas estão em Listar, hospedar e entrar em Rooms.
Conecte antes que o ticket expire
Conecte a reservation.Connect e passe reservation.ReservationToken ao servidor. O ticket vale pelo Reservation TTL do tipo de Room, 20 segundos por padrão, então conecte imediatamente.
Jogue
O tráfego do jogo passa pela sua conexão com o servidor. O servidor também pode enviar Events para todos na Room por meio de um Group.
Conectar ao servidor
A forma de conectar depende do servidor:
| Servidor | Como o jogo conecta |
|---|---|
| Seu próprio netcode, como um Unity Dedicated Server com Netcode for GameObjects ou Mirror | Aponte o seu transporte para Connect.Host e Connect.Port (ou Connect.ConnectString) e envie ReservationToken na solicitação de conexão. O servidor confere o ticket com o PlayServ, veja Admitir Players. |
| A conexão de jogo do PlayServ, usada por game servers em C# | PlayServMatchmaking.CreateRoomSession(...) conecta, envia o ticket e volta a entrar após uma queda; CreateGameConnection() faz o mesmo uma única vez. Veja Room sessions. |
JoinRoomAndConnectAsync entra na Room, espera até o endereço dela ser conhecido e executa o seu código de conexão em uma única chamada, veja Entrar e conectar em uma chamada.
Connect pode vir vazio
reservation.Connect fica null enquanto o servidor não informou o próprio endereço. Espere e entre de novo, ou use JoinRoomAndConnectAsync, que espera por ele.
Reconectar após uma queda
Entre de novo na mesma Room
Chame JoinRoomAsync com o nome da Room para obter um ticket novo. Um ticket usado nunca funciona duas vezes.
Conecte com o novo ticket
Um Player que já estava na Room volta a entrar mesmo que ela esteja cheia ou em drenagem. O servidor guarda a vaga dele durante o período de tolerância de reconexão, 30 segundos por padrão.
Um Player que um operador removeu da Room em Game Rooms não consegue voltar a ela. Uma room session faz tudo isso por você.
Sair
Feche a sua conexão com o servidor; com uma room session, chame LeaveAsync. Saia dos Groups da Room com UnsubscribeGroupAsync. O servidor avisa o PlayServ de que a vaga está livre.
Próximos passos
- Listar, hospedar e entrar em Rooms — todas as opções e recusas das chamadas de Room
- Hospedagem de game servers — registrar Rooms e conferir tickets no servidor
- Groups — Events para todos em uma Room
Atualizado em 22 de out. de 2026