4.1.3.3.2. Сервисные сигналы
Сервисные сигналы сгруппированы в узле Service в папке Imitation.
Управление сессией
Тег сигнала
|
Тип
|
Описание и использование
|
BeginSession
|
Uint1
|
Начать новую сессию воспроизведения истории:
0 – Режим плеера истории
|
EndSession
|
Bool
|
Завершить сессию воспроизведения истории:
true – закрыть сессию
|
Управление загрузкой и проигрыванием
Тег сигнала
|
Тип
|
Описание и использование
|
IntervalStart
|
String
|
Метка времени начала интервала проигрывания.
Задается в формате datetime_json. Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: "" – левая граница отсутствует
|
SetIntervalStart
|
String
|
Задать метку времени начала интервала проигрывания.
Задается в формате datetime_json
|
IntervalEnd
|
String
|
Метка времени конца интервала проигрывания.
Задается в формате datetime_json. Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: "" – правая граница отсутствует
|
SetIntervalEnd
|
String
|
Задать метку времени конца интервала проигрывания.
Задается в формате datetime_json
|
Filter
|
String
|
Фильтр по тегам.
Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: "" – все теги
|
SetFilter
|
String
|
Установить фильтр по тегам
|
DataLoaded
|
Uint1
|
Процент готовности данных к проигрыванию
|
LastError
|
String
|
Последняя ошибка
|
Параметры имитации
Тег сигнала
|
Тип
|
Описание и использование
|
LoadData
|
Bool
|
Загрузить данные для проигрывания:
true – загрузить данные
Загрузка возможна только в рамках открытой сессии
|
SetSpeed
|
Float
|
Установить скорость проигрывания.
Делитель времени ожидания между точками имитации. Сбрасывается после установки сигналов EndSession и BeginSession
|
SetCurrent
|
String
|
Установить текущее положение процесса проигрывания.
Перемещает текущую метку проигрывания на заданную. Задаётся в формате datetime_json. Сбрасывается после установки сигналов EndSession и BeginSession
|
SetState
|
Uint1
|
Управление состоянием проигрывания:
0 – пауза;
1 – проигрывание
Проигрывание возможно после полной загрузки данных
|
Cancel
|
Bool
|
Отменить результаты имитации:
true – отменить.
|
Commit
|
Bool
|
Применить результаты имитации:
true – применить.
|
GetOverriden
|
Bool
|
Запросить список переопределяемых тегов
true – запросить.
|
GetOverridenResponse
|
String
|
Список переопределяемых тегов
|
Override
|
String
|
Задать перезаписываемые сигналы
|
ReadHistory
|
String
|
Запросить список исторических значений
|
ReadHistoryResponse
|
String
|
Список исторических значений
|
ReadOverriden
|
String
|
Запросить список переопределяемых значений
|
ReadOverridenResponse
|
String
|
Список переопределяемых значений
|
SetFilter
|
String
|
Установить фильтр по тегам
|
Контроль текущего состояния сессии проигрывания
Тег сигнала
|
Тип
|
Описание и использование
|
DataLoaded
|
Uint1
|
Процент загруженных данных от 0 до 100.
Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: 0
|
Current
|
String
|
Текущее положение процесса проигрывания.
Отображается в формате datetime_json. Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: ""
|
Speed
|
Float
|
Скорость проигрывания.
Делитель времени ожидания между точками имитации. Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: 1
|
State
|
Uint1
|
Статус проигрывания:
0 – проигрывание остановлено или завершено;
1 – проигрывание
Сбрасывается после установки сигналов EndSession и BeginSession.
Значение по умолчанию: 0
|
SessionInProgress
|
Bool
|
Флаг наличия активной сессии.
Устанавливается после установки сигнала BeginSession, сбрасывается после установки сигнала EndSession.
Значение по умолчанию: false
|
Формат datetime_json
Метка времени задаётся и отображается по времени UTC в сервисных сигналах в формате datetime_json и имеет вид:
{"y":<uint>,"mo":<uint>,"d":<uint>,"h":<uint>,"m":<uint>,"s":<uint>,"ms":<uint>}
|
где:
у – год;
mo – месяц;
d – день;
h – часы;
m – минуты;
s – секунды;
ms – миллисекунды.
Заполнение всех полей необязательно, при этом для пропущенных полей метки времени применяется текущая дата и время 00:00:00.000.
|
Метка времени 08.12.2023 10:12:15.2:
{"y":2023,"mo":12,"d":8,"h":5,"m":12,"s":15,"ms":2}
|