Для удобства использования в iOS для API автоматизации доступны упрощенные версии некоторых характеристик.
Упрощенный трейт заменяет стандартный трейт Home API, подобно тому, как работает шаблон фасада . Упрощенные трейты предоставляют команды, которые упрощают выполнение распространенных задач для определенных типов устройств. Упрощенные трейты являются трейтами Home API и, как и другие трейты Home API, работают как для устройств Matter , так и для устройств, Cloud-to-cloud .
Упрощенный трейт предлагает альтернативный набор атрибутов и команд, более специфичный для конкретного устройства, чем соответствующий стандартный трейт. Например, стандартный трейт LevelControlTrait — это универсальный трейт, который можно использовать для любого устройства, имеющего параметр, непрерывно изменяющийся в диапазоне числовых значений. BrightnessTrait — это упрощенный трейт, заменяющий LevelControlTrait и предоставляющий только те команды и атрибуты, которые необходимы устройству DimmableLightDeviceType . У BrightnessTrait есть команда moveToBrightness , которая принимает один аргумент brightnessPercent , тогда как LevelControlTrait есть несколько команд move , большинство из которых имеют как минимум четыре параметра для охвата более широкого спектра вариантов использования.
В следующей таблице показаны каждый упрощенный признак и лежащие в его основе стандартные признаки. Каждое название признака содержит ссылку на соответствующую документацию API:
| Упрощенный признак | Стандартный признак |
|---|---|
SimplifiedThermostatTrait | ThermostatTrait |
BrightnessTrait | LevelControlTrait |
SimplifiedOnOffTrait | OnOffTrait |
VolumeTrait | LevelControlTraitOnOffTrait |
Упрощенные характеристики и API обнаружения
API Discovery сообщает об упрощенных характеристиках, а также об их базовых стандартных характеристиках, при условии, что обе характеристики были корректно настроены как ReferencedAutomationTypes в конфигурации вашего приложения. Например, если в структуре присутствует устройство DimmableLightDeviceType , и разработчик зарегистрировал как характеристики LevelControlTrait , так и BrightnessTrait , API Discovery укажет на наличие обеих характеристик. Разработчик может выбрать любую из них для использования в своей автоматизации.
Дополнительную информацию см. в разделе «Настройка домашней папки» .