Как интегрировать лаунчер со Steam
Как это работает
Вы можете интегрировать вашу игру с лаунчером в Steam. Это позволяет распространять другие ваши игры, опубликованные на Steam, через лаунчер.
Предварительные действия
Чтобы настроить интеграцию со Steam, вам потребуются:
- Steam AppID;
- аккаунт и приложение игры в Steamworks;
- сборка игры для публикации в Steam;
- готовый лаунчер, настроенный в Личном кабинете.
Вы можете найти ваш Steam AppID в панели администратора в Steamworks. Перейдите в раздел Steamworks > App Admin и вы увидите Steam AppID в скобках рядом с названием проекта.
Интеграция
Настройка платформы Steam и получение конфигурационных файлов
- Откройте ваш проект в Личном кабинете
- Нажмите Лаунчер в боковом меню.
- Найдите нужный лаунчер на дашборде и нажмите Редактировать.
- Перейдите в раздел Настройки и нажмите Set upсправа от логотипа платформы Steam.
- Введите ваш Steam Web API Key
- Введите Steam App ID вашей игры
- Нажмите Скачать хост лаунчера, чтобы скачать архив
LauncherHost.zip
для Windows или macOS - Нажмите Скачать конфигурационные файлы, чтобы скачать конфигурационные файлы игры.
- Перейдите на вкладку Launcher behavior и выберите, что лаунчер должен делать при запуске игры из Steam (опционально):
- запустить лаунчер (по умолчанию);
- запустить игру.

Примечание
Пользователь в любом случае увидит лаунчер после закрытия игры.
- Перейдите на вкладку User login и выберите способ аутентификации (опционально):
- Автоматически c помощью аккаунта Steam (по умолчанию).
- Вручную с помощью виджета авторизации. Виджет использует вариант авторизации, выбранный при создании лаунчера.
Генерация и скачивание установщика лаунчера
Воспользуйтесь инструкцией, чтобы создать и скачать установщик лаунчера.
Подготовка сборки игры для Steam
- Распакуйте архив
LauncherHost.zip
, который вы скачали на шаге 1 в любую директорию. Этот архив содержит папкуPreparingSteam
для подготовки лаунчера к загрузке в Steam.Файловая структура для Windows:LauncherHost.exe
— исполняемый файл для утилитыLauncherHost
;Qt5Core.dll
,vcruntime140-140_1.dll
,msvcp140-140_1.dll
— служебные библиотеки для утилитыLauncherHost.exe
;installer
— директория для установочного файла лаунчера.

- Файловая структура для MacOS:
LauncherHost
— исполняемый файл для утилитыLauncherHost
;Frameworks
— системная директория для библиотек утилитыLauncherHost
;installer
— директория для установочного файла лаунчера.

- Создайте новую директорию в директории
PreparingSteam
. - Скопируйте и вставьте сборку вашей игры в созданную директорию.
- Перейдите в раздел Game > Build > Executable files и укажите имена исполняемых файлов для Windows и macOS и относительные пути до них.
Примечание
Названия исполняемых файлов должны быть указаны с их расширениями.
- Скопируйте автономные установщики для Windows и macOS в директорию installer.
- Скопируйте и вставьте конфигурационные файлы Steam в директорию
PreparingSteam
- Если ваша игра уже есть в Steam, замените имя файла
LauncherHost.exe
на имя исполняемого файла игры. Вы можете найти имя исполняемого файла в панели администратора Steamworks в поле Executable раздела Apps & Packages > All applications > Steamworks admin > Installation > General installation.
Примечание
Замените имя файла
LauncherHost.exe
на имя исполняемого файла игры для отладки интеграции, чтобы не изменять сам исполняемый файл.
- Включите использование
ISteamApps::GetLaunchCommandLine()
в вашей панели администратора Steamworks.
- Нажмите Prepare for Publishing, чтобы проверить нет ли конфликтов между изменениями, внесенными вами и другими пользователями.
Загрузка сборки игры для Windows в Steam
- Войдите в ваш аккаунт в Steamworks и скачайте Steamworks SDK.
- Распакуйте архив с SDK.
- Перейдите в директорию
steamworks_sdk_151\sdk\tools
и распакуйте утилитуSteamPipeGUI
для загрузки игровых сборок в Steam.
- Запустите утилиту
SteamPipeGUI
.
- Укажите следующие настройки:
- В поле App ID, укажите Steam AppID вашей игры.
- В поле Build description, введите короткое описание сборки, чтобы вы могли различать сборки в вашей панели администратора.
- В поле Steamworks SDK ContentBuilder Path укажите путь до Steamworks SDK ContentBuilder.
- В полях Steam Login и Steam Password укажите ваши логин и пароль от аккаунта Steamworks.

- Нажмите Add Depot. В поле Build Path укажите путь до директории PreparingSteam со сборкой игры и установочным файлом лаунчера.

- Нажмите Upload и дождитесь окончания загрузки.
Загрузка сборки игры для macOS в Steam
- Скопируйте файл
launcher.dmg
и вставьте его в директориюprepairingSteam/installer
. - Скопируйте файл
hostArgs.json
и вставьте его в директориюprepairingSteam
. - Загрузите файлы в Steam:
- Откройте распакованную директорию
SteamSDK
.
- Откройте распакованную директорию
- Перейдите в директорию
tools/scripts
. - Создайте скрипт
appbuild<steam_id>.vdf
, где<steam_id>
— Steаm ID вашего проекта, как показано в примере ниже. В строке 3 заменитеxxxxxx
на Steam ID вашего продукта. В строке 11 заменитеyyyyyy
на Depot ID — это Steam ID + 1.
- Перейдите в директорию
Copy
"AppID" "xxxxxx" // your AppID
"Desc" "This is a simple build script 1" // internal description for this build
"ContentRoot" "../content/" // root content folder, relative to location of this file
"BuildOutput" "../output/" // build output folder for build logs and build cache files
"Depots"
{
"yyyyyy" // your DepotID
{
"FileMapping"
{
"LocalPath" "*" // all files from contentroot folder
"DepotPath" "." // mapped into the root of the depot
"recursive" "1" // include all subfolders
}
}
}
}
- Сохраните изменения.
- Скопируйте содержимое директории
PrepairingSteam
и вставьте его в директориюtools/ContentBuilder/Content
. - Перейдите в командной строке в директорию
tools/ContentBuilder/builder_osx
. - Вызовите команду
./steamcmd.sh
, чтобы запустить инициализацию и настройку. - Вызовите следующую команду, чтобы запустить скрипт для загрузки сборки в Steam:
Copy
cmd.sh +login <username> <password> +run_app_build_http ../scripts/app_build_{Steam_id}.vdf
Публикация сборки игры в Steamworks
- Войдите в панель администратора Steamworks.
- Нажмите Steamworks Admin, чтобы открыть страницу управления приложением.
- Перейдите в раздел SteamPipes > Builds.
- Создайте новую ветку или используйте ветку, созданную по умолчанию.
- Найдите загруженную сборку по ее ID, дате загрузки или описанию и поместите сборку в созданную ветку.
- Нажмите Preview change и посмотрите изменения.
- Нажмите Set Build Live Now.
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Оценить страницу
Оценить страницу
В другой раз
Спасибо за обратную связь!
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.