Шаг 4. Добавление моделей устройств
Если у вас много одинаковых устройств, опишите их модели в своем проекте Studio. Вы сможете использовать эти модели при добавлении устройств на контроллерах клиентов: достаточно будет выбрать модель устройства, и шаблонный список его функций подставится автоматически. Функции не придется выбирать вручную.
О том, какими полями описываются модели в API умного дома, можно прочитать в разделе Модель устройства (model). Это поможет вам при добавлении моделей в Studio: вам нужно будет описать те же поля, только через интерфейс.
В Studio откройте проект интеграции.
На вкладке
в правом верхнем углу нажмите Создать модель.В поля формы введите характеристики и функции модели:
Идентификатор модели. Идентификатор модели (часто product_id).
Производитель. Производитель устройства.
Название модели. Название модели у производителя.
Версия оборудования. Версия аппаратного модуля.
Версия прошивки. Версия прошивки аппаратного модуля.
Описание. Произвольное описание устройства.
Категория устройства. К какой категории относится модель устройства.
Список функций. Функции модели устройства: что устройства этой модели умеют делать. Набор доступных функций зависит от категории устройства, подробнее смотрите в разделе Функции устройств.
Зависимости функций. В этом блоке описываются случаи, когда одна функция доступна, только если другая находится в определенном состоянии. Например, цветные лампы некоторых моделей могут работать в двух режимах: цветном и режиме белого света. В зависимости от того, какой режим выбрал пользователь, должен меняться и состав доступных функций: если выбран цветной режим — должна стать доступной функция смены цвета лампы; если выбран режим белого света — функция выбора цвета должна заблокироваться.
В списке Функция выберите зависимую функцию — ее доступность зависит от другой функции. В списке зависит от выберите определяющую функцию — от ее состояния зависит зависимая функция. В последнем раскрывающемся списке выберите значения определяющей функции, при которых зависимая функция становится доступной.
Подробнее о зависимостях см. в разделе Зависимость функций (dependencies).
Нажмите Создать модель.
Пример описания модели
В примере описано реле, которое может по удаленной команде включать и выключать питание присоединенного прибора, а также умеет измерять энергопотребление. У функций реле нет зависимостей.
Идентификатор модели: QWERTY124
Производитель: Xiaqara
Название модели: SM1123456789
Версия оборудования: 3.1
Версия прошивки: 5.6
Описание: Умное реле Xiaqara
Категория устройства: relay
Список функций: online, on_off, current, power, voltage