Schemi del modello di istanza e del dispositivo

Modello del dispositivo

Il modello di dispositivo viene definito dai campi di questa sezione.

I campi del modello di dispositivo possono contenere solo lettere, numeri e i seguenti simboli: punto (.), trattino (-), trattino basso (_), spazio ( ) e più (+). Il primo carattere di un campo deve essere una lettera o un numero.

Esempio
{
  "project_id": "my-devices-project",
  "device_model_id": "my-devices-project-prototype-light-v1",
  "manifest": {
    "manufacturer": "Assistant SDK developer",
    "product_name": "Assistant SDK light",
    "device_description": "Assistant SDK light device"
  },
  "device_type": "action.devices.types.LIGHT",
  "traits": ["action.devices.traits.OnOff"]
}
Schema
{
  "project_id": string,
  "device_model_id": string,
  "manifest": {
    "manufacturer": string,
    "product_name": string,
    "device_description": string
  },
  "device_type": string,
  "traits": [ string ]
}
  • project_id: (stringa) obbligatoria. ID progetto della piattaforma Google Cloud del progetto Actions Console da associare a questo modello di dispositivo. Un progetto può contenere più modelli di dispositivi.
  • device_model_id: (stringa) obbligatoria. Identificatore univoco a livello globale per questo modello di dispositivo; utilizza project_id come prefisso per evitare collisioni nell'intervallo di tutti i progetti. Utilizzato nelle metriche e durante la registrazione del dispositivo.
  • manifest: (object(Manifest)) è obbligatorio. I metadati che descrivono il modello e il produttore del dispositivo. Questa informazione potrebbe essere mostrata nella console SDK (prossima), nelle dashboard delle metriche e in altre interfacce visive correlate.
    • manifest.manufacturer: (stringa) obbligatoria. Nome del produttore del dispositivo.
    • manifest.product_name: (stringa) obbligatoria. Nome del prodotto rivolto al consumatore per questo modello di dispositivo.
    • manifest.device_description: (stringa) facoltativa. Descrizione di questo modello di dispositivo.
  • device_type: (stringa) obbligatoria. Il tipo di hardware del dispositivo. Seleziona una delle seguenti opzioni:
    • action.devices.types.CAMERA
    • action.devices.types.DISHWASHER
    • action.devices.types.DRYER
    • action.devices.types.LIGHT
    • action.devices.types.OUTLET
    • action.devices.types.PHONE
    • action.devices.types.REFRIGERATOR
    • action.devices.types.SCENE
    • action.devices.types.SOUNDBAR
    • action.devices.types.SPEAKER
    • action.devices.types.SWITCH
    • action.devices.types.THERMOSTAT
    • action.devices.types.TV
    • action.devices.types.VACUUM
    • action.devices.types.WASHER
  • traits: (Array<String>) facoltativo. Elenco di trait supportati dal dispositivo. Le caratteristiche includono i comandi, gli attributi e gli stati del dispositivo. Non è necessario definire un pacchetto di azioni per utilizzare i trait integrati.

Istanza dispositivo

L'istanza del dispositivo viene definita dai campi in questa sezione.

I campi dell'istanza del dispositivo devono iniziare con una lettera o un numero. L'ID dispositivo può contenere solo lettere, numeri e i seguenti simboli: punto (.), trattino (-), trattino basso (_) e più (+). Il nickname del dispositivo può contenere solo numeri, lettere e lo spazio ( ).

Esempio
  {
    "id": "my_led_1",
    "model_id": "my-devices-project-prototype-light-v1",
    "nickname": "My Assistant Light",
    "client_type": "SDK_LIBRARY"
  }
Schema
  {
    "id": string,
    "model_id": string,
    "nickname": string,
    "client_type": string
  }
  • id: (stringa) obbligatoria. Identificatore del dispositivo di test. Deve essere univoco per tutti i dispositivi registrati nello stesso progetto Google Developers.
  • model_id: (stringa) obbligatoria. Identificatore del modello del dispositivo; deve essere uguale all'elemento device_model_id associato al dispositivo di test. Il modello del dispositivo deve essere già stato registrato.
  • nickname: (stringa) facoltativa. Nickname del dispositivo. Questo nome verrà utilizzato per fare riferimento al dispositivo nelle interfacce visive come le impostazioni dell'assistente.
  • client_type: (stringa) obbligatoria. Il tipo di dispositivo client. Deve essere uno dei seguenti: SDK_SERVICE o SDK_LIBRARY.