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 访问。