Методы SDK

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

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

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

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

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

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

Инициализация 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

Комментарий

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

Начинается обучение.

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

Игра доступна, пользователь может взаимодействовать с персонажами.

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

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

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

На экране появляется надпись «Коснитесь, чтобы начать миссию».

Несколько секунд отображается загрузочный экран Яндекс Игр, затем появляется логотип игрового движка. Появляется меню с кнопкой «Играть» и одновременно с этим индикатор становится зеленым.

Появляется меню, пользователь может приступить к игре.

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

Начинается обратный отсчет, после его окончания игрок может управлять машиной.

Пример всплывающего окна

Game Ready

Комментарий

Несколько секунд отображается загрузочный экран Яндекс Игр, затем появляется всплывающее окно с текстом «Вход: Вы не авторизованы. Войдите в учетную запись на этой платформе, чтобы не потерять свой прогресс!» и кнопками «Вход» и «Отмена». За всплывающим окном отображается обложка игры и прогресс-бар, так как загрузка еще не завершена. Одновременно с появлением всплывающего окна индикатор становится зеленым.

Окно авторизации появляется во время загрузки.

Несколько секунд отображается обложка игры с прогресс-баром, затем меняются изображение и прогресс-бар. Появляется всплывающее окно с названием «Лицензионное соглашение» и кнопками «Политики» и «Да» и одновременно с этим индикатор становится зеленым.

Появляется окно для подписи лицензионного соглашения.

Несколько секунд отображается загрузочный экран Яндекс Игр. Затем появляется логотип игры с прогресс-баром, потом еще два внутренних экрана загрузки. Когда появляется всплывающее окно с названием «Ежедневная награда» и кнопкой «Получить награду», индикатор становится зеленым.

Открывается окно, в котором можно забрать ежедневную награду.

Пример неинтерактивного элемента

Game Ready

Комментарий

Несколько секунд отображается загрузочный экран Яндекс Игр. Затем начинается анимация облета локации.

Начинается стартовая анимация облета локации.

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

Начинается кат-сцена.

Пример окна настроек

Game Ready

Комментарий

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

Становятся доступны настройки персонажа.

Game Ready не подключен

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

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

Game Ready

Комментарий

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

Game Ready не подключен, SDK инициализирован. Индикатор после 90 секунд загрузки игры сменится на красный. При наведении на индикатор появляется подсказка "ready" called on timeout.

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

Game Ready не подключен, SDK не инициализирован. Индикатор не меняет цвет и продолжает мигать фиолетовым. При наведении на индикатор появится подсказка SDK is not initialized. Wait for "unit" call.

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

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 и игра была снята с публикации или не допущена до нее по ошибке — заполните форму ниже.

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

Открыть форму