Методы 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 в конец адресной строки браузера.

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

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

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

Примеры

Лоадер

Комментарий

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

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

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

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

Game Ready

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

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

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

Подготовка

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

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

  2. На debug-панели найдите индикатор Game Ready .

Общий принцип проверки

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

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

Синий индикатор сменился на зеленый в момент:

  • когда доступно меню;

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

Game Ready

Комментарий

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

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

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

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

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

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

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

Синий индикатор сменился на зеленый :

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

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

Game Ready

Комментарий

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

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

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

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

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

Game Ready не встроен

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

Game Ready

Комментарий

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

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

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

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

Подготовка

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

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

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

Общий принцип проверки

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

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

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

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

  • Запуск и завершение уровня.

  • Открытие и закрытие игрового меню.

  • Открытие и закрытие меню покупок.

  • Запуск и закрытие рекламы.

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

Совет

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

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

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

Игра

Комментарий

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

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

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

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

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

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

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

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

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

Игра

Комментарий

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

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

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

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

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

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

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

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