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

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

• Требования к доступности
• Руководство по разработке игр Playables
• Playables SDK
• Технические требования
• Требования к доверию и безопасности

25 августа 2026 г.

• Внесены обновленные требования к обеспечению доверия и безопасности , добавлена ​​политика в отношении дублирования контента (раздел 2.2), требующая использования оригинального, авторизованного или лицензированного контента и запрещающая создание дубликатов игровых сборок.

24 августа 2026 г.

• Добавлены теги доступности игры (разделы 2 и 2.1), охватывающие поиск игроков в соответствии с Инициативой доступных игр (AGI) и точность метаданных разработчиков.

11 июля 2024 г.

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

24 июня 2024 г.

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

17 июня 2024 г.

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

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

16 мая 2024 г.

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

8 мая 2024 г.

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

7 мая 2024 г.

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

3 мая 2024 г.

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

5 марта 2024 г.

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

23 февраля 2024 г.

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

4 декабря 2023 г.

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

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

10 ноября 2023 г.

Загружаемый пакет тестового набора заменен размещенным тестовым набором .

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

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

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

30 августа 2023 г.

В разделы «Названия файлов» и «Эскизы» внесены изменения, удалены ссылки на явное указание допустимых специальных символов ( _ , - , . ).

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

25 августа 2023 г.

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

18 августа 2023 г.

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

11 августа 2023 г.

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

10 августа 2023 г.

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

9 августа 2023 г.

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

8 августа 2023 г.

В раздел «Жесты и ввод» внесены изменения, запрещающие игре вызывать preventDefault() при событиях Esc .

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

2 августа 2023 г.

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

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 (experimental) , позволяющий интегрировать его с играми, написанными на Flutter Web.

1 июля 2023 г.

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

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

30 июня 2023 г.

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

2 июня 2023 г.

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

26 мая 2023 г.

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

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

24 марта 2023 г.

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

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

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