Для работы с Alpha.Domain.Client на C++ необходим доступ к работающему экземпляру Alpha.Server с развернутой конфигурацией. Процесс настройки конфигурации в Alpha DevStudio описан в первой статье.

Alpha.Domain.Client\
├── include\cppclient\     ← заголовочные файлы C++ API
│   └── Alpha\Domain\
│       ├── Api\              ← интерфейсы (IModule, IService, ...)
│       └── Client\           ← клиентские обёртки
├── bin\                      ← скомпилированные DLL
│   ├── alpha.domain.client.dll  ← ядро компонента
│   └── tcp_transport.dll        ← TCP-транспорт
├── examples\                 ← примеры использования
└── doc\                      ← документация

// Способ 1: через командную строку (для текущей сессии)
set ALPHA_DOMAIN_CLIENT_INCLUDE_DIR=C:\Program Files\Automiq\Alpha.SDK\Alpha.Domain.Client\include\cppclient

// Способ 2: через Панель управления → Система → Переменные среды
// Добавьте системную переменную с именем ALPHA_DOMAIN_CLIENT_INCLUDE_DIR

Рекомендуется задать переменную через Панель управления — так она будет доступна для всех терминалов и IDE. Путь к проекту не должен содержать кириллицу.

# 1. Перейдите в директорию проекта
cd C:\Projects\alpha_domain_demo

# 2. Конфигурация проекта (CMake генерирует файлы сборки)
cmake -B .build

# 3. Сборка (компиляция и линковка)
cmake --build .build

# 4. Скопируйте DLL рядом с исполняемым файлом
copy "C:\...\Alpha.Domain.Client\bin\*.dll" .build\Debug\

# 5. Запуск
.build\Debug\alpha_domain_demo.exe

Используйте именно Developer Command Prompt for Visual Studio, а не обычную командную строку — иначе CMake не найдёт компилятор MSVC. Найти этот терминал можно через меню Пуск → Visual Studio → Developer Command Prompt.

// 1. Загрузка DLL → получаем IModule (точка входа)
ModuleLoader loader;
const auto module = loader.CreateModule();

// 2. IModule → IService (служба теговой модели)
Tag::BinboApi::IServicePtr service;
Alpha::auto_throw{ module->CreateTagService( service ) };

// 3. IService → IUnit (пул соединений)
Tag::BinboApi::IUnitPtr unit;
Alpha::auto_throw{ service->CreateUnit( unit ) };

// 4. Настройка TCP-подключения к Alpha.Server
auto settings = BinboHelper::MakeShared<ServerSettings>(
  3000,  // таймаут в миллисекундах
  TcpEndpoint{ "127.0.0.1", 4388 }  // адрес Alpha.Server
);

// 5. Создание узла подключения к Runtime
Tag::BinboApi::INodePtr node;
Alpha::auto_throw{ unit->CreateNodeConnection( node, settings, logger ) };

// 6. Приведение к IRuntimeNode и асинхронное подключение
auto runtimeNode = Alpha::Binbo::foreign_cast<
  Tag::BinboApi::IRuntimeNode>( node );

Async::BinboApi::IEmptyOperationPtr connectOp;
Alpha::auto_throw{ runtimeNode->ConnectAsync( connectOp ) };
Utils::ScheduleAndWaitAsyncOperation( connectOp );

Конструкция Alpha::auto_throw{} — это обёртка для обработки ошибок. Если операция завершается с ошибкой, автоматически генерируется исключение C++. Это аналог try/except из Python-версии Alpha.Domain.Client.

// Получаем элемент по имени и инициализируем
auto item = runtimeNode->GetItem( "Object.Parameter" );
Alpha::auto_throw{ item->Init() };

// Читаем текущее значение (VQT)
VqtStorage vqt;
Alpha::auto_throw{ item->GetValue( BinboHelper::VqtReference{ vqt } ) };

// Определяем тип и выводим значение
switch( vqt.Value.Kind() ) {
  case ValueKind::UInt32:
      std::cout << vqt.Value.Get<uint32_t>(); break;
  case ValueKind::Float64:
      std::cout << vqt.Value.Get<double>(); break;
  // ... остальные типы
}

// Определяем тип элемента → создаём значение того же типа
ValueKind kind = vqt.Value.Kind();
ValueStorage newValue = MakeTypedValue( kind, 42.0 );

// Асинхронная запись
Async::BinboApi::IEmptyOperationPtr writeOp;
Alpha::auto_throw{ item->SetValueAsync( writeOp, newValue ) };
Utils::ScheduleAndWaitAsyncOperation( writeOp );

// 1. Подписка на изменения → получаем канал данных (Pipe)
BinboApi::IVqtPipePtr pipe;
Alpha::auto_throw{ item->SubscribeValueChange( pipe ) };

// 2. Запуск фонового потока для чтения обновлений
Utils::BackgroundPipeReader reader;
reader.Run<VqtStorage>( pipe, &PrintVqt );
//                              ^^^^^^^^
//              ваша функция-обработчик обновлений

// 3. Основной поток продолжает работу...
//    Например, записываем новое значение
item->SetValueAsync( op, newValue );

// 4. Остановка подписки
reader.Stop();