online (доступность устройства)

Обновлено 28 октября 2024

Тип данных: BOOL.

Способ использования: хранит состояние устройства, менять его не может.

Назначение: показывает статус доступности устройства:

• true — к устройству есть доступ и по сети. Устройством можно управлять, например, включить или выключить.
• false — устройство сейчас недоступно. Например, оно может быть обесточено.

Устройства с этой функцией

Это базовая функция, которая есть у всех устройств.

Примеры голосовых команд

— Салют, жалюзи сейчас онлайн?

— Салют, есть ли связь с лампой?

Обратите внимание, что если пользователь попробует отдать команду устройству, которое находится в офлайне, виртуальный ассистент ответит, что связи с устройством нет.

Описание функции в модели устройства

Функция должна быть добавлена в описания моделей всех поддерживающих ее устройств.

"features": [
    "online",
    // ...
 ]

Пример описания состояния функции

В примере состояние функции — онлайн, т. е. к устройству есть доступ по сети.

{
    "states": [
        {
            "key": "online",
            "value": {
                "type": "BOOL",
                "bool_value": true
            }
        }
    ]
}