История изменений

На этой странице представлена ​​история изменений для следующих документов:

11 июля 2024 г.

  • Технические требования переработаны на несколько страниц.
  • Очистка требований и дедупликация.

24 июня 2024 г.

Увеличен общий лимит размера пакета со 100 МБ до 250 МБ и добавлено руководство по отложенной загрузке.

17 июня 2024 г.

Обновления тестового набора:

  • Игры больше не нужно обслуживать через HTTPS, их можно обслуживать с локального хоста для тестирования.
  • Рядом с полем URL-адреса добавлена ​​кнопка «Обновить», позволяющая обновить содержимое iframe без перезагрузки всего набора тестов.

16 мая 2024 г.

Переместите рекомендации по проектированию в отдельный документ, чтобы лучше разграничить требования к проектированию и рекомендации.

08 мая 2024 г.

Сайт разработчика Playables был реорганизован для расширения доступа и улучшения навигации.

07 мая 2024 г.

Обновлены технические требования к уведомлению о готовности игры , добавлены дополнительные сведения о вызове firstFrameReady .

3 мая 2024 г.

  • Создан архив предыдущих версий требований.

05 марта 2024 г.

Увеличен лимит размера отдельного файла с 10 МБ до 30 МБ.

23 февраля 2024 г.

В пространство имен верхнего уровня добавлено логическое значение IN_PLAYABLES_ENV , чтобы сообщать разработчикам, когда их игра работает в среде Playables.

04 декабря 2023 г.

Обновления тестового набора

  • Добавлена ​​проверка неподдерживаемых символов в именах файлов.
  • Добавлена ​​функция имитации экрана загрузки, включая установку начальной высоты iframe на 0.
  • Обновлена ​​кнопка паузы-возобновления, чтобы она более точно соответствовала производству за счет переключения звука при приостановке и возобновлении.
  • Из журнала событий удалены сообщения, не требующие действий.

10 ноября 2023 г.

Загружаемый пакет Test Suite был заменен размещенным пакетом Test Suite .

Файл определений типов TypeScript, ранее доступный в комплекте Test Suite, был перемещен в основную статью Playables SDK .

07 сентября 2023 г.

Раздел «Начало работы» был обновлен: URL-адрес Playables SDK изменен с v0 на v1 .

30 августа 2023 г.

Разделы «Имена файлов» и «Миниатюры» были обновлены: удалены ссылки на явный список разрешенных специальных символов ( _ , - , . ).

Кроме того, раздел «Сохранение в облаке» был обновлен и теперь требует, чтобы сохранение в облаке работало в новых версиях игры.

25 августа 2023 г.

Раздел saveData был обновлен, чтобы уточнить, что данные сохранения должны быть допустимой и правильно сформированной строкой UTF-16.

18 августа 2023 г.

Раздел «Пауза и возобновление» был обновлен, чтобы уточнить, что игра должна приостанавливать все выполнения после вызова onPause и возобновлять только после вызова onResume .

11 августа 2023 г.

В раздел «Имена файлов» добавлены ограничения на количество символов, используемых для именования файлов в комплекте игры.

10 августа 2023 г.

Раздел «Методы взаимодействия» был обновлен и теперь требует, чтобы все компоненты пользовательского интерфейса игры работали должным образом, без ошибок и непредвиденного поведения.

09 августа 2023 г.

Был добавлен раздел «Миниатюры изображений» , в котором перечислены требования к миниатюрам игры, что позволяет пользователям легко находить и распознавать Playable на YouTube.

08 августа 2023 г.

Раздел «Жесты и ввод» был обновлен, чтобы запретить игре вызывать preventDefault() при возникновении событий Esc .

Кроме того, был добавлен новый раздел «Ссылки на файлы» , требующий, чтобы игры использовали только относительные пути при ссылке на другие файлы в пакете, поскольку использование абсолютных путей может привести к ошибке.

02 августа 2023 г.

Раздел «Отключение звука» в «Технических требованиях» и «Рекомендациях по дизайну игр Playables» был обновлен, чтобы ссылаться на функции отключения и включения звука как элементы управления звуком и указывать, что детальные элементы управления звуком могут содержать либо ползунки громкости, либо переключатель отключения звука, либо и то, и другое.

28 июля 2023 г.

Документация Playables Game Design Guidelines была обновлена, чтобы стандартизировать многословие и обновить лучшие практики и скриншоты.

20 июля 2023 г.

Раздел «Пауза и возобновление» был добавлен для обеспечения кроссплатформенных возможностей приостановки и возобновления.

19 июля 2023 г.

На сайте YouTube Playables теперь есть документация Playables Game Design Guidelines, которая служит руководством по обеспечению оптимального игрового процесса для пользователей, играющих в игры YouTube на разных устройствах и платформах.

Рекомендации по игровому дизайну сосредоточены на следующих областях:

  • Миниатюры изображений
  • Адаптация устройства
  • Пользовательский интерфейс (UI)
  • Жесты и ввод
  • Пауза
  • Немой
  • Тактильная обратная связь
  • Регистрация пользователей
  • Конец игры (экран победы)
  • Доступность

Кроме того, раздел onAudioEnabledChange был обновлен, чтобы исправить небольшую типографскую ошибку в коде, которая вызывала ошибку в предложенном Flutter уровне взаимодействия JavaScript (JS-Interop).

14 июля 2023 г.

Раздел Размер обновлен следующим образом:

  • Убрано требование о том, чтобы в игру можно было играть в полноэкранном режиме на настольном компьютере и в альбомной или портретной ориентации на мобильном устройстве.
  • Добавлено, что в игру можно играть в портретной ориентации.
  • Добавлено, что в игру можно играть в альбомной ориентации. В противном случае игра должна быть центрирована или включать почтовый ящик.
  • Добавлено, что игра не должна блокировать ориентацию устройства.

11 июля 2023 г.

Раздел Flutter Web (экспериментальный) был добавлен для обеспечения интеграции с играми, написанными с помощью Flutter Web.

01 июля 2023 г.

Раздел «Отключение звука» требует, чтобы игра учитывала настройки звука YouTube и системы и чтобы звук игры не воспроизводился неожиданно.

Кроме того, в разделе «Завершение обработки контента» поясняется, что игра должна сообщать пользователю, что больше нет контента, с которым можно взаимодействовать, например, на последнем уровне или завершении игры.

30 июня 2023 г.

В разделе «Начало работы» теперь есть примечание о том, что SDK не будет работать, если игра обслуживается локально. Чтобы проверить правильность интеграции SDK, см. SDK Test Suite .

02 июня 2023 г.

Сайт YouTube Playables теперь включает документацию Playables SDK , в которой представлен надежный набор API для поддержки игр YouTube.

26 мая 2023 г.

Обновления документации по Техническим требованиям следующие:

Раздел Изменения
Время загрузки Включена средняя скорость интернета 6,8 Мбит/с по всему миру и 20 Мбит/с для США.
Методы взаимодействия Добавлено, что когда пользователь взаимодействует с игрой, игра не должна непреднамеренно задерживать или игнорировать ввод.
Миниатюры Обновлены необходимые разрешения изображения для соотношений 1:1, 5:7 и 16:9.
Информация об издателе или разработчике Добавлен новый раздел, требующий, чтобы в игре было указано имя издателя или разработчика, а также, возможно, в будущем потребуется предоставить рейтинг контента.
Загрузить Playables SDK Добавлен новый раздел, требующий, чтобы игра загружала Playables SDK перед любым другим игровым кодом.
Уведомление о готовности игры Обновлено для вызова API firstFrameReady только тогда, когда первый кадр вашей игры готов к отображению на экране, и для вызова API gameReady только тогда, когда игра готова к любому взаимодействию с пользователем.
Отключить звук Добавлено, что при отключении звука на YouTube звук не должен выводиться, а элементы управления отключением или включением звука в игре не должны влиять на вывод звука.

24 марта 2023 г.

Сайт YouTube Playables теперь включает документацию по техническим требованиям , призванную обеспечить удобство игр для пользователей, играющих в игры на YouTube.

В разделе технических требований основное внимание уделяется следующим областям:

  • Стабильность игры
  • опыт YouTube
  • Интеграция с YouTube
  • Локализация
  • Монетизация