无需自建服务器的多人游戏：房间和语音

玩家看到什么

• 支持在线游玩的游戏房间：公开房间，或凭邀请码进入的私人房间。
• “创建房间”：名称、2、4 或 8 名玩家，以及游戏自己的房间设置。
• 带房主、“准备”和离线标记的成员，房间聊天，以及移除成员。
• 语音聊天：关闭麦克风、按 V 键说话或常开麦克风、每位成员的静音和音量、谁在说话。
• **房主的“开始”**会把房间里的每台设备都带入游戏。

如何运作

• 房间及其会话归大厅所有；游戏从不自己创建或加入房间。
• 游戏在大厅中注册后就能联网游玩；之后它的“开始”旁边会出现“和好友一起”。
• 如果游戏允许，后来的玩家可以加入正在进行的游戏。体素沙盒是参考实现。

开发者须知

房间通过 client.multiplayer 和 RealtimeSession（@idosgames/core/realtime）工作；游戏通过 ctx.multiplayer 接入。

// 在游戏模块的 setup() 中：游戏通过大厅房间联网游玩
ctx.multiplayer.registerGame({
  mode: 'my-game',
  topology: 'Host',
  chatMode: 'ServerRelay', // 大厅的房间聊天
  maxPlayers: 4,
  joinInProgress: true,
  // 房主点击“开始”后，在每位成员的设备上执行
  start: async (room) => startOnline(room.session, { host: room.isHost, leave: room.leave }),
})

• 用 room.leave() 离开：房间归大厅所有。
• 只有在多人游戏功能可用时才显示“和好友一起玩”：没有它，游戏就保持单人模式。

每个字段都在技能 multiplayer-realtime 中有说明，由 SDK 的 MCP 服务器提供。