本页面提供了以下文档的修订历史记录：
2026 年 10 月 16 日
- 更新了创收要求，指出不遵守这些要求可能会导致创收功能被停用，并添加了有关真实货币奖励（第 1 节）、激励广告（第 2.1 节）、插页式广告（第 2.2 节）和适合投放广告的内容（第 4 节）的要求。
2026 年 8 月 25 日
- 更新了信任与安全要求，添加了重复内容政策（第 2.2 节），要求提供原创、经授权或经许可的内容，并禁止重复的游戏 build。
2026 年 8 月 24 日
- 添加了游戏无障碍标签（第 2 节和第 2.1 节），涵盖无障碍游戏计划 (AGI) 玩家发现和开发者元数据准确性。
2024 年 7 月 11 日
- 将技术要求重构为多个页面。
- 要求清理和去重。
2024 年 6 月 24 日
将总 bundle 大小上限从 100 MiB 提高到 250 MiB，并添加了延迟加载指南。
2024 年 6 月 17 日
测试套件更新：
- 游戏不再需要通过 HTTPS 提供，可以从 localhost 提供以进行测试。
- 在网址字段旁边添加了“刷新”按钮，用于刷新 iframe 的内容，而无需重新加载整个测试套件。
2024 年 5 月 16 日
将设计最佳实践移至单独的文档，以便更好地划分设计要求和最佳实践。
2024 年 5 月 8 日
重构了 Playables 开发者网站，以扩大访问范围并改进导航。
2024 年 5 月 7 日
更新了游戏就绪通知的技术要求，添加了有关 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 类型定义文件之前位于 Test Suite 软件包中，现已移至 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 日
新增了文件名部分，其中包含游戏 bundle 中文件命名的字符数限制。
2023 年 8 月 10 日
互动方法部分已更新，要求游戏的所有界面组件均按预期运行，且不会出现错误或意外行为。
2023 年 8 月 9 日
新增了缩略图部分，其中列出了游戏的缩略图要求，以便用户在 YouTube 中轻松发现和识别 Playable。
2023 年 8 月 8 日
手势和输入部分已更新，禁止游戏在 Esc 事件中调用 preventDefault()。
此外，我们还新增了文件引用部分，要求游戏在引用 bundle 中的其他文件时只能使用相对路径，因为使用绝对路径可能会导致错误。
2023 年 8 月 2 日
技术要求和游戏大本营游戏设计指南的“静音”部分均已更新，将静音和取消静音功能称为音频控件，并指明精细音频控件可能包含音量滑块或静音切换开关，或两者兼有。
2023 年 7 月 28 日
Playables 游戏设计指南文档已更新，以规范用语并更新最佳实践和屏幕截图。
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 SDK 文档，其中提供了一组强大的 API 来支持 YouTube 游戏。
2023 年 5 月 26 日
技术要求文档更新如下：
| 部分 | 变更 |
|---|---|
| 加载时间 | 包括全球平均网速 6.8Mbps 和美国平均网速 20Mbps。 |
| 互动方式 | 添加了以下要求：当用户与游戏互动时，游戏不得无意中延迟或忽略输入。 |
| 缩略图 | 更新了 1:1、5:7 和 16:9 比例所需的图片分辨率。 |
| 发布商或开发者信息 | 添加了这一新部分，要求游戏包含发布商或开发者的名称，并且未来可能还需要提供内容分级。 |
| 加载 Playables SDK | 添加了这一新部分，要求游戏在加载任何其他游戏代码之前先加载 Playables SDK。 |
| 游戏就绪通知 | 更新为仅在游戏的第一帧准备好在屏幕上呈现时调用 firstFrameReady API，并且仅在游戏准备好接受任何用户互动时调用 gameReady API。 |
| 静音切换开关 | 添加了以下要求：设置 YouTube 静音后，不得输出音频，并且游戏的静音或取消静音控件不得影响音频输出。 |
2023 年 3 月 24 日
YouTube 游戏大本营网站现在包含技术要求文档，旨在为在 YouTube 上玩游戏的用户提供流畅的游戏体验。
技术要求部分重点关注以下方面：
- 游戏稳定性
- YouTube 体验
- YouTube 集成
- 本地化
- 创收