Запуск игры с локального сервера

Чтобы упростить разработку и тестирование игры, вы можете запустить ее с локального сервера:

  1. Добавьте черновик игры через консоль Яндекс Игр.
  2. Настройте сервер localhost.
  3. Откройте игру в режиме черновика, добавив в адрес параметр ?game_url=https://localhost.

Примечание

Из соображений безопасности в параметре game_url поддерживается только домен localhost.

Настройка локального сервера

  1. Установите npm, следуя инструкциям на сайте Node.JS.

  2. С помощью npm установите пакет @yandex-games/sdk-dev-proxy:

    > $ npm install -g @yandex-games/sdk-dev-proxy
    
  3. Запустите игру. Вы можете:

    > npx @yandex-games/sdk-dev-proxy -h <Адрес локального сервера>
    
    > npx @yandex-games/sdk-dev-proxy -p <Путь до папки с игрой>
    

    Пакет проксирует запросы до ресурсов SDK на том же сервере, на котором будет расположена ваша игра.

Если вы укажете параметр --app-id, то при запуске откроется ваша игра на yandex.ru/games:

> npx @yandex-games/sdk-dev-proxy -p <Путь до папки с игрой> --app-id=<ID игры>

Если не указать --app-id, то в консоли появятся шаблонная ссылка на игру на сервисе и ссылка на локальный сервер.

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

Параметры для запуска

Параметр

Описание

--help

Справка.

--host, -h

Хост, на котором расположен локальный сервер игры (например, используется для webpack-dev-server).

--path, -p

Путь до папки, в которой расположены ресурсы игры.

--port

Порт, на котором откроется сервер (по умолчанию 8080).

--app-id, -i

ID черновика игры.

--csp, -c

Добавляет метатег с Content-Security-Policy. Он соответствует тегу, который будет создан в index.html на сервисе.

--log, -l

Включение логирования запросов в консоль (по умолчанию включено).

--tld

Меняет домен yandex.tld, например, на yandex.com (по умолчанию ru).