Sifat

trait di SDM API terdiri dari kolom, perintah, dan peristiwa.

Kolom

Kolom adalah nilai dengan jenis data umum, seperti angka atau string. Misalnya, kolom mungkin berisi mode saat ini atau kelembapan ruangan Google Nest Thermostat.

Ciri dan kolom dapat dilihat dengan panggilan GET ke endpoint API yang diinginkan:

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"
    }
  ]
}

Jenis perangkat

sdm.devices.types.device-type yang ditampilkan oleh SDM API tidak boleh digunakan untuk menyimpulkan atau menyimpulkan fungsi perangkat sebenarnya yang ditetapkan. Tidak ada jaminan bahwa jenis perangkat akan tetap stabil untuk perangkat tertentu seiring bertambahnya fitur yang ditambahkan ke SDM API. Sebagai gantinya, gunakan trait yang ditampilkan untuk perangkat.

parentRelations

Objek parentRelations mewakili resource induk dari resource saat ini, baik struktur atau ruangan. Nama tampilan sesuai dengan kolom customName pada Fitur info untuk perangkat dengan induk struktur atau fitur parentInfo RoomInfo

Perintah

Perintah adalah permintaan yang terkait dengan suatu karakteristik. Misalnya, mengubah mode saat ini atau setpoint suhu pada Google Nest Thermostat.

Perintah dikirim oleh panggilan API executeCommand:

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

Sebagian besar respons terhadap perintah adalah keberhasilan atau kegagalan sederhana. Lihat masing-masing panduan ciri untuk contoh penggunaan perintah tertentu.

Peristiwa

Peristiwa bersifat asinkron dan dikelola oleh Google Cloud Pub/Sub dalam satu topik per Project ID.

Peristiwa dikirim secara default untuk setiap perubahan pada nilai kolom ciri. Notifikasi juga dapat dikirim sebagai respons terhadap tindakan perangkat tertentu atau perubahan dalam penetapan resource. Lihat Peristiwa untuk informasi selengkapnya.

Kategori sifat

Struktur

Sifat
Info
sdm.structures.traits.Info
Sifat ini termasuk dalam struktur apa pun untuk informasi yang terkait dengan struktur.
RoomInfo
sdm.structures.traits.RoomInfo
Ciri ini milik ruang mana pun untuk informasi terkait kamar.

Perangkat

Sifat
Konektivitas
sdm.devices.traits.Connectivity
Ciri ini milik setiap perangkat yang memiliki informasi konektivitas.
Penggemar
sdm.devices.traits.Fan
Ciri ini milik perangkat apa pun yang memiliki kemampuan sistem untuk mengontrol kipas.
Kelembapan
sdm.devices.traits.Humidity
Ciri ini termasuk dalam perangkat apa pun yang memiliki sensor untuk mengukur kelembapan.
Info
sdm.devices.traits.Info
Sifat ini milik perangkat apa pun untuk informasi terkait perangkat.
Setelan
sdm.devices.traits.Settings
Ciri ini dimiliki setiap perangkat untuk informasi setelan terkait perangkat.
Suhu
sdm.devices.traits.Temperature
Sifat ini milik setiap perangkat yang memiliki sensor untuk mengukur suhu.

Termostat

Sifat
ThermostatEco
sdm.devices.traits.ThermostatEco
Fitur ini termasuk dalam jenis perangkat THERMOSTAT yang mendukung mode ECO.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
Ciri ini termasuk dalam jenis perangkat THERMOSTAT yang dapat melaporkan detail HVAC.
ThermostatMode
sdm.devices.traits.ThermostatMode
Fitur ini termasuk dalam jenis perangkat THERpalingAT yang mendukung mode termostat yang berbeda.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Fitur ini termasuk dalam jenis perangkat THERMOSTAT yang mendukung penyetelan suhu dan rentang suhu target.

Kamera

Sifat
CameraClipPreview
sdm.devices.traits.CameraClipPreview
Ciri ini milik perangkat apa pun yang mendukung download pratinjau klip.
CameraEventImage
sdm.devices.traits.CameraEventImage
Ciri ini milik perangkat apa pun yang mendukung pembuatan gambar dari peristiwa.
CameraImage
sdm.devices.traits.CameraImage
Ciri ini milik perangkat apa pun yang mendukung pengambilan gambar.
CameraLiveStream
sdm.devices.traits.CameraLiveStream
Ciri ini milik perangkat apa pun yang mendukung live streaming.
CameraMotion
sdm.devices.traits.CameraMotion
Sifat ini milik perangkat apa pun yang mendukung peristiwa deteksi gerakan.
CameraPerson
sdm.devices.traits.CameraPerson
Sifat ini milik perangkat apa pun yang mendukung peristiwa deteksi orang.
CameraSound
sdm.devices.traits.CameraSound
Sifat ini milik perangkat apa pun yang mendukung peristiwa deteksi suara.

Bel pintu

Sifat
DoorbellChime
sdm.devices.traits.DoorbellChime
Fitur ini milik perangkat yang mendukung bel bel pintu dan peristiwa penekanan terkait.