Лаунчер / Загрузка сборки игры
 На главную

Лаунчер

  • Руководство по интеграции

  • Возможности

  • Инструкции

  • Расширения

  • Справочники

  • Загрузка сборки игры

    Для загрузки сборки игры на сервер обновлений используется консольная утилита Build Loader.

    Системные требования для Build Loader:

    • Операционная система: Windows 7/8/10 64-bit, macOS 10.14.0 и выше
    • Процессор (CPU): 1.6 ГГц
    • Свободный объем оперативной памяти (RAM): 100 Мб (или более)
    • Свободный объем жесткого диска: 150% от размера файла сборки игры

    Build Loader принимает следующие параметры:

    • --init — инициализация утилиты.
    • --update — отправка сборки игры на сервер.
    • --builds-list — список сборок игры.
    • --descr <build-description> — описание сборки.
    • --api-key <API-key> — ключ API.
    • --game-path <path-to-game> — путь к сборке игры.
    • --chunk-size <chunk-size> — размер чанков — частей, на которые разбивается архив игры. Измеряется в МБ или ГБ. Параметр принимает значение от 10mb до 5120mb или от 1gb до 5gb, по умолчанию 5gb.
    • --retry-timeout <timeout> — интервал между попытками загрузки файлов, измеряется в секундах. Параметр принимает значение от 10 до 60, по умолчанию 20.
    • --retry-count <retry-count> — количество попыток загрузки файлов. Параметр принимает значение от 1 до 10, по умолчанию 3.
    • --set-build-on-test — размещение сборки игры на stage с названием test. Игра будет доступна только для тестирования.
    • --set-build-on-master — размещение сборки игры на stage с названием master. Игра будет доступна конечным пользователям. Этот параметр игнорируется, если указан параметр --set-build-on-test.

    Чтобы загрузить сборку игры:

    1. Перейдите в раздел Настройки сборок в Личном кабинете.
    2. Скопируйте ключ API.
    3. Скачайте и установите Build Loader.
    4. Инициализируйте утилиту.
    5. Загрузите сборку игры на сервер.
    6. Разместите сборку игры на stage.
    7. Настройте файлы игры.

    Инициализация Build Loader

    Для инициализации утилиты передайте ранее скопированный ключ API и путь к сборке игры:

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

    Загрузка на сервер

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

    Если параметр --game-path уже использовался при инициализации или предыдущей загрузке сборки, его можно опустить. При первой загрузке сервер обновлений получает всю сборку игры, при следующих — патчи, сформированные Build Loader.

    Размещение на stage

    Сборку игры можно разместить на stage следующими способами:
    • Во время загрузки сборки на сервер передайте Build Loader соответствующий параметр: --set-build-on-master или --set-build-on-test.
    • После загрузки сборки на сервер откройте ваш проект в Личном кабинете, нажмите Лаунчер в боковом меню, нажмите значок шестеренки (Настройки сборок) и выберите нужный stage в разделе Список сборок: master или test.
    Примечание
    Для тестирования игры запустите лаунчер с параметром -game_stage test в консоли. Например: launcher.exe -game_stage test.

    Настройка файлов игры

    Для корректной загрузки игр из лаунчера необходимо настроить и инициализировать файлы загрузки.
    1. В Личном кабинете в разделе Настройки сборок перейдите к блоку Настройки файлов игры.
    2. Введите название и расширение файла, который запускает игру (например, coolgame.exe).
    3. Укажите путь установки игры.
    4. Загрузите распространяемые файлы, необходимые для запуска игры (например, Microsoft Visual C++ 2017 Redistributable).
    Лаунчер передает игре следующие параметры:
    • --xsolla-locale <locale>: язык интерфейса;
    • --xsolla-login-token <token>: Xsolla Login JWT (JSON Web Token).
    ПРИМЕР

    Туториалы

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

    Спасибо за обратную связь!
    Последнее обновление: 8 августа 2022

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

    Сообщите о проблеме
    Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
    Укажите email-адрес, чтобы мы могли связаться с вами
    Спасибо за обратную связь!