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

快速入门

最后更新 查看 MarkdownAgent 设置

运行一个通过 Realtime SFU 发布摄像头和麦克风轨道的浏览器视频房间。打开第二名参与者以接收第一名参与者的媒体,并回传媒体。

本快速入门使用 Worker 做信令,使用 Durable Object 保存房间状态。SFU 凭据保留在后端。视频房间指南说明如何改造该应用。

若要构建会议应用,请从 RealtimeKit 开始,获取会议 SDK 和参与者管理。使用本示例学习如何直接基于 SFU 构建。

前提条件

  • 一个 Cloudflare 账户。
  • Git、Node.js 22.12 或更高版本,以及包管理器。
  • 可访问摄像头和麦克风的浏览器。在同一台电脑上测试音频时请使用耳机。

该示例为实验性内容。本地开发使用仅限 localhost 的身份机制。已部署房间需要 Cloudflare Access。

运行视频房间

  1. 创建你的 SFU 应用。 在 Cloudflare 仪表板中,选择你的账户,然后前往 Realtime > Serverless SFU。

    前往 Serverless SFU ↗

    创建一个应用并保存其 App ID 和 App Secret。你也可以通过 API 创建应用。需要隔离的环境请使用单独的应用。

  2. 克隆示例。 在终端中运行:

    git clone https://github.com/cloudflare/realtime-examples.git
    cd realtime-examples/video-room

    安装依赖:

    npm install
  3. 配置后端。 创建会被忽略的本地 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 读取,不会发送到浏览器。

  4. 启动应用。 运行:

    npm run dev

    打开 http://localhost:8787/rooms/two-browser-check。输入显示名称,加入房间,并允许摄像头和麦克风访问。

  5. 连接另一名参与者。 选择 Open another participant。在新标签页中用不同的显示名称加入。

    请使用该操作,而不是浏览器的 Duplicate Tab,后者可能复制第一名参与者的身份。两名参与者都应显示本地和远程视频。确认远程音频可以播放。

连接如何工作

每个浏览器把自己的摄像头和麦克风轨道发布到 Realtime SFU。Worker 和 Durable Object 把得到的发布标识符分享给另一名参与者。该浏览器订阅这些发布内容,SFU 再转发所选媒体。

后端协调房间并检查权限。媒体在每个浏览器与 SFU 之间直接传输。会话和轨道说明了这次交换背后的连接和标识符。

清理

选择 Leave 移除一名参与者。房间创建者可以选择 Terminate room 为所有人结束房间。等待确认;失败的清理仍可重试。

完成后停止本地开发进程。不再需要本地凭据时删除 .dev.vars。仅在所有使用该专用 SFU 应用的应用都已停止后再删除它。

后续步骤

先阅读会话和轨道以理解 SFU 模型,再跟随连接模式构建端点。如果你已经了解 WebRTC,可以直接进入对应任务的配方。

要改造此应用,请跟随视频房间架构。它说明了独立的发布和接收会话、轨道发现以及协商队列。

要分享已部署房间,请遵循视频房间指南的部署说明。

探索更多应用

如果媒体未出现,请从故障排除开始。

这篇文档对您有帮助吗?