Model Instance dan Skema Instance

Model perangkat

Model perangkat ditentukan oleh kolom di bagian ini.

Kolom model perangkat hanya dapat berisi huruf, angka, dan simbol berikut: titik (.), tanda hubung (-), garis bawah (_), spasi ( ), dan plus (+). Karakter pertama kolom harus berupa huruf atau angka.

Contoh
{
  "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"]
}
Skema
{
  "project_id": string,
  "device_model_id": string,
  "manifest": {
    "manufacturer": string,
    "product_name": string,
    "device_description": string
  },
  "device_type": string,
  "traits": [ string ]
}
  • project_id: (String) Diperlukan. ID project Google Cloud Platform dari project Konsol Actions yang akan dikaitkan dengan model perangkat ini. Sebuah project dapat berisi beberapa model perangkat.
  • device_model_id: (String) Diperlukan. ID unik global untuk model perangkat ini; gunakan project_id sebagai awalan untuk membantu menghindari konflik dalam rentang semua project. Digunakan dalam metrik dan selama pendaftaran perangkat.
  • manifest: (objek(Manifes)) Wajib. Metadata yang menjelaskan model dan produsen perangkat. Hal ini dapat ditampilkan di konsol SDK (mendatang), dasbor metrik, dan antarmuka visual terkait lainnya.
    • manifest.manufacturer: (String) Diperlukan. Nama produsen perangkat.
    • manifest.product_name: (String) Diperlukan. Nama produk yang dilihat konsumen untuk model perangkat ini.
    • manifest.device_description: (String) Opsional. Deskripsi model perangkat ini.
  • device_type: (String) Diperlukan. Jenis hardware perangkat. Pilih dari opsi berikut:
    • 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>) Opsional. Daftar karakteristik yang didukung perangkat. Trait mencakup perintah, atribut, dan status untuk perangkat. Anda tidak perlu menentukan paket Action untuk menggunakan fitur bawaan trait bawaan.

Instance perangkat

Instance perangkat ditentukan oleh kolom di bagian ini.

Kolom instance perangkat harus diawali dengan huruf atau angka. ID perangkat hanya boleh berisi huruf, angka, dan simbol berikut: titik (.), tanda hubung (-), garis bawah (_), dan plus (+). Nama panggilan perangkat hanya boleh berisi angka, huruf, dan simbol spasi ( ).

Contoh
  {
    "id": "my_led_1",
    "model_id": "my-devices-project-prototype-light-v1",
    "nickname": "My Assistant Light",
    "client_type": "SDK_LIBRARY"
  }
Skema
  {
    "id": string,
    "model_id": string,
    "nickname": string,
    "client_type": string
  }
  • id: (String) Diperlukan. ID untuk perangkat pengujian. Harus unik di semua perangkat yang terdaftar di project Google Developer yang sama.
  • model_id: (String) Diperlukan. ID model perangkat; harus sama dengan device_model_id yang terkait dengan perangkat pengujian ini. Model perangkat harus sudah terdaftar sebelumnya.
  • nickname: (String) Opsional. Nama panggilan untuk perangkat. Nama ini akan digunakan untuk merujuk ke perangkat dalam antarmuka visual seperti setelan Asisten.
  • client_type: (String) Diperlukan. Jenis perangkat klien. Harus salah satu dari yang berikut: SDK_SERVICE atau SDK_LIBRARY.