Tratti

Un trait nell'API SDM comprende campi, comandi ed eventi.

Campi

I campi sono valori con tipi di dati comuni, come un numero o una stringa. Ad esempio, un campo potrebbe contenere la modalità corrente o l'umidità ambientale di Google Nest Thermostat.

I trait e i campi possono essere visualizzati con una chiamata GET all'endpoint API desiderato:

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

Tipi di dispositivo

L'elemento sdm.devices.types.device-type restituito dall'API SDM non deve essere utilizzato per dedurre o dedurre la funzionalità del dispositivo effettivo a cui è assegnata. Non vi è alcuna garanzia che un tipo di dispositivo rimanga stabile per un dispositivo specifico man mano che vengono aggiunte altre funzionalità a SDM. tramite Google Cloud CLI o tramite l'API Compute Engine. Utilizza invece i trait restituiti per il dispositivo.

parentRelations

L'oggetto parentRelations rappresenta la risorsa padre della risorsa attuale, o una struttura o una stanza. Il nome visualizzato corrisponde al campo customName della Informazioni sulla camera per i dispositivi con una struttura principale Trait RoomInfo per i dispositivi con genitore della stanza.

Comandi

I comandi sono richieste associate a un tratto. Ad esempio, la modifica della modalità corrente o set-point di temperatura su Google Nest Thermostat.

Un comando viene inviato da una chiamata API executeCommand:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

La maggior parte delle risposte a un comando sono semplici operazioni riuscite o non riuscite. Consulta le guide sulle trait individuali esempi di utilizzo di comandi specifici.

Eventi

Gli eventi sono asincroni e gestiti da Google Cloud Pub/Sub in un unico argomento Project ID.

Per impostazione predefinita, vengono inviati eventi per qualsiasi modifica al valore di un campo dei tratti. Possono anche essere inviati risposta ad azioni specifiche dei dispositivi o modifiche nelle assegnazioni delle risorse. Consulta Eventi per ulteriori informazioni.

Categorie di tratti

Struttura

Tratti
Informazioni
sdm.structures.traits.Info
Questo tratto appartiene a qualsiasi struttura di informazioni relative alla struttura.
RoomInfo
sdm.structures.traits.RoomInfo
Questo tratto appartiene a qualsiasi stanza per le informazioni relative alla stanza.

Dispositivo

Tratti
Connettività
sdm.devices.traits.Connectivity
Questo tratto appartiene a qualsiasi dispositivo con informazioni di connettività.
Fan
sdm.devices.traits.Fan
Questo tratto appartiene a qualsiasi dispositivo in grado di controllare la ventola.
Umidità
sdm.devices.traits.Humidity
Questa caratteristica appartiene a qualsiasi dispositivo dotato di un sensore per misurare l'umidità.
Informazioni
sdm.devices.traits.Info
Questo tratto appartiene a qualsiasi dispositivo per le informazioni relative a tale dispositivo.
Impostazioni
sdm.devices.traits.Settings
Questo tratto appartiene a qualsiasi dispositivo per le informazioni relative alle impostazioni relative al dispositivo.
Temperatura
sdm.devices.traits.Temperature
Questa caratteristica appartiene a qualsiasi dispositivo dotato di un sensore per misurare la temperatura.

Termostato

Tratti
ThermostatEco
sdm.devices.traits.ThermostatEco
Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano le modalità ECO.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
Questo tratto appartiene ai tipi di dispositivi TERMOSTAT in grado di segnalare i dettagli dell'impianto di climatizzazione.
ThermostatMode
sdm.devices.traits.ThermostatMode
Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano diverse modalità del termostato.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura ottimale.

Fotocamera

Tratti
CameraClipPreview
sdm.devices.traits.CameraClipPreview
Questo tratto appartiene a qualsiasi dispositivo che supporta il download di un'anteprima dei clip.
CameraEventImage
sdm.devices.traits.CameraEventImage
Questo tratto appartiene a qualsiasi dispositivo che supporta la generazione di immagini da eventi.
CameraImage
sdm.devices.traits.CameraImage
Questo tratto appartiene a qualsiasi dispositivo che supporta lo scatto di immagini.
CameraLiveStream
sdm.devices.traits.CameraLiveStream
Questo tratto appartiene a qualsiasi dispositivo che supporta il live streaming.
CameraMotion
sdm.devices.traits.CameraMotion
Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei movimenti.
CameraPerson
sdm.devices.traits.CameraPerson
Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento persone.
CameraSound
sdm.devices.traits.CameraSound
Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei suoni.

Campanello

Tratti
DoorbellChime
sdm.devices.traits.DoorbellChime
Questo tratto appartiene a qualsiasi dispositivo che supporta il cicalino di un campanello e i relativi eventi di stampa.