Skema Trait SensorState Smart Home

action.devices.traits.SensorState - Sifat ini mencakup pengukuran kuantitatif dan status kualitatif.

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini mungkin melaporkan hal berikut sebagai bagian dari operasi SYNC. Untuk mempelajari selengkapnya tentang menangani intent SYNC, lihat Pemenuhan intent.

Atribut	Jenis	Deskripsi
sensorStatesSupported	Array	Wajib. Setiap objek mewakili kemampuan status sensor yang didukung oleh perangkat khusus ini. Setiap sensor harus memiliki setidaknya kemampuan deskriptif atau numerik. Sensor juga dapat melaporkan keduanya, dalam hal ini nilai numerik akan lebih diutamakan.
[item, ...]	Objek	Kemampuan sensor yang didukung. Membutuhkan setidaknya 1 item.
name	String	Wajib. Jenis sensor yang didukung. Lihat tabel Sensor yang Didukung.
descriptiveCapabilities	Objek	Deskripsi kemampuan sensor.
availableStates	Array	Wajib. Daftar status yang tersedia untuk perangkat. "Tidak diketahui" secara implisit didukung ketika sensor tidak mengembalikan nilai.
[item, ...]	String	Nilai status deskriptif yang didukung. Membutuhkan setidaknya 1 item.
numericCapabilities	Objek	Menjelaskan kemungkinan nilai numerik yang dapat dilaporkan sensor.
rawValueUnit	String	Wajib. Satuan numerik yang didukung.

Lihat Sensor yang Didukung untuk detail selengkapnya tentang berbagai kemampuan dan jenis sensor yang didukung fitur ini.

Contoh

Perangkat sensor yang melaporkan nilai status deskriptif.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Perangkat sensor yang melaporkan nilai status numerik.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Perangkat sensor yang melaporkan nilai status deskriptif dan numerik.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

Sensor yang Didukung

Tabel berikut mencantumkan jenis sensor yang didukung dan kemampuannya yang terkait.

Kualitas udara

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: AirQuality	Nilai yang didukung: healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	Nilai yang didukung: AQI

Karbon monoksida

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: CarbonMonoxideLevel	Nilai yang didukung: carbon monoxide detected high no carbon monoxide detected unknown	Nilai yang didukung: PARTS_PER_MILLION

Tingkat asap

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: SmokeLevel	Nilai yang didukung: smoke detected high no smoke detected unknown	Nilai yang didukung: PARTS_PER_MILLION

Kebersihan filter

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: FilterCleanliness	Nilai yang didukung: clean dirty needs replacement unknown	Tidak didukung.

Kebocoran air

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: WaterLeak	Nilai yang didukung: leak no leak unknown	Tidak didukung.

Deteksi hujan

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: RainDetection	Nilai yang didukung: rain detected no rain detected unknown	Tidak didukung.

Masa pakai filter

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: FilterLifeTime	Nilai yang didukung: new good replace soon replace now unknown	Nilai yang didukung: PERCENTAGE

Masa pakai filter yang dihitung

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Tidak didukung.	Nilai yang didukung: PERCENTAGE

Tingkat karbon dioksida

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: CarbonDioxideLevel	Tidak didukung.	Nilai yang didukung: PARTS_PER_MILLION

Materi partikulat

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: PM2.5 PM10	Tidak didukung.	Nilai yang didukung: MICROGRAMS_PER_CUBIC_METER

Senyawa organik volatil

Nama	Kemampuan Deskriptif	Kemampuan Numerik
Nilai yang didukung: VolatileOrganicCompounds	Tidak didukung.	Nilai yang didukung: PARTS_PER_MILLION

NEGARA Perangkat

Entitas dengan karakteristik ini dapat melaporkan hal berikut status sebagai bagian dari operasi QUERY. Untuk mempelajari selengkapnya tentang menangani intent QUERY, lihat Pemenuhan intent.

Negara bagian	Jenis	Deskripsi
currentSensorStateData	Array	Wajib. Daftar status sensor saat ini.
[item, ...]	Objek	Status sensor saat ini.
name	String	Wajib. Nama status sensor. Mencocokkan nilai dari sensorStatesSupported.
currentSensorState	String	Nilai status deskriptif saat ini. Mencocokkan nilai dari sensorStatesSupported.
rawValue	Number	Nilai sensor numerik saat ini.

Lihat Sensor yang Didukung untuk detail selengkapnya tentang berbagai kemampuan dan jenis sensor yang didukung fitur ini.

Contoh

Perangkat sensor yang melaporkan nilai status deskriptif.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Perangkat sensor yang melaporkan nilai status numerik.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Perangkat sensor yang melaporkan nilai status deskriptif dan numerik.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

Perangkat COMMANDS

Tidak ada.

NOTIFIKASI Perangkat

Perangkat dengan karakteristik ini dapat menampilkan hal berikut payload notifikasi sebagai bagian dari perubahan status perangkat. Untuk mempelajari selengkapnya tentang cara menerapkan notifikasi, lihat Notifikasi untuk Action smart home.

Kolom	Jenis	Deskripsi
SensorState	Objek	Wajib. Payload notifikasi.
priority	Bilangan Bulat	Wajib. Merepresentasikan tingkat notifikasi. Nilai yang saat ini didukung adalah 0, yang menunjukkan bahwa notifikasi harus diucapkan dengan keras.
name	String	Wajib. Nama status sensor. Lihat daftar jenis sensor yang didukung untuk notifikasi.
currentSensorState	String	Wajib. Nilai status deskriptif saat ini. Lihat daftar jenis sensor yang didukung untuk notifikasi.

Payload notifikasi dapat berisi jenis sensor berikut:

• AirQuality
• CarbonMonoxideLevel
• SmokeLevel
• FilterCleanliness
• WaterLeak
• RainDetection
• FilterLifeTime

Lihat Sensor yang Didukung untuk detail selengkapnya tentang berbagai kapabilitas yang didukung oleh setiap jenis sensor.

Contoh

mendeteksi asap.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.