Установка и использование SDK

SDK Яндекс Игр — это библиотека, позволяющая быстро интегрировать игры, созданные сторонними разработчиками, в платформу Яндекс Игр.

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

SDK предоставляет следующие возможности:

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

УстановкаУстановка

Подключить SDK Яндекс Игр можно как синхронным, так и асинхронным способом. Оба варианта равноправны. Однако асинхронное подключение позволяет контролировать процесс установки с помощью callback-функций. Выберите способ, который считаете более подходящим.

<!-- Yandex Games SDK -->
<script src="https://yandex.ru/games/sdk/v2"></script>

<!-- Yandex Games SDK -->
<script>
    (function(d) {
        var t = d.getElementsByTagName('script')[0];
        var s = d.createElement('script');
        s.src = 'https://yandex.ru/games/sdk/v2';
        s.async = true;
        t.parentNode.insertBefore(s, t);
        s.onload = initSDK;
    })(document);
</script>

ИспользованиеИспользование

Для начала работы инициализируйте SDK, используя метод init объекта YaGames.

YaGames
    .init()
    .then(ysdk => {
        console.log('Yandex SDK initialized');
        window.ysdk = ysdk;
    });

Возможные проблемыВозможные проблемы

Uncaught ReferenceError: YaGames is not definedUncaught ReferenceError: YaGames is not defined

Обратите внимание на порядок подключения скрипта games/sdk/v2: он должен быть подключен до выполнения YaGames.init().

Uncaught ReferenceError: ysdk is not definedUncaught ReferenceError: ysdk is not defined

Вы попытались использовать методы SDK (реклама, покупки и т. д.) до момента инициализации SDK (сообщение Yandex SDK initialized в консоли). Если вы не знаете, как гарантировать порядок вызовов, перепишите места использования SDK. Для этого замените строку:

ysdk.adv.showFullscreenAdv()

на:

YaGames.init().then(ysdk => ysdk.adv.showFullscreenAdv())

Пример подключения SDKПример подключения SDK

<!-- Yandex Games SDK -->
<script src="https://yandex.ru/games/sdk/v2"></script>
<script>
    YaGames.init().then(ysdk => {
        // ...
    });
</script>

Дополнительные параметрыДополнительные параметры

В YaGames.init() можно передать опциональные параметры: YaGames.init(options). Подробнее см. в разделе Другие объекты и параметры SDK.

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