集成要求

本部分涵盖了游戏大本营和 YouTube 之间的集成 游戏大本营 SDK。

1 加载游戏大本营 SDK

2 条游戏就绪通知

  • 当游戏呈现firstFrameReady 明确告知用户的加载屏幕或启动画面 加载进程正在进行中。
  • 游戏必须调用 gameReady，且必须仅在下列情况下调用 gameReady 游戏已准备好接受用户互动（例如：主菜单或游戏已准备就绪） 即可播放）。
  • 当仍有不可互动时，游戏不得调用 gameReady 元素（例如：启动画面或正在加载的内容） 屏幕）。

YouTube 不移除“正在加载”旋转图标直到调用此 API 为止。

3 用户得分

  • 游戏可以使用 sendScore 发送用户的得分。
  • 如果游戏使用 sendScore 发送得分，则游戏必须遵循 sendScore 规范，并且必须确保将最高得分 匹配游戏存档中的最高得分。

4 次云端存档

  • 游戏必须调用 saveData 以便在用户完成游戏后保存进度 实质游戏进度（例如关卡变化） 机制会让用户认为自己的进度已保存。
  • 游戏不得使用任何其他机制来保存用户进度。这个 功能可以让玩家稍后继续游戏。
  • 在调用 saveData 之前，游戏必须等待 loadData。如果 在 loadData 成功完成之前调用 saveData， 请求将会被拒绝。这样可以防止游戏覆盖任何 之前保存的数据。
  • 游戏必须能够使用来自旧版 确保游戏不会出现错误或崩溃
  • 游戏应使用云端存档数据来维护用户在所有游戏中的进度 用户希望使用其数据的游戏版本。
  • 游戏应自动保存用户在重要游戏中的进度 防止数据丢失当用户 会退出游戏，但尽力而为，只能节省最多 64 KiB 的内容 长度。

5 静音开关

  • 游戏必须遵循系统音频设置和静音按钮。
  • 游戏必须遵从 YouTube 音频设置和静音按钮，方法是使用 isAudioEnabled和onAudioEnabledChange。
  • 游戏必须遵从设备上的音量控制。
  • 不得意外播放游戏声音。
  • 设置 YouTube 静音后，不得输出音频和游戏音频 控件不得影响音频输出。
  • 如果未设置 YouTube 静音，游戏音频控件可以影响音频 输出。
  • 游戏不应在游戏本身中显示整体静音按钮； 让用户可以借助 YouTube 级别的功能实现这一目的。
  • 游戏可以在游戏中提供单独的精细音频控件，例如 音乐和音效，但必须遵循所有其他音频控制功能 要求。

针对背景、sfx、 对话框

6 暂停和继续

游戏大本营 SDK 提供了回调，可实现跨平台暂停和 简历功能。

  • 在调用 onPause 后，游戏必须暂停所有执行，并且必须 仅当调用 onResume 时继续执行。执行包括所有 可播放的功能，例如游戏循环、音乐、互动、网络 调用和呈现。
  • 游戏不得使用 Web Page Visibility API 或类似 Web API，并且 必须仅使用游戏大本营 SDK onPause 和 onResume。
  • 当 onPause 发生时，游戏应保存用户进度。