Pular para o conteúdo principal
Multiplayer

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 deOnde
Um jogo conectado ao PlayServ, com uma client keyConnect Your Game
Um game server que registra RoomsHospedagem de game servers
Room settings para esse game serverServers → 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:

ServidorComo o jogo conecta
Seu próprio netcode, como um Unity Dedicated Server com Netcode for GameObjects ou MirrorAponte 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

Atualizado em 22 de out. de 2026