房间

功能说明

房间是联机大厅的基础能力。实时消息、状态与 RPC、Mirror 传输层都依赖房间流程。

房间能力覆盖进入房间、准备、开始、结束、重赛、离开、运行中换地图，以及玩家加入 / 离开等事件。房间流程通常需要由 IGP 桌面客户端按联调或正式流程启动游戏。

支持引擎

引擎	状态	说明
Unity	Preview	已提供完整房间主流程。
GameMaker	暂不支持	当前 GameMaker 首期不包含房间能力。
Godot	开发中	预览 runtime 已有房间生命周期调用。

前置条件

已完成启动与连接。
游戏通过 IGP 桌面客户端启动，并获取联机启动信息。
Unity 场景中保留唯一的 IGPRuntimeManager。
Godot 项目已注册 IGPGodotAutoload。

按引擎查看

using UnityEngine;
using IGP.UnitySDK;
using IGP.UnitySDK.Models;

public sealed class IGPRoomDriver : MonoBehaviour
{
    [SerializeField] private IGPRuntimeManager runtimeManager;

    private void OnEnable()
    {
        runtimeManager.onRoomJoined.AddListener(OnRoomJoined);
        runtimeManager.onRoomUpdated.AddListener(OnRoomUpdated);
        runtimeManager.onRoomLeft.AddListener(OnRoomLeft);
        runtimeManager.onMapChanged.AddListener(OnMapChanged);
    }

    private void OnDisable()
    {
        runtimeManager.onRoomJoined.RemoveListener(OnRoomJoined);
        runtimeManager.onRoomUpdated.RemoveListener(OnRoomUpdated);
        runtimeManager.onRoomLeft.RemoveListener(OnRoomLeft);
        runtimeManager.onMapChanged.RemoveListener(OnMapChanged);
    }

    private async void OnRoomJoined(Room room)
    {
        Debug.Log($"Joined room {room.id}");
        await runtimeManager.SetReadyAsync(true);
    }

    public async void StartGame()
    {
        await runtimeManager.StartHostedGameAsync();
    }

    public async void FinishGame()
    {
        await runtimeManager.FinishHostedGameAsync();
    }

    public async void LeaveRoom()
    {
        await runtimeManager.LeaveHostedRoomAsync();
    }

    private void OnRoomUpdated(Room room) {}
    private void OnRoomLeft(Room room) {}
    private void OnMapChanged(IGPMapChangeData mapChange)
    {
        Debug.Log($"Map changed to {mapChange.currentMapPublicId}");
    }
}

Godot 当前建议通过 autoload 调用房间能力。

using Godot;
using IGP.GodotSDK.Autoload;

public partial class RoomPanel : Control
{
    private IGPGodotAutoload IGP =>
        GetNode<IGPGodotAutoload>("/root/IGP");

    public override void _Ready()
    {
        IGP.RoomSnapshotReceived += OnRoomSnapshotReceived;
        IGP.RoomEventReceived += OnRoomEventReceived;
    }

    public async void Ready()
    {
        await IGP.SetReadyAsync(true);
    }

    public async void StartGame()
    {
        await IGP.StartHostedGameAsync();
    }

    public async void FinishGame()
    {
        await IGP.FinishHostedGameAsync();
    }

    private void OnRoomSnapshotReceived(string connectionStatus) {}
    private void OnRoomEventReceived(int eventType, string roomId) {}
}

Godot 仍处于开发中，当前示例主要用于评估和对齐接入方式。

运行中换地图

如果一局结束后仍然保留同一个房间，IGP 桌面客户端或 lobby 选择新地图后，会通过新的房间快照通知游戏。

Unity 游戏侧监听 onMapChanged：

runtimeManager.onMapChanged.AddListener(mapChange =>
{
    Debug.Log($"Map changed to {mapChange.currentMapPublicId}");
});

IGPMapChangeData 包含：

字段	说明
`roomId`	当前房间 ID
`previousMapPublicId` / `previousMapVersionId`	变更前地图
`currentMapPublicId` / `currentMapVersionId`	变更后地图
`room`	已更新后的完整房间快照

onMapChanged 只在同一个房间内地图字段变化时触发。如果是离开旧房间再进入新房间，仍然按 onRoomLeft / onRoomJoined 处理。

自测方式

引擎	检查点
Unity	收到 `onRoomJoined`，调用 `SetReadyAsync(true)` 成功；运行中换地图时收到 `onMapChanged`。
GameMaker	当前不做房间验收。
Godot	收到 `RoomSnapshotReceived`，调用 `SetReadyAsync(true)` 成功。

常见问题 / 排查

无法进入房间：先确认游戏是否由 IGP 桌面客户端启动。
Unity 切场景后房间断开：检查是否创建了第二个 IGPRuntimeManager。
Unity 没收到换地图事件：确认仍在同一个 roomId，且新房间快照里的 mapPublicId 或 mapVersionId 已变化。
ready 未生效：确认已经进入房间后再调用 ready。
Godot 收不到房间快照：确认已完成 bootstrap，并建立了房间联机连接。