运行一个通过 Realtime SFU 发布摄像头和麦克风轨道的浏览器视频房间。打开第二名参与者以接收第一名参与者的媒体,并回传媒体。
本快速入门使用 Worker 做信令,使用 Durable Object 保存房间状态。SFU 凭据保留在后端。视频房间指南说明如何改造该应用。
若要构建会议应用,请从 RealtimeKit 开始,获取会议 SDK 和参与者管理。使用本示例学习如何直接基于 SFU 构建。
- 一个 Cloudflare 账户。
- Git、Node.js 22.12 或更高版本,以及包管理器。
- 可访问摄像头和麦克风的浏览器。在同一台电脑上测试音频时请使用耳机。
该示例为实验性内容。本地开发使用仅限 localhost 的身份机制。已部署房间需要 Cloudflare Access。
-
创建你的 SFU 应用。 在 Cloudflare 仪表板中,选择你的账户,然后前往 Realtime > Serverless SFU。
前往 Serverless SFU ↗创建一个应用并保存其 App ID 和 App Secret。你也可以通过 API 创建应用。需要隔离的环境请使用单独的应用。
-
克隆示例。 在终端中运行:
git clone https://github.com/cloudflare/realtime-examples.git cd realtime-examples/video-room安装依赖:
npm installyarn installpnpm installbun install -
配置后端。 创建会被忽略的本地 secrets 文件:
cp .dev.vars.example .dev.vars chmod 600 .dev.vars在
.dev.vars中,将REALTIME_SFU_APP_ID设为 App ID,将REALTIME_SFU_BEARER_TOKEN设为 App Secret。请将此文件保密。这些值由 Worker 读取,不会发送到浏览器。 -
启动应用。 运行:
npm run devyarn run devpnpm run dev打开
http://localhost:8787/rooms/two-browser-check。输入显示名称,加入房间,并允许摄像头和麦克风访问。 -
连接另一名参与者。 选择 Open another participant。在新标签页中用不同的显示名称加入。
请使用该操作,而不是浏览器的 Duplicate Tab,后者可能复制第一名参与者的身份。两名参与者都应显示本地和远程视频。确认远程音频可以播放。
每个浏览器把自己的摄像头和麦克风轨道发布到 Realtime SFU。Worker 和 Durable Object 把得到的发布标识符分享给另一名参与者。该浏览器订阅这些发布内容,SFU 再转发所选媒体。
后端协调房间并检查权限。媒体在每个浏览器与 SFU 之间直接传输。会话和轨道说明了这次交换背后的连接和标识符。
选择 Leave 移除一名参与者。房间创建者可以选择 Terminate room 为所有人结束房间。等待确认;失败的清理仍可重试。
完成后停止本地开发进程。不再需要本地凭据时删除 .dev.vars。仅在所有使用该专用 SFU 应用的应用都已停止后再删除它。
先阅读会话和轨道以理解 SFU 模型,再跟随连接模式构建端点。如果你已经了解 WebRTC,可以直接进入对应任务的配方。
要改造此应用,请跟随视频房间架构。它说明了独立的发布和接收会话、轨道发现以及协商队列。
要分享已部署房间,请遵循视频房间指南的部署说明。
探索更多应用
如果媒体未出现,请从故障排除开始。