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

应用架构

最后更新 查看 MarkdownAgent 设置

Realtime SFU 在端点之间转发媒体轨道和 DataChannels。你的应用提供这些连接周围的信令、状态和权限。

端点可以是浏览器、嵌入式设备、原生进程或带有 WebRTC 实现的服务器。端点可以发布媒体、订阅媒体,或两者都做。

媒体和信令

媒体和 DataChannels 通过 WebRTC 在端点与 SFU 之间流动。信令通过你的后端交换设置信息,包括 SDP offer 和 answer。

你的后端协调端点可以发送或接收哪些发布。SFU 承载所选媒体:

发布端
应用后端
Realtime SFU
接收端
身份验证并请求发布
建立发布会话和轨道
完成连接建立
WebRTC 媒体
共享已授权的发布标识符
请求这些发布
建立接收会话和订阅
完成连接建立
转发所选媒体

连接模式指南给出完整的媒体和 DataChannel 设置序列。后端可以使用 HTTPS、WebSockets 或其他应用协议与端点通信。其对 SFU 的 API 调用使用 HTTPS。Workers 是一种后端选项;容器和传统服务器使用相同的接口。

WebSocket 媒体适配器连接通过 WebSockets 交换媒体、而不是实现 WebRTC 的外部服务。

托管 SFU 基础设施

使用 Realtime SFU 时,你的应用无需部署 SFU 服务器或选择 SFU 区域。它通过 HTTPS API 创建连接,并通过发布者会话 ID 和轨道名称标识远程发布。

Cloudflare 运营 SFU 基础设施。你的应用仍需提供信令后端、身份、发现和权限。房间、广播或设备组是应用状态;Connection API 暴露会话和发布,供你组合成该拓扑。

职责

每一层拥有应用的不同部分:

层 职责
端点 捕获或生成媒体、拥有 PeerConnections、应用会话描述,并呈现连接状态
应用后端 对用户和设备进行身份验证、授权操作、持有 SFU 凭据,并调用 SFU API
应用状态 跟踪成员资格、已发布媒体、订阅、操作员角色和资源清理
Realtime SFU 建立 WebRTC 会话,并转发你的应用选择的媒体轨道和 DataChannels

房间、参与者、机器人名称和控制器角色是应用概念。例如,Durable Object 可以保存一个房间的成员资格或一台设备的控制器租约。另一个后端可以使用自己的服务存储相同状态。

选择拓扑

发布和订阅操作支持多种应用形态:

应用 发布和订阅模式
视频房间 参与者发布自己的媒体并订阅其他参与者
广播 一个发布者发送轨道,多个观众订阅
设备监控 设备发布媒体和遥测;授权操作员可以用控制进行回复
云游戏 原生进程发布音频/视频;观众接收媒体,一名观众发送输入
AI 音频 WebSocket 适配器在 WebRTC 端点与音频处理服务之间移动媒体

端点可以使用一个双向会话,或使用单独的发布和接收会话。每个会话有一个 PeerConnection 和一个协商状态机。在跨并发操作共享会话之前,请参阅协商。

凭据和发现

通过仪表板或 API 创建 SFU 应用。将其 App Secret 保留在受信任的后端基础设施上。在 Workers 中,将应用值存储为 Worker secrets。

端点使用你应用的身份机制向后端进行身份验证。后端在发出 SFU 请求之前检查它可以访问哪些资源。房间名称、会话 ID 或轨道名称不能确立权限。

发布后,你的应用将发布者的会话 ID 和轨道名称分发给授权订阅者。SFU 不提供房间在线状态协议。有关标识符所有权,请参阅会话和轨道。

通过示例学习

视频房间使用 Worker 和每个房间一个 Durable Object 进行成员资格和轨道发现。Pocket Radio 将相同的分离应用于设备、浏览器监听者和独占控制器。

浏览 SFU 网络可视化 ↗,了解端点连接和媒体路由的示意。

这篇文档对您有帮助吗?