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: false. Definido como verdadeiro se o dispositivo permitir rotação contínua. Quando recebe uma consulta relativa, o comando RotateAbsolute envolve o intervalo de rotação compatível.
commandOnlyRotation	Booleano	Padrão: false. 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 rotationDegreesRange que indica em quantos graus o dispositivo é girado. Esse valor precisa ser sempre relativo à rotação no sentido horário.
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 rotationDegreesRange.

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

ERROS DO Dispositivo

Veja a lista completa de erros e exceções.