Лаунчер / Как интегрировать лаунчер со Steam

Как интегрировать лаунчер со Steam

Как это работает

Вы можете интегрировать вашу игру с лаунчером в Steam. Это позволяет распространять другие ваши игры, опубликованные на Steam, через лаунчер.

Предварительные действия

Чтобы настроить интеграцию со Steam, вам потребуются:

  • Steam AppID;
  • аккаунт и приложение игры в Steamworks;
  • сборка игры для публикации в Steam;
  • готовый лаунчер, настроенный в Личном кабинете.

Вы можете найти ваш Steam AppID в панели администратора в Steamworks. Перейдите в раздел Steamworks > App Admin и вы увидите Steam AppID в скобках рядом с названием проекта.

Интеграция

Настройка платформы Steam и получение конфигурационных файлов

  1. Откройте ваш проект в Личном кабинете
  2. Нажмите Лаунчер в боковом меню.
  3. Найдите нужный лаунчер на дашборде и нажмите Редактировать.
  4. Перейдите в раздел Настройки и нажмите Set upсправа от логотипа платформы Steam.
  5. Введите ваш Steam Web API Key
  6. Введите Steam App ID вашей игры
  7. Нажмите Скачать хост лаунчера, чтобы скачать архивLauncherHost.zip для Windows или macOS
  8. Нажмите Скачать конфигурационные файлы, чтобы скачать конфигурационные файлы игры.
  9. Перейдите на вкладку Launcher behavior и выберите, что лаунчер должен делать при запуске игры из Steam (опционально):
    • запустить лаунчер (по умолчанию);
    • запустить игру.

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

  1. Перейдите на вкладку User login и выберите способ аутентификации (опционально):
    • Автоматически c помощью аккаунта Steam (по умолчанию).
    • Вручную с помощью виджета авторизации. Виджет использует вариант авторизации, выбранный при создании лаунчера.

Генерация и скачивание установщика лаунчера

Воспользуйтесь инструкцией, чтобы создать и скачать установщик лаунчера.

Подготовка сборки игры для Steam

  1. Распакуйте архив LauncherHost.zip, который вы скачали на шаге 1 в любую директорию. Этот архив содержит папку PreparingSteam для подготовки лаунчера к загрузке в Steam.Файловая структура для Windows:
    • LauncherHost.exe — исполняемый файл для утилиты LauncherHost;
    • Qt5Core.dll, vcruntime140-140_1.dll, msvcp140-140_1.dll — служебные библиотеки для утилиты LauncherHost.exe;
    • installer — директория для установочного файла лаунчера.

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

  1. Создайте новую директорию в директории PreparingSteam.
  2. Скопируйте и вставьте сборку вашей игры в созданную директорию.
  3. Перейдите в раздел Game > Build > Executable files и укажите имена исполняемых файлов для Windows и macOS и относительные пути до них.

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

  1. Скопируйте автономные установщики для Windows и macOS в директорию installer.
  2. Скопируйте и вставьте конфигурационные файлы Steam в директорию PreparingSteam
  3. Если ваша игра уже есть в Steam, замените имя файла LauncherHost.exe на имя исполняемого файла игры. Вы можете найти имя исполняемого файла в панели администратора Steamworks в поле Executable раздела Apps & Packages > All applications > Steamworks admin > Installation > General installation.

Примечание
Замените имя файла LauncherHost.exe на имя исполняемого файла игры для отладки интеграции, чтобы не изменять сам исполняемый файл.

  1. Включите использование ISteamApps::GetLaunchCommandLine() в вашей панели администратора Steamworks.

  1. Нажмите Prepare for Publishing, чтобы проверить нет ли конфликтов между изменениями, внесенными вами и другими пользователями.

Загрузка сборки игры для Windows в Steam

  1. Войдите в ваш аккаунт в Steamworks и скачайте Steamworks SDK.
  2. Распакуйте архив с SDK.

  1. Перейдите в директорию steamworks_sdk_151\sdk\tools и распакуйте утилиту SteamPipeGUI для загрузки игровых сборок в Steam.

  1. Запустите утилиту SteamPipeGUI.

  1. Укажите следующие настройки:
    1. В поле App ID, укажите Steam AppID вашей игры.
    2. В поле Build description, введите короткое описание сборки, чтобы вы могли различать сборки в вашей панели администратора.
    3. В поле Steamworks SDK ContentBuilder Path укажите путь до Steamworks SDK ContentBuilder.
    4. В полях Steam Login и Steam Password укажите ваши логин и пароль от аккаунта Steamworks.

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

    1. Нажмите Upload и дождитесь окончания загрузки.

Загрузка сборки игры для macOS в Steam

  1. Скопируйте файл launcher.dmg и вставьте его в директорию prepairingSteam/installer.
  2. Скопируйте файл hostArgs.json и вставьте его в директорию prepairingSteam.
  3. Загрузите файлы в Steam:
    1. Откройте распакованную директорию SteamSDK.

    1. Перейдите в директорию tools/scripts.
    2. Создайте скрипт appbuild<steam_id>.vdf, где <steam_id> — Steаm ID вашего проекта, как показано в примере ниже. В строке 3 замените xxxxxx на Steam ID вашего продукта. В строке 11 замените yyyyyy на Depot ID — это Steam ID + 1.

Copy
Full screen
Small screen

       "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
                }
            }
        }
    }

      1. Сохраните изменения.
      2. Скопируйте содержимое директории PrepairingSteam и вставьте его в директорию tools/ContentBuilder/Content.
      3. Перейдите в командной строке в директорию tools/ContentBuilder/builder_osx.
      4. Вызовите команду ./steamcmd.sh, чтобы запустить инициализацию и настройку.
      5. Вызовите следующую команду, чтобы запустить скрипт для загрузки сборки в Steam:

    Copy
    Full screen
    Small screen

      cmd.sh +login <username> <password> +run_app_build_http ../scripts/app_build_{Steam_id}.vdf

      Публикация сборки игры в Steamworks

      1. Войдите в панель администратора Steamworks.
      2. Нажмите Steamworks Admin, чтобы открыть страницу управления приложением.

      1. Перейдите в раздел SteamPipes > Builds.

      1. Создайте новую ветку или используйте ветку, созданную по умолчанию.
      2. Найдите загруженную сборку по ее ID, дате загрузки или описанию и поместите сборку в созданную ветку.
      3. Нажмите Preview change и посмотрите изменения.
      4. Нажмите Set Build Live Now.

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

      В другой раз

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

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

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