官方包 · 实时功能组件

用 WebSocket 打造游戏房间与大厅

建立在 presence 频道上的房间：按加入顺序排座位、房主离开时自动移交、准备状态、设置、踢人、开始和房间聊天。服务端负责为座位签名并列出开放中的房间。

@hibira-io/lobby在线演示 ↗npm ↗GitHub ↗

• 可在浏览器、React Native 和能运行 JavaScript 的游戏引擎中使用。
• authorizeRoom() 控制房间人数上限；listRooms() 返回开放中的房间。
• Unity 和 Godot 的房间使用相同的事件，各引擎的玩家都能在同一个房间相遇。

登录后，示例代码会自动填入您的集群主机。 登录

1. 安装

   npm install @hibira-io/lobby pusher-js

2. 使用

   import { Room } from '@hibira-io/lobby';
   
   const pusher = new Pusher('YOUR_APP_KEY', {
     cluster: 'hkg',
     wsHost: 'ws.hibira.io',
     channelAuthorization: { endpoint: '/rooms/auth' },
   });
   const room = Room.join(pusher, 'presence-room-42', { capacity: 4 });
   room.on('members', ({ players }) => render(players));
   room.setReady(true);

开始之前

• 在应用设置中开启“允许客户端事件”，玩家之间才能互相发送操作和点击。
• 私有频道和 presence 频道需要后端提供授权端点，用应用密钥签名订阅，做法与 pusher-js 相同。

请使用控制台中应用的 Key；Secret 只放在你的服务器上。频道、事件与授权端点的用法与 Pusher 完全相同。 免费创建账号 →