应用对你的 SFU 资源进行分组。会话表示 WebRTC 连接。媒体轨道承载音频或视频,DataChannels 承载应用消息。
SFU 应用具有 App ID 和 App Secret。其会话可以在该应用内发布和订阅资源。为开发、预发布或其他需要隔离的环境使用单独的应用。
你的后端使用 App Secret 授权 SFU API 调用。你应用自己的身份验证和权限检查决定哪些终端用户可以请求这些调用。
会话表示一个端点与 SFU 的 WebRTC 连接。在浏览器中,RTCPeerConnection 对象管理该连接。原生应用在其 WebRTC 库中使用等效的 peer。一个连接可以发送和接收多条媒体轨道和 DataChannels。
参与者不必恰好对应一个会话。视频房间示例使用单独的发布和接收会话。云游戏为每个浏览器使用一个会话,用于传入媒体和传出控制。
在没有请求正文的情况下调用 POST /sessions/new 会返回 sessionId,但不会建立 WebRTC 连接。请遵循连接配方完成 offer/answer 交换,然后等待端点的连接状态变为 connected。
端点准备好进行协商时,创建会话。如果设置失败或 PeerConnection 关闭,请创建新会话并重新执行连接设置。
在设置和后续更新期间,请遵循按会话的变更排序。
媒体轨道承载音频或视频。发布将该媒体发送到 SFU。订阅请求另一端点发布的副本。浏览器提供 MediaStreamTrack,而原生端点通过其 WebRTC 实现提供相应的已编码媒体。
要发布轨道,请使用 location: "local" 调用 tracks/new,并为该发布指定 trackName。要订阅,请在接收会话上使用 location: "remote"、发布者的 sessionId 以及相同的 trackName 调用 tracks/new。
主要标识符具有不同用途:
| 标识符 | 用途 |
|---|---|
appId |
选择 SFU 应用 |
sessionId |
在 URL 中选择目标会话。在远程轨道条目中,标识发布者 |
trackName |
在其发布会话内为该发布命名 |
mid |
在特定 PeerConnection 的会话描述中标识媒体部分/收发器 |
| 应用成员或设备 ID | 在你自己的状态和权限模型中标识实体 |
使用发布者的会话 ID 与轨道名称一起定位远程媒体。轨道的 mid 属于其连接。订阅者可以在不同的 mid 上接收该发布。
你的应用维护可用发布的列表,并将其与授权订阅者共享。每个订阅者选择要请求的轨道。
对于房间,该状态可能包含成员及其摄像头/麦克风发布。对于设备,它可能包含其活动发布者会话和遥测通道名称。在发布结束或会话被替换时,保持发现状态最新。
成功的 HTTP 响应可能包含个别轨道的错误。在将发布或订阅记录为就绪之前,请检查每个结果。
DataChannels 承载遥测、文本和控制事件等应用消息。它们具有协商的通道 ID 和交付设置,并使用单独的 DataChannel API 操作。它们不是浏览器 MediaStreamTrack 对象。
当你的应用停止提供某项发布时,将其从发现中移除。这不会关闭现有订阅。在清理仍未完成时,私下保留其 SFU 标识符。
当资源不再需要时,请遵循媒体关闭序列或 DataChannel 关闭。有关过期和复用,请参阅限制;有关清理所有权,请参阅最佳实践。