github.com/e154/smart-home@v0.17.2-0.20240311175135-e530a6e5cd45/doc/content/ru/docs/dashboard/entity.md (about)

     1  ---
     2  title: "Entity"
     3  linkTitle: "Entity"
     4  date: 2021-11-20
     5  description: >
     6  
     7  ---
     8  
     9  {{< figure src="/smart-home/img/entity.svg" >}}
    10  
    11  Это простая схема, которая представляет объект "Entity". 
    12  Каждый компонент имеет свою роль и функциональность в управлении и мониторинге объекта "Entity" в умном доме.
    13  
    14  Объект "Entity" является центральным элементом системы Smart Home и объединяет различные аспекты объекта, его состояния, 
    15  атрибутов, действий, настроек и метрик. Это позволяет системе эффективно управлять и контролировать объекты в умном доме.
    16  
    17  Вот подробное описание компонентов объекта "Entity":
    18  
    19  1. Actions (Действия): Объект "Entity" может принимать и обрабатывать различные действия или команды. Действия представляют 
    20  собой операции, которые можно выполнить над объектом, такие как включение, выключение, изменение параметров и т.д.
    21  
    22  2. State (Состояние): Объект "Entity" имеет список состояний, в которые он может переходить. В каждый конкретный момент 
    23  времени объект может находиться только в одном состоянии. Примеры состояний могут включать "Включено", "Выключено", 
    24  "Режим ожидания", "Воспроизведение" и т.д.
    25  
    26  3. Attributes (Атрибуты): Атрибуты представляют собой хранилище состояния объекта. Это заранее определенный перечень 
    27  полей и свойств, который содержит информацию о текущем состоянии объекта. Атрибуты могут быть представлены в виде map[string]any, 
    28  где ключ - имя атрибута, а значение - соответствующее значение атрибута.
    29  
    30  4. Settings (Настройки): Настройки объекта "Entity" представляют собой неизменяемый заранее определенный перечень полей и свойств.
    31  Они определяют конфигурационные параметры объекта, которые могут быть установлены во время его настройки. Настройки также могут 
    32  быть представлены в виде map[string]any.
    33  
    34  5. Metrics (Метрики): Метрики объекта "Entity" представляют собой информацию о его атрибутах или состоянии, которая используется 
    35  для мониторинга и измерения производительности или поведения объекта. Метрики могут включать такие данные, как среднее значение 
    36  атрибута, количество изменений состояния и т.д.
    37  
    38  6. Storage (Хранилище): Хранилище объекта "Entity" предоставляет историю изменений его состояния или атрибутов. Оно записывает 
    39  и сохраняет предыдущие значения, позволяя отслеживать и анализировать историю изменений объекта. Хранилище может использоваться 
    40  для отображения графиков, аналитики или выполнения других операций с историческими данными объекта.
    41  
    42  Объект "Entity" собирает все эти компоненты вместе, обеспечивая унифицированный и гибкий подход
    43  к управлению и мониторингу различных устройств и систем в умном доме.
    44  
    45  В системе Smart Home каждый объект "Entity" реализован на основе определенного плагина. Плагины предоставляют различные
    46  функциональности и возможности для объектов "Entity" в системе. Некоторые популярные плагины, которые могут быть 
    47  использованы для создания объектов "Entity", включают плагины sensor, mqtt, weather, automation, и другие.
    48  
    49  Когда создается новый объект "Entity", он связывается с определенным плагином, который определяет его функциональность и
    50  возможности. Например, если объект "Entity" представляет собой датчик, то для его реализации может использоваться плагин 
    51  sensor. Если объект "Entity" предназначен для взаимодействия с брокером MQTT, то для него может быть использован плагин mqtt.
    52  
    53  Каждый плагин предоставляет свои собственные хэндлеры (обработчики) и методы, которые позволяют объектам "Entity" выполнять 
    54  определенные действия, получать данные, отправлять сообщения и т.д.
    55  
    56  {{< figure src="/smart-home/img/entity_plugins.svg" >}}
    57  
    58  На схеме представлена общая структура связи между объектами "Entity", плагинами и компонентом автоматизации в системе Smart Home.
    59  
    60  1. Smart Home является центральной частью системы и координирует взаимодействие между всеми компонентами.
    61  2. Объекты "Entity" представляют конкретные устройства, датчики или другие компоненты в системе. Каждый объект "Entity" может использовать определенный плагин для своей реализации.
    62  3. Плагины предоставляют функциональность и возможности для объектов "Entity". Они содержат логику и методы, которые позволяют объектам "Entity" взаимодействовать с внешними устройствами, собирать данные, отправлять команды и т.д.
    63  4. Компонент автоматизации отвечает за создание сценариев и запуск определенных действий на основе условий и триггеров. Он может использовать объекты "Entity" и их плагины для определения условий, триггеров и действий в сценариях.
    64  
    65  Такая структура позволяет системе Smart Home быть гибкой и расширяемой, так как новые плагины и объекты "Entity" могут быть добавлены, 
    66  а компонент автоматизации может использовать их для создания разнообразных сценариев и автоматизации действий.