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.

Um traço simplificado substitui um traço padrão da API Home, semelhante ao funcionamento do padrão de fachada. Os traços simplificados oferecem comandos que facilitam tarefas comuns para determinados tipos de dispositivos. Os traços simplificados são traços da API Home e, como outros traços da API Home, funcionam para 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:

Tabela: traços simplificados

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

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.