Методы SDK

Пункт 1.19 Требований к игре

Инициализация SDK Яндекс Игр и использование его методов производятся в строгом соответствии с документацией и требованиями к игре:

  1. SDK инициализируется строго так, как указано на странице Подключение и использование.

  2. В момент, когда пользователь уже может приступить к игре, должен быть произведен вызов метода LoadingAPI.ready() из Game Ready.

  3. Использование разметки геймплея опционально, при этом если методы GameplayAPI.start() и GameplayAPI.stop() используются в игре, то моменты отправки событий строго соответствуют описанным в разделе Геймплей.

  4. Отслеживание событий game_api_pause и game_api_resume опционально, при этом если методы ysdk.on() и ysdk.off() используются в игре, то логика обработки событий строго соответствует описанной в разделе Пауза и возобновление игры.

Инициализация SDK

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

Проверка актуальности лоадера

  1. Запустите игру с debug-панелью.

    1. Откройте Консоль Яндекс Игр.
    2. Выберите нужную игру.
    3. В левом верхнем углу нажмите Открыть с debug-панелью.

    1. Откройте нужную игру.

    2. Добавьте параметр debug-mode=16 в конец адресной строки браузера.

      Пример ссылки: https://yandex.ru/games/app/XXXX?debug-mode=16, где XXXX — уникальный идентификатор игры.

  2. На debug-панели слева от индикатора Game Ready найдите две буквы:

    • IF (init false) — игра поддерживает старый лоадер. При наведении указателя на IF появится надпись Is loader: false.

    • IT (init true) — игра поддерживает новый лоадер. При наведении указателя на IT появится надпись Is loader: true.

Примеры

Лоадер

Комментарий

Скриншот игры: на debug-панели отображается IF, а во всплывающем окне ниже текст: «SDK was initialized Version: v2. Is loader: false.»

Старый лоадер. На debug-панели отображается IF.

Скриншот игры: на debug-панели отображается IF, а во всплывающем окне ниже текст: «SDK was initialized Version: v2. Is loader: false.»

Старый лоадер. На debug-панели отображается IF.

Скриншот игры: на debug-панели отображается IT, а во всплывающем окне ниже текст: «SDK was initialized Version: v2. Is loader: true.»

Новый лоадер. На debug-панели отображается IT.

Скриншот игры: на debug-панели отображается IT, а во всплывающем окне ниже текст: «SDK was initialized Version: v2. Is loader: true.»

Новый лоадер. На debug-панели отображается IT.

Game Ready

1.19.2. Когда пользователь уже может начать игру, вызовите метод LoadingAPI.ready() из Game Ready.

Чтобы требование считалось выполненным, метод LoadingAPI.ready() должен вызываться в корректный момент.

Загрузочный экран

Во время загрузки игры платформа Яндекс Игры вначале показывает свой загрузочный экран — пульсирующую иконку игры и надпись «Загрузка». Его можно скрыть вручную, если нажать на экран.

Как выглядит загрузочный экран Яндекс Игр

Загрузочный экран Яндекс Игр: пульсирующая иконка игры и надпись «Загрузка»

Модерация проверяет загрузочный экран самой игры. Если на нем есть запрещенный контент — сторонние ссылки, чужие логотипы, элементы, нарушающие авторские права, — это станет основанием для отказа.

Подготовка

  1. Запустите игру с debug-панелью.

    1. Откройте Консоль Яндекс Игр.
    2. Выберите нужную игру.
    3. В левом верхнем углу нажмите Открыть с debug-панелью.

    1. Откройте нужную игру.

    2. Добавьте параметр debug-mode=16 в конец адресной строки браузера.

      Пример ссылки: https://yandex.ru/games/app/XXXX?debug-mode=16, где XXXX — уникальный идентификатор игры.

  2. На debug-панели найдите индикатор Game Ready Значок фиолетового индикатора.

Логика проверки Game Ready

  1. Проверьте, что фиолетовый индикатор Значок фиолетового индикатора сменился на зеленый Значок зеленого индикатора в течение 90 секунд.
  2. Перезагрузите игру.
  3. Повторно проверьте, в какой момент индикатор меняет цвет.

Сценарии, которые модерация учитывает при проверке:

Сценарий

Пример

Загрузочный экран Яндекс Игр скрыт вручную — нажмите на экран, чтобы скрыть его, и проверьте момент смены индикатора.

Видео загрузки игры: загрузочный экран Яндекс Игр скрыт нажатием, затем отображается загрузочный экран игры, после чего игра становится доступна для взаимодействия.

Загрузочный экран Яндекс Игр исчез автоматически — дождитесь, пока экран скроется сам, и проверьте момент смены индикатора.

Видео загрузки игры: загрузочный экран Яндекс Игр исчезает автоматически, затем на короткое время отображается загрузочный экран игры, после чего игра становится доступна для взаимодействия.

Примечание

Game Ready должен корректно отрабатывать в обоих сценариях. Если вызов LoadingAPI.ready() привязан к конкретному моменту времени, а не к реальной готовности игры, при ручном скрытии загрузочного экрана Яндекс Игр это будет заметно, и модерация отметит это как нарушение.

Game Ready работает корректно

Фиолетовый индикатор Значок фиолетового индикатора сменился на зеленый Значок зеленого индикатора в момент:

  • когда доступно меню;
  • когда игра доступна для взаимодействия (включая начальную анимацию).

Game Ready

Комментарий

Видео загрузки игры: индикатор на debug-панели мигает синим во время загрузки игры, когда появляется меню, индикатор становится зеленым.

Зеленый индикатор появляется в момент, когда доступно меню.

Видео загрузки игры: индикатор на debug-панели мигает синим во время загрузки игры, когда появляется меню, индикатор становится зеленым.

Зеленый индикатор появляется в момент, когда доступно меню.

Видео загрузки игры: индикатор на debug-панели мигает синим во время загрузки игры, когда появляется меню, индикатор становится зеленым.

Зеленый индикатор появляется в момент, когда доступно меню.

Видео загрузки игры: индикатор на debug-панели мигает синим во время загрузки игры, когда игра становится доступна для взаимодействия, индикатор становится зеленым.

Зеленый индикатор появляется в момент, когда игра доступна для взаимодействия.

Видео загрузки игры: индикатор на debug-панели мигает синим во время загрузки игры, когда игра становится доступна для взаимодействия, индикатор становится зеленым.

Зеленый индикатор появляется в момент, когда игра доступна для взаимодействия.

Видео загрузки игры: индикатор на debug-панели мигает синим во время загрузки игры, когда игра становится доступна для взаимодействия, индикатор становится зеленым.

Зеленый индикатор появляется в момент, когда игра доступна для взаимодействия.

Game Ready работает некорректно

Фиолетовый индикатор Значок фиолетового индикатора сменился на зеленый Значок зеленого индикатора:

  • до того, как игра стала доступна для взаимодействия (есть прогресс-бары, тробберы, черный экран и т. д.);
  • через несколько секунд после того, как игра стала готова к взаимодействию.

Game Ready

Комментарий

Видео загрузки игры: во время загрузки индикатор на debug-панели зеленого цвета, хотя с игрой еще невозможно взаимодействовать.

Зеленый индикатор появляется до того, как игра стала доступна для взаимодействия.

Видео загрузки игры: во время загрузки индикатор на debug-панели сначала мигает синим, а затем становится зеленым, хотя с игрой еще невозможно взаимодействовать.

Зеленый индикатор появляется до того, как игра стала доступна для взаимодействия.

Видео загрузки игры: во время загрузки и рекламы индикатор на debug-панели зеленого цвета, хотя с игрой еще невозможно взаимодействовать.

Зеленый индикатор появляется до того, как игра стала доступна для взаимодействия.

Видео геймплея: игра уже доступна для взаимодействия, но в течение еще нескольких секунд индикатор на debug-панели мигает синим.

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

Видео геймплея: игра уже доступна для взаимодействия, но в течение еще нескольких секунд индикатор на debug-панели мигает синим.

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

Game Ready не встроен

Индикатор стал красным Значок красного индикатора спустя 90 секунд.

Game Ready

Комментарий

Видео игры-викторины: во время прохождения игры индикатор на debug-панели мигает синим, а затем становится красным.

Индикатор стал красным — Game Ready не встроен.

Разметка геймплея

1.19.3. Методы GameplayAPI.start() и GameplayAPI.stop() позволяют размечать начало и остановку игрового процесса. Если они используются в игре, то моменты отправки событий строго соответствуют описанным в разделе Геймплей.

Подготовка

  1. Запустите игру с debug-панелью.

    1. Откройте Консоль Яндекс Игр.
    2. Выберите нужную игру.
    3. В левом верхнем углу нажмите Открыть с debug-панелью.

    1. Откройте нужную игру.

    2. Добавьте параметр debug-mode=16 в конец адресной строки браузера.

      Пример ссылки: https://yandex.ru/games/app/XXXX?debug-mode=16, где XXXX — уникальный идентификатор игры.

  2. На debug-панели найдите кнопку геймпада 🎮.

Проверка разметки геймплея

Отслеживайте состояние индикатора геймплея в зависимости от действий:

  • Когда игрок начинает игровой процесс или возобновляет его после паузы, должен быть вызван метод GameplayAPI.start(). Индикатор геймплея должен стать зеленым Значок геймпада на зеленом фоне — геймплей в процессе.

  • Когда игрок завершает игровой процесс или приостанавливает его, должен быть вызван метод GameplayAPI.stop(). Индикатор геймплея должен стать красным Значок геймпада на красном фоне — геймплей на паузе.

Сценарии, которые модерация учитывает при проверке:

  • Запуск и завершение уровня.
  • Открытие и закрытие игрового меню.
  • Открытие и закрытие меню покупок.
  • Запуск и закрытие рекламы.
  • Потеря фокуса с игры и возвращение в игру (переход на другую вкладку браузера или в другое окно).

Совет

Чтобы узнать, где находится фокус (на игре или на другом окне), отслеживайте события game_api_resume и game_api_pause.

Геймплей размечен корректно

Цвет индикатора меняется в зависимости от сценария.

Игра

Комментарий

Видео выбора и запуска уровня: при появлении уровня индикатор геймплея (иконка геймпада) становится зеленым.

В момент запуска нового уровня индикатор зеленый.

Видео геймплея: при завершении уровня индикатор геймплея (иконка геймпада) из зеленого становится красным.

Уровень окончен, индикатор стал красным.

Видео геймплея: во время прохождения уровня индикатор геймплея (иконка геймпада) зеленый, при открытии меню он становится красным, после выхода из меню снова становится зеленым.

При переходе в меню и после возвращения в игровой процесс индикатор меняется.

Видео геймплея: во время прохождения уровня индикатор геймплея (иконка геймпада) зеленый, при открытии меню он становится красным, после выхода из меню снова становится зеленым.

При переходе в меню и после возвращения в игровой процесс индикатор меняется.

Видео геймплея: при переходе из игры в магазин внутриигровых покупок индикатор геймплея (иконка геймпада) из зеленого становится красным. После возвращения в игру индикатор становится зеленым.

При переходе в меню покупок и после возвращения в игровой процесс индикатор меняется.

Видео геймплея: при включении рекламы индикатор геймплея (иконка геймпада) из зеленого становится красным. После возвращения в игру индикатор становится зеленым.

Реклама закрылась, цвет индикатора сменился с красного на зеленый.

Видео геймплея: во время игры индикатор геймплея (иконка геймпада) зеленый. При открытии другой программы (Проводник) индикатор становится красным. После обратного переключения на вкладку с игрой в браузере индикатор становится зеленым.

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

Геймплей размечен некорректно

Цвет индикатора не меняется в зависимости от сценария.

Игра

Комментарий

Видео геймплея: после окончания уровня индикатор геймплея (иконка геймпада) все еще зеленый.

Уровень окончен, цвет индикатора не сменился с зеленого на красный.

Видео геймплея: после открытия меню индикатор геймплея (иконка геймпада) все еще зеленый.

При переходе в меню цвет индикатора не сменился с зеленого на красный.

Видео геймплея: при включении рекламы индикатор геймплея (иконка геймпада) из зеленого становится красным. После возвращения в игру индикатор остается красным.

Реклама закрылась, цвет индикатора не сменился с красного на зеленый.

Видео геймплея: во время игры индикатор геймплея (иконка геймпада) зеленый. При открытии другой программы (Проводник) индикатор остается зеленым.

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

Связаться с модерацией

Если вы считаете, что правильно используете методы SDK и игра была снята с публикации или не допущена до нее по ошибке — заполните форму ниже.

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

Открыть форму
Предыдущая
Базовые нарушения
Следующая
Игровые механики