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

协商和会话生命周期

最后更新 查看 MarkdownAgent 设置

Realtime SFU 会话具有一个 WebRTC PeerConnection 和一个 offer/answer 状态机。Session Description Protocol(SDP)是描述连接媒体和传输设置的设置文本。它本身不承载媒体。

你的端点创建或应用 SDP。你的后端在端点与 SFU API 之间传递这些描述。

Offer 和 answer

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 的接收会话队列路由:

初始房间快照
参与者加入处理程序
A 的接收会话队列
Realtime SFU
订阅现有参与者
订阅 B
针对现有发布调用 tracks/new
需要应答的 offer
A 应用 offer 并创建 answer
使用 A 的 answer 调用 renegotiate
answer 已接受
针对 B 的发布调用 tracks/new
完成下一轮 offer/answer 交换

在创建 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 演练 ↗。

这篇文档对您有帮助吗?