Упрощенные черты на iOS

Для удобства использования упрощенные версии некоторых признаков доступны для использования с API автоматизации на iOS.

Упрощённый трейт заменяет стандартный трейт Home API, аналогично принципу работы шаблона «фасад» . Упрощённые трейты предоставляют команды, упрощающие выполнение распространённых задач для определённых типов устройств. Упрощённые трейты — это трейты Home API, и, как и другие трейты Home API, они работают как для устройств Matter , так и для устройств Cloud-to-cloud .

Упрощённый трейт предлагает альтернативный набор атрибутов и команд, более специфичный для конкретного устройства, чем соответствующий стандартный трейт. Например, стандартный трейт LevelControlTrait — это общий трейт, который можно использовать для любого устройства с настройкой, изменяющейся в диапазоне числовых значений. BrightnessTrait — это упрощённый трейт, заменяющий LevelControlTrait и предоставляющий только те команды и атрибуты, которые требуются устройству DimmableLightDeviceType . BrightnessTrait имеет команду moveToBrightness , принимающую один аргумент brightnessPercent , тогда как LevelControlTrait имеет несколько команд move , большинство из которых имеют не менее четырёх параметров для более широкого спектра вариантов использования.

В следующей таблице представлены все упрощённые и базовые стандартные черты. Каждое название черты ссылается на соответствующую документацию API:

Упрощенные характеристики и API Discovery

Discovery API сообщает как об упрощённых, так и об их базовых стандартных свойствах, если оба свойства были правильно настроены как ReferencedAutomationTypes в конфигурации вашего приложения. Например, если в структуре присутствует устройство DimmableLightDeviceType , и разработчик зарегистрировал свойства LevelControlTrait и BrightnessTrait , Discovery API укажет наличие обоих свойств. Разработчик может выбрать любое из них для автоматизации.

Более подробную информацию см. в разделе «Конфигурация дома» .