本页提供了以下文档的修订历史记录:
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 集成
- 本地化
- 创收