官方套件 · 即時功能元件

即時游標、頭像與編輯鎖

建立在 presence 頻道上的協作:誰在線、在哪裡、即時游標、避免兩人同時編輯同一欄位的元件鎖,以及簡報用的跟隨模式。

  • 每位成員都有個人設定與所在位置,例如正在看的頁面或投影片。
  • 游標座標每秒送出五次,並依原本的節奏重播,移動看起來很平順。
  • 別人持有的欄位,lock() 會失敗;成員離開時,他的鎖會自動解除。

登入後,範例程式碼會自動帶入您的叢集主機。 登入

  1. 安裝

    npm install @hibira-io/spaces pusher-js
  2. 使用

    import { Space } from '@hibira-io/spaces';
    
    const pusher = new Pusher('YOUR_APP_KEY', {
      cluster: 'hkg',
      wsHost: 'ws.hibira.io',
      channelAuthorization: { endpoint: '/spaces/auth' },
    });
    const space = Space.enter(pusher, 'presence-space-doc-42', { profile: { color: '#e5484d' } });
    space.on('members', ({ members }) => renderAvatars(members));
    space.on('cursor', ({ id, member, x, y }) => drawCursor(id, member, x, y));

開始之前

  • 在應用程式設定中開啟「允許用戶端事件」,玩家之間才能互傳動作與點擊。
  • 私人頻道與 presence 頻道需要後端提供授權端點,用應用程式密鑰簽署訂閱,做法和 pusher-js 相同。

請使用儀表板中的應用程式 Key;Secret 只放在你的伺服器上。頻道、事件與授權端點的用法和 Pusher 完全相同。 免費建立帳號 →