SteamConnectionSystem

Namespace: Vortex.Steam.SteamConnectionSystem Сборка: ru.vortex.steam.connection Платформа: Unity 2021.3+, Steamworks.NET Условная компиляция: код за #if USING_STEAM, сборка без defineConstraints

---

Назначение

Подключение к Steamworks API. Инициализирует Steam-клиент, предоставляет глобальное состояние подключения и данные текущего пользователя (профиль, список друзей) через статическую шину SteamBus.

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

• SteamBus — статическая шина: SteamEnabled, IsInitialized, IsLoaded, User, события OnCallServices/OnLoaded
• SteamManager — MonoBehaviour-синглтон: SteamAPI.Init(), RunCallbacks(), Shutdown()
• SteamUserData / SteamUserShortData — модели данных пользователя и друзей
• SteamConnectionSettings — ScriptableObject-конфигурация: steamAppId, isEnabled, isTestBuild
• DefineSymbolManager — автоматическое управление символом USING_STEAM в PlayerSettings
• Settings — загрузка/создание ассета настроек, синхронизация steam_appid.txt

Вне ответственности:

• Достижения — пакет SteamAchievements
• Мультиплеер, матчмейкинг, лобби
• Покупки, DLC, инвентарь

---

Зависимости

---

Архитектура

SteamBus (static)
  ├── SteamEnabled: const bool          ← #if USING_STEAM: true, иначе false
  ├── IsInitialized: bool               ← SteamAPI.Init() прошёл успешно
  ├── IsLoaded: bool                    ← данные пользователя загружены
  ├── User: SteamUserData               ← профиль + друзья
  ├── OnCallServices: Action            ← сигнал для подписчиков загрузить свои данные
  └── OnLoaded: Action

SteamManager : MonoBehaviour (singleton)
  ├── [RuntimeInitializeOnLoadMethod] Init()
  │   └── new GameObject("SteamManager").AddComponent<SteamManager>()
  ├── Awake()
  │   ├── Packsize.Test() / DllCheck.Test() → Debug.LogError при несовпадении версий
  │   ├── RestartAppIfNecessary(AppId) → Application.Quit() если не через Steam
  │   ├── SteamAPI.Init() → m_bInitialized
  │   ├── Callback<UserStatsReceived_t>.Create()
  │   ├── SteamBus.IsInitialized = true
  │   └── LoadStatsInBus()
  │       ├── SteamBus.LoadServices() → OnCallServices
  │       ├── SteamBus.User.Init(steamId)
  │       └── SteamBus.IsLoaded = true
  ├── Update() → SteamAPI.RunCallbacks()
  └── OnDestroy() → SteamAPI.Shutdown()

SteamUserData : SteamUserShortData
  ├── SteamID: CSteamID
  ├── Name: string
  ├── Friends: Dictionary<CSteamID, SteamUserShortData>
  ├── OnUpdated: Action
  └── Init(steamId) → загрузка профиля и списка друзей

SteamUserShortData
  ├── SteamID: CSteamID
  ├── Name: string
  └── GetShortData(steamId) → factory

SteamConnectionSettings : ScriptableObject
  ├── steamAppId: uint (default 480)
  ├── isEnabled: bool                   ← [OnValueChanged("OnSteamEnabledChanged")] → DefineSymbolManager.Refresh()
  ├── isTestBuild: bool                 ← пропускает RestartAppIfNecessary
  └── OnAppUdChanged() → File.WriteAllText("steam_appid.txt")

DefineSymbolManager (Editor-only)
  ├── [InitializeOnLoadMethod] Refresh()
  └── ApplyDefineSymbol(bool, "USING_STEAM") → PlayerSettings

Settings (internal)
  ├── GetSettings() → Resources.LoadAll / CreateAsset
  └── [InitializeOnLoadMethod] CheckSteamAppId() → синхронизация steam_appid.txt

Порядок инициализации

1. DefineSymbolManager.Refresh() — при загрузке Editor устанавливает/удаляет USING_STEAM
2. Settings.CheckSteamAppId() — синхронизирует steam_appid.txt с ассетом настроек
3. SteamManager.Init() — RuntimeInitializeOnLoadMethod, создаёт GameObject
4. SteamManager.Awake() — Packsize.Test()/DllCheck.Test(), затем RestartAppIfNecessary, SteamAPI.Init(), загрузка данных пользователя
5. SteamBus.LoadServices() — OnCallServices для подписчиков (например, AchievementsController)

Условная компиляция

Сборка ru.vortex.steam.connection не имеет defineConstraints — компилируется всегда. Весь Steamworks-код внутри #if USING_STEAM. Без символа SteamBus.SteamEnabled = false, IsInitialized не может стать true. Это позволяет другим сборкам ссылаться на SteamBus без зависимости от Steamworks.

Безопасный режим без Steam

При isTestBuild = true пропускается RestartAppIfNecessary() — приложение не перезапускается через Steam-клиент. Используется для отладки из редактора.

---

Контракт

Вход

• SteamConnectionSettings в Resources/Editor/ — steamAppId, isEnabled, isTestBuild
• Steamworks.NET подключён к проекту
• Steam-клиент запущен на машине

Выход

• SteamBus.IsInitialized — Steam API инициализирован
• SteamBus.IsLoaded — данные пользователя загружены
• SteamBus.User — профиль, имя, список друзей
• SteamBus.OnCallServices — момент для загрузки зависимых сервисов

API

Ограничения

---

Использование

Настройка проекта

1. Подключите Steamworks.NET к проекту
2. Откройте SteamConnectionSettings в Resources/Editor/ (создаётся автоматически)
3. Укажите steamAppId вашего приложения
4. Включите isEnabled — символ USING_STEAM добавится автоматически
5. Для отладки без Steam-клиента включите isTestBuild

Чтение данных пользователя

if (SteamBus.IsLoaded)
{
    var name = SteamBus.User.Name;
    var friends = SteamBus.User.Friends;
}

Подписка на загрузку сервисов

// Подключение к моменту инициализации Steam
SteamBus.OnCallServices += LoadMyService;

// Подписка на обновление статистики
SteamBus.User.OnUpdated += OnStatsReceived;

Условная компиляция в игровом коде

#if USING_STEAM
    SteamBus.User.UnlockAchievement("ACH_001");
#endif

// Или через const:
if (SteamBus.SteamEnabled)
    DoSteamStuff();

---

Граничные случаи