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 substitui uma característica padrão da API Home, de maneira semelhante ao funcionamento do padrão de fachada. Os atributos simplificados 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.

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

A tabela a seguir mostra cada atributo simplificado e os atributos padrão subjacentes. Cada nome de atributo está vinculado à documentação da API correspondente:

Tabela: atributos simplificados

Atributo simplificado	Atributo padrão
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Atributos simplificados e a API Discovery

A API Discovery informa atributos simplificados e os atributos padrão subjacentes, desde que ambos tenham sido configurados corretamente como ReferencedAutomationTypes na configuração do app. Por exemplo, se um dispositivo DimmableLightDeviceType estiver presente na estrutura e o desenvolvedor tiver registrado os atributos LevelControlTrait e BrightnessTrait, a API Discovery vai indicar a presença de ambos. O desenvolvedor pode usar qualquer um dos atributos na automação.

Consulte Configuração inicial para mais informações.