แพ็กเกจอย่างเป็นทางการ · เฟรมเวิร์ก

Hotwire Turbo Streams โดยไม่ต้องใช้ Action Cable

ทุกการบรอดแคสต์ Turbo Stream ที่แอป Rails ส่งอยู่แล้วจะวิ่งผ่าน Hibira โดยไม่ต้องดูแลเซิร์ฟเวอร์ Action Cable, Redis หรือ Solid Cable ส่วนโมเดลและวิวไม่ต้องแก้

  • broadcasts_to, broadcast_append_to และ turbo_stream_from ทำงานเหมือนเดิม ทั้งจากรีเควสต์และจาก Active Job
  • ลงนามแชนเนล private และ 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 ให้ใส่ทุก origin ที่หน้าเว็บโหลดมาใน Origin ที่อนุญาตของแอป (http://localhost:3000 ระหว่างพัฒนา แล้วตามด้วยโดเมนของคุณ) ส่วน "*" ต้องใช้แพ็กเกจแบบชำระเงิน

ใช้ app key จากแดชบอร์ดของคุณ ส่วน secret ให้เก็บไว้บนเซิร์ฟเวอร์เท่านั้น ช่อง อีเวนต์ และ endpoint การยืนยันสิทธิ์ทำงานเหมือนกับที่ใช้กับ Pusher ทุกประการ สร้างบัญชีฟรีของคุณ →