Установка и использование SDK
SDK Яндекс Игр — это библиотека, позволяющая быстро интегрировать игры, созданные сторонними разработчиками, в платформу Яндекс Игр.
Подключение SDK является обязательным условием для успешного прохождения модерации.
SDK предоставляет следующие возможности:
- интегрировать показ рекламы;
- управлять включением и отключением функциональности без обновления билда;
- настроить автоматический переход в полноэкранный режим;
- задать ориентацию экрана во время игры и добавить подсказку, в какую сторону следует повернуть устройство.
Установка
Подключить SDK Яндекс Игр можно как синхронным, так и асинхронным способом. Оба варианта равноправны. Однако асинхронное подключение позволяет контролировать процесс установки с помощью callback-функций. Выберите способ, который считаете более подходящим.
Добавьте в заголовок head
HTML-страницы строку следующего вида:
<!-- Yandex Games SDK -->
<script src="https://yandex.ru/games/sdk/v2"></script>
Добавьте на HTML-страницу следующий код:
<!-- 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 defined
Обратите внимание на порядок подключения скрипта games/sdk/v2
: он должен быть подключен до выполнения YaGames.init().
Uncaught ReferenceError: ysdk is not defined
Вы попытались использовать методы SDK (реклама, покупки и т. д.) до момента инициализации SDK (сообщение Yandex SDK initialized
в консоли).
Если вы не знаете, как гарантировать порядок вызовов, перепишите места использования SDK. Для этого замените строку:
ysdk.adv.showFullscreenAdv()
на:
YaGames.init().then(ysdk => ysdk.adv.showFullscreenAdv())
Пример подключения 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.
Примечание
Сотрудники службы поддержки помогают разместить готовую игру или WebApp на платформе Яндекс Игр. На прикладные вопросы о разработке и тестировании предметно ответят другие разработчики в Сообществе в Telegram.
Если при использовании SDK Яндекс Игр вы столкнулись с проблемой или у вас появился вопрос, обратитесь в службу поддержки: