Требования к интеграции

В этом разделе рассматривается интеграция между Playable и YouTube Playables SDK .

1. Загрузка SDK для воспроизведения

  • Перед запуском любого игрового кода игра ОБЯЗАТЕЛЬНО должна загрузить SDK YouTube Playables .

2 Уведомление о готовности игры

  • Игра ОБЯЗАТЕЛЬНО должна вызывать firstFrameReady либо при отрисовке экрана загрузки, либо при создании заставки, которая явно сообщает пользователю о начале процесса загрузки.
  • Игра ОБЯЗАТЕЛЬНО должна вызывать gameReady , и вызывать gameReady следует только тогда, когда игра готова к взаимодействию с пользователем (например, когда она находится в главном меню или готова к запуску).
  • Игра НЕ ДОЛЖНА вызывать gameReady пока пользователю отображаются неинтерактивные элементы (например, заставки или экраны загрузки).

YouTube не убирает индикатор загрузки до тех пор, пока не будет вызван этот API.

3 оценки пользователей

  • Игра МОЖЕТ использовать sendScore для отправки счета пользователя.
  • Если игра использует sendScore для отправки результатов, она ДОЛЖНА соответствовать спецификации sendScore и ДОЛЖНА гарантировать, что лучший отправленный результат совпадает с лучшим результатом в сохраненной игре.

4 облачных сохранения

  • Игра ОБЯЗАТЕЛЬНО должна вызывать saveData для сохранения прогресса, когда пользователь достиг существенного прогресса в игре (например, сменил уровень), и игровая механика заставляет пользователя поверить, что его прогресс сохранен.
  • Игра НЕ ДОЛЖНА использовать какие-либо другие механизмы для сохранения прогресса пользователя. Эта функция позволяет игрокам возобновить игру позже.
  • Игра ОБЯЗАТЕЛЬНО должна дождаться loadData прежде чем вызывать saveData . Если saveData будет вызвана до успешного завершения loadData , запрос будет отклонен. Это предотвратит перезапись ранее сохраненных данных.
  • Игра ДОЛЖНА уметь использовать облачные сохранения из предыдущих версий игры без ошибок и сбоев.
  • Игра ДОЛЖНА использовать облачные сохранения для поддержания прогресса пользователя во всех версиях игры, где пользователь ожидает использования своих данных.
  • Игры ДОЛЖНЫ автоматически сохранять прогресс пользователя на важных этапах, чтобы предотвратить потерю данных. Окончательное сохранение выполняется при выходе пользователя из игры, но это максимально возможное сохранение, которое может сохранить только контент размером до 64 КБ .

5 Переключатель отключения звука

  • Игра ОБЯЗАТЕЛЬНО должна учитывать системные настройки звука и кнопку отключения звука.
  • Игра ОБЯЗАТЕЛЬНО должна учитывать настройки звука YouTube и кнопку отключения звука, используя isAudioEnabled и onAudioEnabledChange .
  • Игра ОБЯЗАТЕЛЬНО должна учитывать регулировку громкости на устройстве.
  • Звук в игре НЕ ДОЛЖЕН воспроизводиться неожиданно.
  • При включенной функции отключения звука на YouTube воспроизведение звука ЗАПРЕЩЕНО , а настройки звука в игре ЗАПРЕЩЕНЫ на вывод звука.
  • Если функция отключения звука на YouTube не включена, элементы управления звуком в игре МОГУТ влиять на вывод звука.
  • В самой игре НЕ ДОЛЖНО быть кнопки отключения звука; позвольте пользователям полагаться на функции, аналогичные тем, что используются на YouTube.
  • В игре МОГУТ быть отдельные детализированные элементы управления звуком, например, для музыки и звуковых эффектов, но они ДОЛЖНЫ соответствовать всем остальным требованиям к управлению звуком.

Различные настройки звука для фоновой музыки, звуковых эффектов и диалогов.

6. Пауза и возобновление

Playables SDK предоставляет функции обратного вызова для кроссплатформенной паузы и возобновления воспроизведения.

  • Игра ДОЛЖНА приостанавливать все выполнение после вызова onPause и возобновлять выполнение только после вызова onResume . Выполнение включает в себя все игровые возможности, такие как игровой цикл, музыка, взаимодействия, сетевые вызовы и рендеринг.
  • Игра НЕ ДОЛЖНА использовать веб- API Page Visibility или аналогичные веб-API и ДОЛЖНА использовать только функции onPause и onResume из Playables SDK.
  • Игра ДОЛЖНА сохранять прогресс пользователя при включении onPause .