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

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

1 Загрузка SDK Playables

  • Игра ДОЛЖНА загружать 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 . Исполнение включает в себя все возможности Playable, такие как игровой цикл, музыку, взаимодействия, сетевые вызовы и рендеринг.
  • Игра НЕ ДОЛЖНА использовать API видимости веб-страниц или аналогичные веб-API и ДОЛЖНА использовать только Playables SDK onPause и onResume .
  • Игра ДОЛЖНА сохранять прогресс пользователя при возникновении onPause .