跳到主要内容
多人联机

本页尚未翻译,当前显示英文版本。

连接到游戏

玩家进入对局只需三步:登录,拿到一个席位的预订,再用它连接 Room 的服务器。 PlayServ 负责找到 Room 并发放票据;你的 Game server 校验票据并放玩家进入。游戏本身从不与机器或托管服务商打交道,它只拿到一个地址和一张票据。


开始之前

你需要在哪里
一个已接入 PlayServ 并带有 client key 的游戏Connect Your Game
一个会注册 Room 的 Game serverGame Server Hosting
该 Game server 的 Room 设置Servers → Room settings。没有这些设置,所有 Room 调用都会以 RoomTypeNotFound 失败。

流程

登录

PlayServ.Connect() 会让玩家匿名登录,玩家也可以通过某个提供方登录。之后每次 Room 调用都以这个 Player 的身份发出。见 User Login。

拿到预订

加入你的服务器正在运行的某个 Room,或者请求创建一个新的。无论哪种方式,返回的都是一份预订:Room 的名称、连接地址和一张一次性票据。

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

所有选项和拒绝原因见 Browse, Host & Join Rooms。

在票据过期前连接

连接到 reservation.Connect,并把 reservation.ReservationToken 交给服务器。票据在 Room 类型的 Reservation TTL 内有效,默认 20 秒,所以拿到后要立即连接。

游戏

游戏流量走你与服务器之间的连接。服务器还可以通过 Group 向 Room 内所有人发送 Event。


连接到服务器

游戏的连接方式取决于服务器:

服务器游戏如何连接
你自己的 netcode,例如使用 Netcode for GameObjects 或 Mirror 的 Unity Dedicated Server把传输层指向 Connect.Host 和 Connect.Port(或 Connect.ConnectString),并在连接请求中发送 ReservationToken。服务器会向 PlayServ 校验它,见 放玩家进入。
PlayServ 的游戏连接,供 C# Game server 使用PlayServMatchmaking.CreateRoomSession(...) 负责连接、发送票据,并在掉线后重新加入;CreateGameConnection() 只做一次同样的事。见 Room session。

JoinRoomAndConnectAsync 在一次调用中完成加入、等待 Room 地址就绪并运行你的连接代码,见 一次调用完成加入与连接。

Connect 可能为空

服务器尚未上报地址时,reservation.Connect 为 null。稍等后重新加入,或者使用会等待地址的 JoinRoomAndConnectAsync。


掉线后重连

再次加入同一个 Room

用 Room 名称调用 JoinRoomAsync,拿到一张新票据。用过的票据不能再用第二次。

用新票据连接

原本就在 Room 里的玩家即使 Room 已满或正在排空,也能重新进入。服务器会在重连宽限期内为他保留席位,默认 30 秒。

被运营方在 Game Rooms 中移出 Room 的玩家无法重新加入。Room session 会替你完成以上所有步骤。


离开

关闭你与服务器的连接;如果用的是 Room session,调用 LeaveAsync。用 UnsubscribeGroupAsync 离开该 Room 的 Group。服务器会通知 PlayServ 席位已空出。


后续步骤

更新于 2026年10月22日