本页面提供了以下文档的修订历史记录:
2024 年 7 月 11 日
- 将技术要求重构为多个页面。
- 要求清理和重复信息删除。
2024 年 6 月 24 日
将软件包总大小上限从 100 MiB 提高到了 250 MiB,并添加了延迟加载 指南。
2024 年 6 月 17 日
测试套件更新:
- 游戏不再需要通过 HTTPS 提供,并且可以通过 localhost 以进行测试。
- 在网址字段旁边添加了刷新按钮,用于刷新未使用 重新加载整个测试套件。
2024 年 5 月 16 日
将设计方面的最佳实践移到单独的文档中,以便更好地进行说明 设计要求和最佳实践之间的一致性。
2024 年 5 月 8 日
重构了游戏大本营开发者网站,以拓宽访问权限和改进体验 导航。
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 类型定义文件,以前在测试套件中提供 软件包已移至 Playables SDK 的主要文章中。
2023 年 9 月 7 日
更新了开始部分,以更改游戏大本营
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()
。
此外,还新增了文件引用部分,以要求 游戏在引用 bundle 中的其他文件时仅使用相对路径, 使用绝对路径可能会导致错误。
2023 年 8 月 2 日
技术要求和游戏大本营游戏设计中的“静音”部分 更新了准则部分,将静音和取消静音功能称为“音频” 控件并指明精细音频控件可能包含 音量滑块和/或静音开关。
2023 年 7 月 28 日
游戏大本营游戏设计指南文档已更新为 对措辞进行标准化,并更新最佳做法和屏幕截图。
2023 年 7 月 20 日
我们添加了暂停和恢复部分, 跨平台暂停和恢复功能。
2023 年 7 月 19 日
YouTube 游戏大本营网站现在添加了游戏大本营游戏设计准则 为开发者提供最佳游戏体验的指导, 在不同设备和平台上玩 YouTube 游戏的用户。
游戏设计指南侧重于以下几个方面:
- 缩略图图片
- 设备适配
- 界面 (UI)
- 手势和输入
- 暂停
- 静音
- 触感反馈
- 用户入门培训
- 游戏结束(胜出屏幕)
- 无障碍
此外,onAudioEnabledChange
部分已更新,修复了
代码出现小排版错误,导致 Flutter 的
提议的 JavaScript 互操作性 (JS-Interop) 层。
2023 年 7 月 14 日
尺寸部分已更新如下:
- 不再要求游戏必须能够在 Google Play 上 以及移动设备上的横向或纵向模式
- 添加了游戏必须可在竖屏模式下玩的功能。
- 添加了游戏应可横屏玩的功能。否则, 必须居中或包含邮筒模式。
- 添加了游戏不得锁定设备的屏幕方向。
2023 年 7 月 11 日
添加了 Flutter 网页(实验性)部分,以启用 与使用 Flutter Web 编写的游戏集成。
2023 年 7 月 1 日
静音切换部分要求游戏尊重音频 YouTube 和系统的设定以及游戏声音不得播放 。
此外,请参阅完成内容处理部分 说明了游戏必须告知用户 要与之互动的内容,例如在最后一关或游戏结束时。
2023 年 6 月 30 日
使用入门部分现在添加了一条备注,说明 SDK 将 在本地提供游戏时执行空操作。如需验证 SDK 集成的正确性, 请参阅 SDK 测试套件。
2023 年 6 月 2 日
YouTube 游戏大本营网站现在包含游戏大本营 SDK 文档, 提供了一组强大的 API 来支持 YouTube 游戏。
2023 年 5 月 26 日
技术要求文档更新如下:
部分 | 变更 |
---|---|
加载时间 | 其中包括全球 6.8Mbps 的平均网速, 美国。 |
互动方法 | 添加了以下内容:当用户与游戏互动时,游戏不得 无意中延迟或忽略输入。 |
缩略图 | 更新了 1:1、5:7 和 16:9 所需的图片分辨率 宽高比。 |
发布商或开发者信息 | 添加了这个新部分,要求游戏必须包含 发布商或开发者,而且可能还需要提供内容分级 。 |
加载游戏大本营 SDK | 添加了这个新部分,要求游戏加载游戏大本营 SDK 放在任何其他游戏代码之前。 |
游戏准备就绪通知 | 更新为仅在firstFrameReady
就可以在屏幕上呈现游戏的第一帧
在游戏面向任何用户开放时调用 gameReady API
互动 |
静音开关 | 添加了以下内容:设置 YouTube 静音后,不得输出音频 以及游戏的静音或取消静音控件不得影响音频输出。 |
2023 年 3 月 24 日
YouTube 游戏大本营网站现在包含技术要求 旨在为用户提供流畅的游戏体验的文档 在 YouTube 上玩游戏
“技术要求”部分侧重于以下几个方面:
- 游戏稳定性
- YouTube 体验
- YouTube 集成
- 本地化
- 创收