Esquema da característica de rotação de casa inteligente
action.devices.traits.Rotation
: esta característica pertence a dispositivos compatíveis com rotação.
A rotação pode ser especificada em porcentagem ou graus e, se o dispositivo for compatível com a rotação por graus, a direção padrão da rotação será no sentido horário.
ATRIBUTOS do dispositivo
Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC
. Para saber
mais sobre como lidar com intents SYNC
, consulte
fulfillment de intent.
Atributos | Tipo | Descrição |
---|---|---|
supportsDegrees |
Booleano |
Obrigatório. Defina como "true" se o dispositivo permitir rotação por grau. |
supportsPercent |
Booleano |
Obrigatório. Definido como "true" se o dispositivo permitir a rotação em porcentagem |
rotationDegreesRange |
Object |
Representar o intervalo de graus que um dispositivo pode girar. |
rotationDegreesMin |
Número |
Obrigatório. Rotação mínima em graus. |
rotationDegreesMax |
Número |
Obrigatório. Rotação máxima em graus. |
supportsContinuousRotation |
Booleano |
Padrão: Defina como verdadeiro se o dispositivo permitir rotação contínua. Quando uma consulta relativa é fornecida, o comando |
commandOnlyRotation |
Booleano |
Padrão: Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou a um estado de relatório para essa característica. |
Exemplos
Dispositivo compatível com rotação em porcentagem e graus.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
Dispositivo que só oferece suporte à rotação em graus.
{ "supportsDegrees": true, "supportsPercent": false, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 90 } }
Dispositivo compatível apenas com comandos de rotação contínua.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 360 }, "supportsContinuousRotation": true, "commandOnlyRotation": true }
STATES do dispositivo
As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY
. Para saber
mais sobre como lidar com intents QUERY
, consulte
fulfillment de intent.
Estados | Tipo | Descrição |
---|---|---|
rotationDegrees |
Número |
Nível atual em |
rotationPercent |
Número |
Nível atual que indica a porcentagem de rotação do dispositivo no momento. 0,0 corresponde a fechado e 100.0 a abrir. |
Exemplos
Quanto o dispositivo é girado? (porcentagens e graus).
{ "rotationDegrees": 45, "rotationPercent": 25 }
Quanto o dispositivo é girado? (apenas graus).
{ "rotationDegrees": 45 }
Quanto o dispositivo é girado? (contínua).
{ "rotationDegrees": 270, "rotationPercent": 75 }
Dispositivo COMMANDS
Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE
. Para saber
mais sobre como lidar com intents EXECUTE
, consulte
fulfillment de intent.
action.devices.commands.RotateAbsolute
Define a rotação absoluta do dispositivo.
Parâmetros
O payload contém um dos seguintes itens:
Defina a rotação absoluta em graus.
Parâmetros | Tipo | Descrição |
---|---|---|
rotationDegrees |
Número |
Obrigatório. Um valor absoluto, em graus, que especifica a rotação final no sentido horário do dispositivo. O valor precisa estar dentro do atributo |
Defina a rotação absoluta em porcentagem.
Parâmetros | Tipo | Descrição |
---|---|---|
rotationPercent |
Número |
Obrigatório. Um valor absoluto, em porcentagem, que especifica a rotação final do dispositivo. |
Exemplos
Incline o dispositivo para 50%.
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationPercent": 50 } }
Gire o dispositivo 15 graus no sentido anti-horário (rotationDegrees: 45
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 30 } }
Gire o dispositivo 100 graus no sentido horário (supportsContinuousRotation: true
, rotationDegrees: 270
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 10 } }
Erros relacionados
Ocorreu um erro ao configurar a rotação do dispositivo.
Os valores suportados são:
deviceJammingDetected