Realtime SFU 会话具有一个 WebRTC PeerConnection 和一个 offer/answer 状态机。Session Description Protocol(SDP)是描述连接媒体和传输设置的设置文本。它本身不承载媒体。
你的端点创建或应用 SDP。你的后端在端点与 SFU API 之间传递这些描述。
offer 提出连接设置,answer 完成该协商。端点可以发送描述其要发布轨道的 offer。SFU 返回供端点应用的 answer。
SFU 操作也可以返回端点必须应答的 offer。当响应将 requiresImmediateRenegotiation: true 设置为 true 时,请在该会话上开始另一次变更之前完成该交换。
应用 SFU offer,创建并设置端点的 answer,然后通过 PUT /sessions/{sessionId}/renegotiate 提交该 answer。有关确切序列,请参阅 完成 SFU offer。
在推进应用状态之前,检查响应和每个资源结果。仅 HTTP 200 响应并不能确定每个请求的资源都已成功。
序列化针对同一 SFU 会话的变更,包括轨道和 DataChannel 的创建、更新、关闭以及重新协商。不同会话上的独立操作可以并发运行。应用依赖关系仍然适用:另一个会话订阅之前,发布必须已经存在。
每次变更仅在其 API 请求和所需 SDP 交换成功后才完成。对于端点 offer,等待返回的 SFU answer 被应用。对于 SFU offer,等待端点的 answer 通过 /renegotiate 被接受。将 offer 返回给浏览器,或在浏览器中达到 signalingState: "stable",并不等于完成后端工作。
当一条执行路径拥有会话的所有变更,并且每次 await 的操作都包含完整交换时,顺序 await 调用就足够了。当事件处理程序、定时器或 UI 操作可能重叠时,请为每个会话使用一个共享队列。一个处理程序内的 await 并不能阻止另一个处理程序开始请求。
单独的发布和接收会话可以简化应用的所有权模型。当其所有变更共享同一队列时,单个双向会话也是有效的。
在会议应用中,参与者 B 可能在参与者 A 仍在加入时加入。A 的初始房间快照会触发对现有参与者的订阅,而 B 的加入通知会触发另一次订阅。两个处理程序都会更新 A 的接收会话。
如果处理程序独立提交请求,第二次 tracks/new 可能在第一次 offer/answer 交换完成之前到达。SFU 可以用 HTTP 406 拒绝冲突请求。406 也可能表示其他无效请求。诊断时请检查公共 errorCode、errorDescription 和端点状态。
将初始快照和后续参与者更新通过 A 的接收会话队列路由:
在创建 SDP 或发出其 API 请求之前,将订阅工作排队。运行时,将其与当前发布和连接进行协调。对重复的发布定位符去重,并丢弃不再需要的订阅。在 A 完成此交换期间,其他会话可以继续。
丢失的响应会使请求结果未知。在恢复期间暂停该会话上的后续变更。应用级重复检测并不能使 SFU 请求可以安全重复。
使用被中断的操作来选择下一步:
| 被中断的操作 | 下一步 |
|---|---|
sessions/new |
没有返回的 ID,就无法查找该分配。创建替换会话。另一次请求会创建另一个分配。 |
tracks/new |
在创建更多轨道之前检查分配。重复订阅可能分配重复项。如果 SDP 响应丢失,请替换连接。 |
datachannels/new |
通过会话检查恢复可见分配。空快照无法解决不确定请求。保留部分响应中的成功分配。 |
datachannels/establish |
完成传输的 SDP 交换。如果其响应丢失,请替换连接。重复 establish 不是状态检查。 |
/renegotiate |
第一次成功后,重复提交 answer 可能失败。如果接受结果仍未知,请替换连接。重试错误无法解决该不确定性。 |
强制媒体关闭或 datachannels/close |
按顺序重试已知未解决的 ID。处理每个结果,包括已经关闭的项目。 |
| 协商媒体关闭 | 如果可用,请应用原始 answer。否则,退役该连接并强制关闭其已知轨道。 |
会话检查可以恢复资源标识符,但不能恢复丢失的 SDP 或请求历史。correlationId 用于诊断标签。它不会恢复或去重会话。
为替换连接提供新的应用尝试 ID。在更新它时忽略旧响应,但保留它们返回的任何资源 ID 以供清理。使用新会话标识符重新发布并重建订阅。
停止接受新变更,并从发现中撤回已结束的发布。保留其资源 ID 以供清理。
在端点响应正常时,完成当前 API/SDP 交换,然后按顺序关闭轨道、通道以及端点的 PeerConnection。
如果端点无法应答,请退役该连接,强制关闭已知轨道,并关闭已知 DataChannels。强制关闭不会完成被放弃的 SDP 交换。不要在该连接上恢复排队工作。
超时的 API 请求仍可能完成。关闭已知轨道并不会取消它。保留迟到的分配以供清理。在受影响资源被核算并关闭之前,将所需清理保持为未解决。
视频房间协商队列 ↗会在浏览器 answer 期间保持会话操作打开。DataChannel 示例 ↗通过本地 Node.js 后端演示传输设置和拆卸。
对于原生端点,请遵循嵌入式固件/SFU 演练 ↗。