/Methods/CreatePlayerSubscription

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Проигрывание истории >

/Methods/CreatePlayerSubscription

Создаёт пустую подписку проигрывателя и возвращает новый subscriptionId.

HTTP: POST /Methods/CreatePlayerSubscription

Запрос

{
  "sessionId": 123456789
}

Поля запроса

Поле

Тип

Обязательное

Описание

sessionId

integer

условно

Нужен, если сессия не передана заголовком Session-Id

Других полей обработчик не читает.

Ответ

{
  "subscriptionId": 1,
  "code": 0
}

Поля ответа

Поле

Тип

Описание

subscriptionId

integer

Новый идентификатор подписки; счётчик растёт до перезапуска процесса

code

integer

0 при успешном создании

Поведение и ограничения

Подписка не содержит параметров до вызова AddSubscriptionItem.

Текущая реализация не запускает _activityTimer, не задаёт _lifetimeInterval и не обновляет _changeToSlaveCounter, унаследованные от BaseSubscription.

Фоновая очистка выполняется раз в 10 секунд. Из-за нулевого срока жизни и незапущенного таймера новая подписка признаётся неактивной на ближайшем проходе очистки и удаляется — обычно не позднее чем через 10 секунд после создания. Остальные методы таймер также не перезапускают.

Отдельного DeletePlayerSubscription нет. Предусмотренная автоматическая очистка сейчас одновременно служит единственным удалением и делает нормальный жизненный цикл подписки ненадёжным.