本页尚未翻译,当前显示英文版本。
连接到游戏
玩家进入对局只需三步:登录,拿到一个席位的预订,再用它连接 Room 的服务器。 PlayServ 负责找到 Room 并发放票据;你的 Game server 校验票据并放玩家进入。游戏本身从不与机器或托管服务商打交道,它只拿到一个地址和一张票据。
开始之前
| 你需要 | 在哪里 |
|---|---|
| 一个已接入 PlayServ 并带有 client key 的游戏 | Connect Your Game |
| 一个会注册 Room 的 Game server | Game 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 席位已空出。
后续步骤
- 浏览、创建与加入 Room —— Room 调用的全部选项和拒绝原因
- 托管 Game server —— 在服务器上注册 Room 并校验票据
- Groups —— 发给 Room 内所有人的 Event
更新于 2026年10月22日