rivetkit-client-react

rivetkit-client-react 技能為將 Rivet Actors 整合至 React 應用程式提供標準化的指導與模式。它專為開發協作環境、即時儀表板或需要持久性、有狀態 Actor 通訊的多人遊戲介面的前端開發人員而設計。透過使用 @rivetkit/react 套件，開發人員可以以最少的樣板代碼維持 UI 狀態與伺服器端 Actor 狀態之間的即時同步。

• 使用 createRivetKit 工廠函數簡化 React 整合，初始化客戶端實例並為子組件提供上下文。

• 透過 useActor Hook 簡化 Actor 生命週期管理與連接狀態追蹤，該 Hook 可處理自動 WebSocket 連接與事件訂閱。

• 支援複合 Actor 鍵值與層次化定址，確保複雜多租戶應用程式的穩健路由。

• 支援反應式事件處理，允許 UI 組件高效訂閱特定的 Actor 廣播與觸發器。

• 提供連接參數、驗證令牌與生命週期狀態監控的內建支援，用於建構穩健的錯誤處理與連接狀態 UI。

• 提供 React Hook 用於有狀態互動，並能與底層的 JavaScript 客戶端無縫互操作，處理一次性的 HTTP/WebSocket 請求。

• 在組件樹的最上層使用 createRivetKit 注入配置，避免重複初始化。

• 針對持久性連接優先使用 useActor Hook；對於一次性的 SSR 請求或工具函數，請使用 rivetkit/client 中的標準 createClient。

• 實作快速失敗 (fail-fast) 的錯誤處理，透過檢查 Hook 回傳的 connStatus 與 error 屬性，而非將邏輯包裹在複雜的 try/catch 區塊中。

• 使用陣列來定義 Actor 鍵值，以防止鍵值注入攻擊，特別是當鍵值來自使用者輸入的資料時。

• 整合 RIVET_ENDPOINT 與 RIVET_NAMESPACE 等環境變數，以管理開發、預發布與正式環境中的配置。

• 確保後端配置了適當的存取控制，因為此技能著重於 React 前端實現授權的 Actor 存取。