官方套件 · 框架

不用 Action Cable 的 Hotwire Turbo Streams

Rails 應用程式現有的每個 Turbo Stream 廣播都改由 Hibira 傳送,不必再維運 Action Cable 伺服器、Redis 或 Solid Cable。Model 與 View 都不用改。

  • broadcasts_to、broadcast_append_to 與 turbo_stream_from 照常運作,從請求或 Active Job 發出都一樣。
  • 也能簽署您自己的私人與 presence 頻道、驗證 Webhook,並發放推播通知權杖。
  • 支援 Rails 7.0 至 8.1、turbo-rails 1.5 至 2。

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

  1. 安裝

    bundle add hibira-rails
    bin/rails generate hibira:install
  2. 設定

    HIBIRA_APP_ID=YOUR_APP_ID
    HIBIRA_APP_KEY=YOUR_APP_KEY
    HIBIRA_APP_SECRET=YOUR_APP_SECRET
    
    bin/rails hibira:check
  3. 使用

    class Message < ApplicationRecord
      belongs_to :room
      broadcasts_to :room
    end
    
    # app/views/rooms/show.html.erb
    # <%= turbo_stream_from @room %>

開始之前

  • 應用程式的密鑰只會在建立應用程式或輪替密鑰時顯示一次。請只放在伺服器上,不要放進瀏覽器或遊戲的建置檔。
  • Free 方案需要把頁面載入的每個來源都加進應用程式的「允許的來源」(開發時是 http://localhost:3000,之後是您的網域)。"*" 需要付費方案。

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