Esquema do traço de rotação da casa inteligente
action.devices.traits.Rotation
: essa característica pertence a dispositivos que oferecem suporte à rotação.
A rotação pode ser especificada em porcentagem ou em graus. Se o dispositivo permitir a rotação por graus, a direção padrão será no sentido horário.
ATRIBUTOS do dispositivo
Dispositivos com essa característica podem informar os seguintes
atributos como parte da operação SYNC
. Para saber
mais sobre o gerenciamento de intents SYNC
, consulte
fulfillment de intents.
Atributos | Tipo | Descrição |
---|---|---|
supportsDegrees |
Booleano |
Obrigatório. Definido como verdadeiro se o dispositivo permitir rotação por grau. |
supportsPercent |
Booleano |
Obrigatório. Definido como verdadeiro se o dispositivo permitir rotação por porcentagem |
rotationDegreesRange |
Object |
Representa o intervalo em 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: Definido como verdadeiro se o dispositivo permitir rotação contínua. Quando recebe uma consulta relativa, o comando |
commandOnlyRotation |
Booleano |
Padrão: Indica se o dispositivo oferece suporte ao 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 ao estado do relatório dessa característica. |
Exemplos
Dispositivo que oferece suporte à rotação em porcentagem e graus.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
Dispositivo que só permite rotação em graus.
{ "supportsDegrees": true, "supportsPercent": false, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 90 } }
Dispositivo que só aceita comandos de rotação contínua.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 360 }, "supportsContinuousRotation": true, "commandOnlyRotation": true }
STATES do dispositivo
Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY
. Para saber
mais sobre o gerenciamento de intents QUERY
, consulte
fulfillment de intents.
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. 0,0 corresponde a fechado e 100,0 a aberto. |
Exemplos
Qual é a rotação do dispositivo? (porcentagem e graus).
{ "rotationDegrees": 45, "rotationPercent": 25 }
Qual é a rotação do dispositivo? (apenas graus).
{ "rotationDegrees": 45 }
Qual é a rotação do dispositivo? (contínuo).
{ "rotationDegrees": 270, "rotationPercent": 75 }
Comandos do dispositivo
Dispositivos com essa característica podem responder aos seguintes
comandos como parte da operação EXECUTE
. Para saber
mais sobre o gerenciamento de intents EXECUTE
, consulte
fulfillment de intents.
action.devices.commands.RotateAbsolute
Define a rotação absoluta do dispositivo.
Parâmetros
O payload contém um dos seguintes itens:
Define 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 em 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