官方套件 · 即時功能元件

用 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 完全相同。 免費建立帳號 →