Esta é a Central do desenvolvedor do Google Home, o novo destino para aprender a desenvolver ações de casa inteligente. Observação:você continuará criando ações no Console do Actions.

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: false.

Defina como verdadeiro se o dispositivo permitir rotação contínua. Quando uma consulta relativa é fornecida, o comando RotateAbsolute encapsula 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 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 rotationDegreesRange que indica em quantos graus o dispositivo foi girado. Esse valor sempre deve ser 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? (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 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 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
  }
}

Ocorreu um erro ao configurar a rotação do dispositivo.

Os valores suportados são:

deviceJammingDetected

Dispositivo ERRORS

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