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

云游戏

最后更新 查看 MarkdownAgent 设置

在 Cloudflare Container 中运行 Freedoom,通过 Realtime SFU 推送其音频和视频,并经 DataChannels 回传浏览器输入。多个观众可以观看,由一个浏览器标签页控制游戏。

这个实验性示例演示了原生发布端和浏览器接收端。同一套媒体与控制拓扑也可用于远程应用和设备界面。

打开示例

工作原理

Container 采集 H.264 视频和 Opus 音频。其原生发布端通过 WebRTC 连接将两条轨道发送到 Realtime SFU。每个浏览器使用一个 SFU 会话和 PeerConnection 来接收媒体和输入 DataChannels。

应用边界
浏览器标签页
Worker
游戏状态
Realtime SFU
容器发布端
Access identity + per-tab capability · One SFU session and PeerConnection per browser tab
应用请求
类型化 RPC
启动或停止
注册发布端
创建 SFU 资源
发布 H.264 + Opus
发布两个输入通道
订阅媒体和通道
启用控制器回复
可靠通道:键盘 + 按键
可替换通道:指针移动
转发控制器输入

Worker 负责认证浏览器请求并持有 SFU 凭据。Durable Object 拥有游戏运行、观众成员、控制者选择和资源清理。Container 的发布端与浏览器通过 SFU 交换媒体和输入。

要求

  • 已开通 Workers Paid 和 Containers 的 Cloudflare 账户。
  • Node.js 22.12 或更高版本,以及 Docker 或兼容的容器引擎。
  • SFU App ID 和 App Secret。
  • 支持键盘和指针锁定的桌面浏览器。
  • 已部署应用需使用 Cloudflare Access。

运行并验证

  1. 准备示例。 运行:

    git clone https://github.com/cloudflare/realtime-examples.git
    cd realtime-examples/cloud-gaming
    npm install

    创建会被忽略的配置文件:

    cp .dev.vars.example .dev.vars
    chmod 600 .dev.vars

    将 REALTIME_SFU_APP_ID 和 REALTIME_SFU_BEARER_TOKEN 设为你的 SFU 应用值。

  2. 启动应用。 在容器引擎运行的情况下,启动开发环境:

    npm run dev

    打开 http://localhost:8787/。本地身份路径仅在 loopback 主机上可用。

  3. 启动游戏。 选择 Start,等待变为 Running。再打开第二个浏览器标签页,确认两个标签页都能收到视频和音频。

  4. 取得控制权。 在一个标签页中选择 Take control。控制就绪后,选择游戏以捕获指针,然后使用键盘和鼠标。另一个标签页应保持仅观看。

    使用 Send Esc 打开游戏菜单。浏览器的 Escape 操作会释放指针锁定。选择 Release control 以便其他标签页取得控制权。

部署请遵循示例的部署说明 ↗。它们会把 SFU 值安装为 Worker secrets,并配置 Access 团队域名和 audience。在邀请观众之前,用匹配的 Access 策略保护该主机名。

为输入选择投递设置

该示例为离散操作和可替换输入使用了独立的具名通道:

输入 投递 原因
键盘、按钮、滚轮和重置 可靠且有序 保留离散操作及其顺序
指针移动 无序,maxRetransmits: 0 新的移动会替换更旧的移动

发布端为每个通道选择策略,每个订阅者都镜像该策略。每个浏览器使用匹配的投递设置及其自己分配的通道 ID。参见 DataChannel 投递设置。

控制权归属

观众最初以 canReply: false 订阅,并用 waitForAck 确认通道就绪。后端通过更新所选观众的现有订阅来授予回复权限。

应用用 generation 标识每次控制者选择。浏览器仅在发布端确认其观众和 generation 之后才发送输入。当控制权变更、指针锁定丢失或本次运行结束时,应用会释放已按住的输入。

canReply 限制的是 SFU 回传路径。后端仍会认证并授权操作者。参见回复权限以及示例的架构 ↗。

停止并清理

选择 Stop game,并在删除部署前等待变为 Offline。应用会停止 Container,并关闭已知的 SFU 轨道和 DataChannels。按照清理说明 ↗移除 Worker 和 Access 应用。

媒体流水线失败会结束本次运行;未实现透明的发布端重启。

改造示例

该示例实现了一个固定游戏槽位和一名控制者。准入限制、速率限制和 Access 策略配置属于部署职责。

对于共享 CAD 查看器或仿真,替换 Freedoom,并改造应用启动、采集和输入处理。保留观众授权、控制权归属和清理。再添加应用所需的文件所有权与保存/导出行为。需要补充的应用策略和控制见生产集成 ↗。

查看实现

查看示例的输入通道定义 ↗,比较可靠控制与瞬时指针移动。

故障排除

使用故障排除指南 ↗诊断 Container 启动、媒体和控制失败。

尝试另一个示例

Pocket Radio 在嵌入式硬件上应用了相关的观察者/控制者模式。

这篇文档对您有帮助吗?