跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

最佳实践

最后更新 查看 MarkdownAgent 设置

你的应用拥有 SFU 媒体传输周围的身份、状态和生命周期。在适配示例时请保持这些边界。

将凭据保留在后端

将 SFU App Secret 存储在受信任的服务器基础设施上。在 Workers 中,使用 Worker secret。浏览器和设备使用限定于其自身职责范围的凭据向你的应用后端进行身份验证。

通过经过验证的输入公开应用操作。避免使用不受限制的 SFU 代理,以免浏览器选择任意会话、发布或破坏性操作。

WebSocket 端点凭据与 SFU App Secret 是分开的。将两者都排除在公共资源、发送给观众的 URL 以及日志之外。

授权资源操作

在创建、发布、订阅、更新权限或关闭资源之前,检查身份和资源所有权。房间名称、会话 ID、轨道名称或适配器 ID 是定位符,而不是权限证明。

操作员角色也需要应用授权。对于设备控制,后端可以分配短期控制器租约,并仅向该选择授予 canReply。在应用中处理租约过期和已撤销的访问,而不仅仅是在浏览器 UI 中处理。

协调协商

遵循按会话的变更排序。保留在未完成交换期间到达的工作,并在推进应用状态之前检查每项结果。

显式定义恢复

决定应用在替换媒体连接时是否保持其身份。为每次连接尝试提供 ID,以便旧响应无法更改替换会话。遵循替换连接序列。

让重新连接对用户可见,限制重试次数,并在自动尝试失败时提供恢复操作。正确选择取决于应用:房间可以重建订阅,而设备监听者可能需要显式重新加入。

对于 WebSocket 适配器,在终端关闭后实现重建,并尊重摄取与流式传输重新连接行为的差异。

保留清理状态

从发现中移除不可用或未授权的发布。在所需清理完成之前,私下保留其资源标识符。检查单独的关闭结果,并保留未解决的项目以供重试。

决定替换是否可以在旧资源仍存在时继续。从应用状态中丢弃过时连接并不会停止 SFU 转发。当你需要停止访问时,关闭受影响的 SFU 资源并确认结果。

对已放弃的客户端使用显式离开/停止操作和应用过期。浏览器标签页可能在未发送清理的情况下关闭。在仍需运行重试时,保持后端可用。

设置应用层限制

根据你的应用设置准入限制、操作速率和资源生命周期。示例中的房间大小或控制器策略是应用决策。有关产品约束,请参阅 SFU 限制。

使用可观测性将 API 结果、端点状态和媒体交付关联起来。在成功流程之外,一并验证授权和失败路径。

通过示例学习

视频房间生产指南 ↗说明身份和房间授权。云游戏架构 ↗展示控制器世代和输入释放。Pocket Radio 的架构 ↗说明设备凭据、监听者成员资格和控制器租约。

这篇文档对您有帮助吗?