Упрощенные особенности на устройствах iOS

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

Упрощенный типаж заменяет стандартный типаж 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	LevelControlTrait OnOffTrait

Упрощенные признаки и Discovery API

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

Подробнее о настройке главного экрана…