РуководствоИнтеграция

Быстрый старт: первая интеграция за 5 минут

Это руководство поможет подключить игру к BlueStudz, протестировать авторизацию в локальном редакторе (Unity, Unreal Engine, Godot) и запустить готовый билд через лаунчер.

Шаг 1: Получение Game ID и Secret Token

Перейдите в Кабинет разработчика → вкладка BlueStudz SDK. Выберите созданную игру или нажмите «Создать игру». Скопируйте два идентификатора:

Game ID

Публичный UUID вашей игры. Используется в заголовке x-bs-gameid.

Secret Token

Секретный ключ подписи. Используется для серверного подтверждения ачивок.

Шаг 2: Выбор сценария запуска

Сценарий А: Локальная разработка (Sandbox)

При запуске из редактора лаунчер отсутствует. Передайте тестовые переменные среды в конфигурацию запуска вашей IDE:

bash

BLUESTUDZ_API="https://api.bluestudz.ru"
BLUESTUDZ_GAME_ID="your-game-uuid"
BLUESTUDZ_LAUNCH_TOKEN="dev-mock-launch-token"

Сценарий Б: Боевой запуск через Launcher

BlueStudz Launcher автоматически передаёт одноразовый launch-токен через аргументы командной строки процесса:

bash

Game.exe --bs-token=<token> --bs-gameid=<uuid>

Шаг 3: Инициализация в SDK и обмен токенов

При старте игры SDK обменивает одноразовый launchToken на 30-минутный сессионный gameToken через эндпоинт POST /auth/game/verify, затем проверяет владение игрой:

bash

curl -X POST https://api.bluestudz.ru/auth/game/verify \
  -H "Content-Type: application/json" \
  -d '{"launchToken": "<YOUR_TOKEN>"}'

Шаг 4: Разблокировка первого достижения

После успешной авторизации отправьте запрос разблокировки достижения. Уведомление автоматически отобразится в оверлее лаунчера:

bash

curl -X POST https://api.bluestudz.ru/sdk/achievements/unlock \
  -H "Authorization: Bearer <USER_TOKEN>" \
  -H "x-bs-gameid: <GAME_ID>" \
  -H "x-bs-secrettoken: <SECRET_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"achievementId": "first_blood"}'

Правило безопасности: Никогда не коммитьте secretToken в публичные репозитории. Для мультиплеерных игр с выделенными серверами подтверждение достижений должно осуществляться исключительно с авторитетного сервера игры.