Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema di rotazione della smart home

action.devices.traits.Rotation: questa caratteristica appartiene ai dispositivi che supportano la rotazione.

La rotazione può essere specificata in percentuale o in gradi e, se il dispositivo supporta la rotazione in gradi, la direzione di rotazione predefinita è in senso orario.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi Tipo Descrizione
supportsDegrees Booleano

Obbligatorio.

Impostato su true se il dispositivo consente la rotazione in gradi.

supportsPercent Booleano

Obbligatorio.

Impostato su true se il dispositivo consente la rotazione in percentuale

rotationDegreesRange Oggetto

Rappresenta l'intervallo in gradi che un dispositivo può ruotare.

rotationDegreesMin Number

Obbligatorio.

Rotazione minima in gradi.

rotationDegreesMax Number

Obbligatorio.

Rotazione massima in gradi.

supportsContinuousRotation Booleano

(Valore predefinito: false)

Impostato su vero se il dispositivo consente la rotazione continua. Quando a una query relativa viene assegnato un valore, il comando RotateAbsolute aggrega l'intervallo di rotazione supportato.

commandOnlyRotation Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.

Esempi

Dispositivo che supporta la rotazione in percentuale e in gradi.

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

Dispositivo che supporta solo la rotazione in gradi.

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

Dispositivo che supporta solo comandi di rotazione continua.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

STATEs dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Soddisfazione degli intent.

Stati Tipo Descrizione
rotationDegrees Number

Livello attuale in rotationDegreesRange che indica il grado di rotazione del dispositivo. Questo valore deve essere sempre relativo alla rotazione in senso orario.

rotationPercent Number

Livello attuale che indica la percentuale di rotazione del dispositivo. 0,0 corrisponde a chiuso e 100,0 a aperto.

Esempi

Quanto viene ruotato il dispositivo? (percentuale e gradi).

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

Quanto viene ruotato il dispositivo? (solo gradi).

{
  "rotationDegrees": 45
}

Quanto viene ruotato il dispositivo? (contino).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

comandi del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Soddisfazione degli intent.

action.devices.commands.RotateAbsolute

Imposta la rotazione assoluta del dispositivo.

Parametri

Il payload contiene uno dei seguenti valori:

Imposta la rotazione assoluta in gradi.

Parametri Tipo Descrizione
rotationDegrees Number

Obbligatorio.

Un valore assoluto, in gradi, che specifica la rotazione finale in senso orario del dispositivo. Il valore deve rientrare nell'attributo rotationDegreesRange.

Imposta la rotazione assoluta in percentuale.

Parametri Tipo Descrizione
rotationPercent Number

Obbligatorio.

Un valore assoluto, in percentuale, che specifica la rotazione finale del dispositivo.

Esempi

Inclina il dispositivo fino al 50%.

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

Ruota il dispositivo di 15 gradi in senso antiorario (rotationDegrees: 45).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

Ruota il dispositivo di 100 gradi in senso orario (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

Si è verificato un errore durante l'impostazione della rotazione del dispositivo.

Valori supportati:

deviceJammingDetected

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.