Skip to content

内置房间 » 大厅房间

在 Colyseus 1.0.0 中, 将更改大厅房间客户端 API

目前, 内置大厅房间依赖于发送消息, 向客户端通知有关可用房间的信息. 当 @filter() 变得稳定时, LobbyRoom 将改为使用 state.

服务器端

在具有 "实时列表" 的房间有更新时, 内置的 LobbyRoom 会自动通知其连接的客户端.

import { LobbyRoom } from "colyseus";

// Expose the "lobby" room.
gameServer
  .define("lobby", LobbyRoom);

// Expose your game room with realtime listing enabled.
gameServer
  .define("your_game", YourGameRoom)
  .enableRealtimeListing();

在 onCreate(), onJoin(), onLeave() 和 onDispose() 期间,将自动通知 LobbyRoom.

如果您已经 更新了您的房间的元数据, 并且还需要更新游戏大厅, 那么您可以在元数据更新后马上调用 updateLobby():

import { Room, updateLobby } from "colyseus";

class YourGameRoom extends Room {

  onCreate() {

    //
    // This is just a demonstration
    // on how to call `updateLobby` from your Room
    //
    this.clock.setTimeout(() => {

      this.setMetadata({
        customData: "Hello world!"
      }).then(() => updateLobby(this));

    }, 5000);

  }

}

客户端

您需要根据 LobbyRoom 发送到客户端的信息来游戏房间的添加, 删除和更新等状态.

import { Client, RoomAvailable } from "colyseus.js";

const client = new Client("ws://localhost:2567");
const lobby = await client.joinOrCreate("lobby");

let allRooms: RoomAvailable[] = [];

lobby.onMessage("rooms", (rooms) => {
  allRooms = rooms;
});

lobby.onMessage("+", ([roomId, room]) => {
  const roomIndex = allRooms.findIndex((room) => room.roomId === roomId);
  if (roomIndex !== -1) {
    allRooms[roomIndex] = room;

  } else {
    allRooms.push(room);
  }
});

lobby.onMessage("-", (roomId) => {
  allRooms = allRooms.filter((room) => room.roomId !== roomId);
});

Back to top