修订历史记录

本页提供了以下文档的修订历史记录:

2026 年 8 月 25 日

  • 更新了信任与安全要求,添加了重复内容政策(第 2.2 条),要求内容为原创、已获授权或已获许可,并禁止重复的游戏 build。

2026 年 8 月 24 日

  • 添加了游戏无障碍功能标记(第 2 部分和第 2.1 部分),涵盖了无障碍游戏计划 (AGI) 玩家发现和开发者元数据准确性。

2024 年 7 月 11 日

  • 将技术要求重构为多个页面。
  • 清理和去重需求。

2024 年 6 月 24 日

将总软件包大小限制从 100 MiB 提高到 250 MiB,并添加了延迟加载指南。

2024 年 6 月 17 日

测试套件更新:

  • 游戏不再需要通过 HTTPS 提供,并且可以从 localhost 提供以进行测试。
  • 在网址字段旁边添加了刷新按钮,用于刷新 iframe 的内容,而无需重新加载整个测试套件。

2024 年 5 月 16 日

将设计最佳实践移至单独的文档中,以便更好地区分设计要求和最佳实践。

2024 年 5 月 8 日

重构了 Playables 开发者网站,以扩大访问范围并改进导航。

2024 年 5 月 7 日

更新了 Game Ready Notification技术要求,并添加了有关 firstFrameReady 调用的更多详细信息。

2024 年 5 月 3 日

  • 创建了之前版本的要求归档。

2024 年 3 月 5 日

将单个文件的大小上限从 10 MiB 提高到 30 MiB。

2024 年 2 月 23 日

向顶级命名空间添加了 IN_PLAYABLES_ENV 布尔值,用于告知开发者其游戏何时在游戏大本营环境中运行。

2023 年 12 月 4 日

测试套件更新

  • 添加了对文件名中不受支持的字符的检查。
    • 如需了解支持的字符,请参阅技术要求 - 1.9 文件名
    • 已知限制:此检查可能无法验证所有已加载的资源。
  • 添加了用于模拟加载屏幕的功能,包括将初始 iframe 高度设置为 0。
  • 更新了暂停/恢复按钮,在暂停和恢复时切换音频,以更贴近实际效果。
  • 从事件日志记录中移除了不可操作的消息。

2023 年 11 月 10 日

可下载的测试套件软件包已替换为托管的测试套件

之前在测试套件软件包中提供的 TypeScript 类型定义文件已移至主要的 Playables SDK 文章中。

2023 年 9 月 7 日

使用入门部分已更新,将 Playables SDK 网址从 v0 更改为 v1

2023 年 8 月 30 日

我们更新了文件名缩略图部分,移除了对明确列出允许的特殊字符(_-.)的引用。

此外,我们还更新了云端存档部分,要求云端存档在新游戏版本中正常运行。

2023 年 8 月 25 日

更新了 saveData 部分,明确指出保存的数据必须是有效且格式正确的 UTF-16 字符串。

2023 年 8 月 18 日

更新了暂停和恢复部分,明确指出游戏必须在调用 onPause 后暂停所有执行,并且仅在调用 onResume 后才能恢复。

2023 年 8 月 11 日

添加了文件名部分,其中包含用于命名游戏包中文件的字符限制。

2023 年 8 月 10 日

更新了互动方法部分,要求游戏的所有界面组件都能按预期运行,且不会出现错误或意外行为。

2023 年 8 月 9 日

我们添加了缩略图部分,其中列出了游戏缩略图的要求,以便用户轻松发现和识别 YouTube 中的可畅玩游戏。

2023 年 8 月 8 日

更新了手势和输入部分,以禁止游戏在 Esc 事件上调用 preventDefault()

此外,还添加了新的文件引用部分,要求游戏在引用软件包中的其他文件时仅使用相对路径,因为使用绝对路径可能会导致错误。

2023 年 8 月 2 日

技术要求可玩广告游戏设计指南的“静音”部分已更新,将静音和取消静音功能称为音频控件,并指出精细音频控件可能包含音量滑块、静音切换开关或两者兼有。

2023 年 7 月 28 日

我们更新了可玩广告游戏设计指南文档,以规范措辞并更新最佳实践和屏幕截图。

2023 年 7 月 20 日

添加了暂停和恢复部分,以提供跨平台暂停和恢复功能。

2023 年 7 月 19 日

YouTube Playables 网站现在包含 Playables 游戏设计指南文档,可作为指南帮助您为在不同设备和平台上玩 YouTube 游戏的玩家提供最佳游戏体验。

游戏设计指南重点关注以下方面:

  • 缩略图
  • 设备适配
  • 界面 (UI)
  • 手势和输入
  • 暂停
  • 静音
  • 触感反馈
  • 用户初始配置
  • 游戏结束(获胜界面)
  • 无障碍

此外,我们还更新了 onAudioEnabledChange 部分,以修正代码中的一处小小的拼写错误,该错误导致 Flutter 提议的 JavaScript 互操作性 (JS-Interop) 层出现错误。

2023 年 7 月 14 日

大小部分已更新如下:

  • 移除了以下要求:游戏必须可在桌面设备上全屏运行,并且可在移动设备上以横屏或竖屏模式运行。
  • 添加了游戏必须支持竖屏模式。
  • 添加了游戏应支持横屏模式。否则,游戏必须居中显示或必须包含竖条。
  • 添加了游戏不得锁定设备屏幕方向的要求。

2023 年 7 月 11 日

添加了 Flutter Web(实验性)部分,以实现与使用 Flutter Web 编写的游戏的集成。

2023 年 7 月 1 日

静音切换开关部分要求游戏遵守 YouTube 和系统的音频设置,并且游戏声音不得意外播放。

此外,完成内容处理部分明确指出,游戏必须告知用户没有更多内容可供互动,例如在最后一关或游戏完成时。

2023 年 6 月 30 日

使用入门部分现在包含一条注释,说明当游戏在本地提供时,SDK 将不执行任何操作。如需验证 SDK 集成是否正确,请参阅 SDK 测试套件

2023 年 6 月 2 日

YouTube Playables 网站现在包含 Playables SDK 文档,其中提供了一组强大的 API 来支持 YouTube 游戏。

2023 年 5 月 26 日

技术要求文档更新如下:

部分 变更
加载时间 包括全球平均网速 6.8 Mbps 和美国平均网速 20 Mbps。
互动方法 添加了以下内容:当用户与游戏互动时,游戏不得无意中延迟或忽略输入。
缩略图 更新了 1:1、5:7 和 16:9 宽高比所需的图片分辨率。
发布商或开发者信息 添加了此新部分,要求游戏包含发行商或开发者的名称,并且未来可能还需要提供内容分级。
加载 Playables SDK 添加了此新部分,要求游戏在任何其他游戏代码之前加载 Playables SDK。
“游戏就绪”通知 更新为仅当游戏的第一帧准备好在屏幕上呈现时才调用 firstFrameReady API,并且仅当游戏准备好接受任何用户互动时才调用 gameReady API。
静音切换开关 添加了以下内容:当 YouTube 静音时,不得输出音频,并且游戏的静音或取消静音控件不得影响音频输出。

2023 年 3 月 24 日

YouTube 游戏大本营网站现已添加技术要求文档,旨在为在 YouTube 上玩游戏的用户提供顺畅的游戏体验。

技术要求部分重点关注以下方面:

  • 游戏稳定性
  • YouTube 体验
  • YouTube 集成
  • 本地化
  • 创收