Schema dei tratti di rilevamento degli oggetti per la smart home

action.devices.traits.ObjectDetection: questo tratto appartiene ai dispositivi in grado di rilevare oggetti o persone e inviare una notifica all'utente. Per impostazione predefinita, tutte le notifiche di ObjectDetection vengono annunciate su smart display e smart speaker con l'Assistente Google dopo il suono del campanello.

ATTRIBUTES dispositivo

Nessuno.

STATES del dispositivo

Nessuno.

COMANDI dispositivo

Nessuno.

NOTIFICHE dispositivo

I dispositivi con questo tratto potrebbero restituire quanto segue di notifica nell'ambito della modifica dello stato del dispositivo. Per ulteriori informazioni per saperne di più sull'implementazione delle notifiche, consulta Notifiche per le azioni della smart home.

Campi	Tipo	Descrizione
ObjectDetection	Oggetto	Obbligatorio. Payload delle notifiche.
priority	Intero	Obbligatorio. Rappresenta il livello di notifica. Il valore attualmente supportato è 0, che indica che la notifica deve essere pronunciata ad alta voce.
detectionTimestamp	Intero	Obbligatorio. Il timestamp dell'epoca in millisecondi in cui è stato rilevato l'oggetto.
objects	Oggetto	Obbligatorio. Raccolta degli oggetti rilevati per categoria.
named	Array	Elenco di oggetti riconosciuti dall'utente contrassegnati con un'etichetta.
[item, ...]	String	Etichetta dell'oggetto. Richiede almeno 1 elemento.
familiar	Intero	Conteggio degli oggetti riconosciuti dall'utente privi di etichette.
unfamiliar	Intero	Numero di oggetti rilevati dal dispositivo che l'utente potrebbe non riconoscere.
unclassified	Intero	Numero di oggetti rilevati che il dispositivo non è stato in grado di classificare.

Esempi

Sono stati rilevati due oggetti sconosciuti il 1° gennaio 2000.

{
  "ObjectDetection": {
    "objects": {
      "unclassified": 2
    },
    "priority": 0,
    "detectionTimestamp": 946684800000
  }
}

Ha rilevato una persona che conosci il 1° gennaio 2000.

{
  "ObjectDetection": {
    "objects": {
      "familiar": 1
    },
    "priority": 0,
    "detectionTimestamp": 946684800000
  }
}

Rilevato Alice il 1° gennaio 2000.

{
  "ObjectDetection": {
    "objects": {
      "named": [
        "Alice"
      ]
    },
    "priority": 0,
    "detectionTimestamp": 946684800000
  }
}

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.