Esquema de características de rotação inteligente de casas

action.devices.traits.Rotation: essa característica pertence a dispositivos compatíveis com a 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

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como processar 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. Defina como "true" se o dispositivo permitir a 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. Defina como "true" se o dispositivo permitir rotação contínua. Quando uma consulta relativa é feita, o comando RotateAbsolute envolve o intervalo de rotação compatível.
commandOnlyRotation	Booleano	Padrão: false. 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 grau.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

Dispositivo com suporte apenas à rotação em graus

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

Dispositivo com suporte apenas aos 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 relatar os estados a seguir como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte fulfillment de intent.

Estados	Tipo	Descrição
rotationDegrees	Número	Nível atual em rotationDegreesRange, que indica 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 no momento. 0,0 corresponde a fechado e 100,0 a abrir.

Exemplos

Quanto o dispositivo é girado? (porcentagem e grau).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

Quanto o dispositivo é girado? (graus).

{
  "rotationDegrees": 45
}

Quanto o dispositivo é girado? (contínua).

{
  "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 como processar 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:

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 do sentido horário do dispositivo. O valor precisa estar no 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 até 50%.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

Gire o dispositivo em 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 definir a rotação do dispositivo.

Os valores suportados são:

deviceJammingDetected

Dispositivo ERRORS

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