Características simplificadas no iOS

Para facilitar o uso, versões simplificadas de algumas características estão disponíveis para uso com a API Automation no iOS.

Uma característica simplificada representa uma característica padrão da API Home, semelhante ao funcionamento do padrão de fachada funciona. As características simplificadas fornecem comandos que facilitam tarefas comuns para determinados tipos de dispositivos. As características simplificadas são características da API Home e, como outras características da API Home, funcionam para dispositivos Matter e Cloud-to-cloud.

Uma característica simplificada oferece um subconjunto alternativo de atributos e comandos mais específicos do dispositivo do que os da característica padrão correspondente. Por exemplo, a característica padrão LevelControlTrait é uma característica genérica que pode ser usada para qualquer dispositivo que tenha uma configuração que varia continuamente em um intervalo de valores numéricos. BrightnessTrait é uma característica simplificada que representa LevelControlTrait e fornece apenas os comandos e atributos que um DimmableLightDeviceType dispositivo exige. BrightnessTrait tem um moveToBrightness comando que usa um único brightnessPercent argumento, enquanto LevelControlTrait tem vários move comandos, a maioria deles com pelo menos quatro parâmetros para acomodar uma variedade maior de casos de uso.

A tabela a seguir mostra cada característica simplificada e as características padrão subjacentes. Cada nome de característica tem um link para a documentação da API correspondente:

Tabela: características simplificadas

Característica simplificada	Característica padrão
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Características simplificadas e a API Discovery

A API Discovery informa características simplificadas e as características padrão subjacentes, desde que ambas tenham sido configuradas corretamente como ReferencedAutomationTypes na configuração do app. Por exemplo, se um dispositivo DimmableLightDeviceType estiver presente na estrutura e o desenvolvedor tiver registrado as características LevelControlTrait e BrightnessTrait, a API Discovery vai indicar a presença de ambas. O desenvolvedor pode escolher usar qualquer uma das características na automação.

Consulte Configuração da casa para mais informações.