Características simplificadas no iOS

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Para facilitar o uso, versões simplificadas de alguns atributos 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 traços simplificados fornecem comandos que facilitam tarefas comuns em determinados tipos de dispositivos. Os atributos simplificados são atributos da API Home e, como outros atributos da API Home, funcionam em dispositivos Matter e Cloud-to-cloud.

Um recurso simplificado oferece um subconjunto alternativo de atributos e comandos que é mais específico do dispositivo do que o recurso padrão correspondente. Por exemplo, o tipo LevelControlTrait padrão é um tipo genérico que pode ser usado 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 requer. BrightnessTrait tem um comando moveToBrightness que recebe 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 tem um link para a documentação da API correspondente:

Tabela: características simplificadas

Característica simplificada	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 delas, 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 um dos dois atributos na automação.

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