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 substitui uma característica padrão da API Home, semelhante ao funcionamento do padrão de fachada. Os comandos simplificados 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 em dispositivos Matter e Cloud-to-cloud.
Uma característica simplificada oferece um subconjunto alternativo de atributos e comandos que
são mais específicos do dispositivo do que os da característica padrão correspondente.
Por exemplo, a característica padrão
LevelControlTrait
é genérica e pode ser usada em qualquer dispositivo que tenha uma
configuração que varia continuamente em um intervalo de valores numéricos.
BrightnessTrait é uma
característica simplificada que substitui LevelControlTrait e fornece apenas os
comandos e atributos que um
dispositivo DimmableLightDeviceType
exige. O BrightnessTrait tem um comando
moveToBrightness
que usa um único argumento brightnessPercent, enquanto o
LevelControlTrait tem vários comandos move, a maioria com pelo menos
quatro parâmetros para atender a 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:
| Característica simplificada | Característica padrão |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Atributos simplificados 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 indicará a presença de ambas. O
desenvolvedor pode usar qualquer uma das características na automação.
Consulte Configuração da casa para mais informações.