Skema Sifat SensorState Smart Home

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

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
sensorStatesSupported Array

Wajib.

Setiap objek mewakili kemampuan status sensor yang didukung oleh perangkat tertentu ini. Setiap sensor harus memiliki setidaknya kemampuan deskriptif atau numerik. Sensor juga dapat melaporkan keduanya, dan dalam hal ini nilai numerik akan lebih disukai.
[item, ...] Objek

Kemampuan sensor yang didukung.

Memerlukan minimal 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. Status "tidak diketahui" secara implisit didukung saat sensor tidak menampilkan nilai.
[item, ...] String

Nilai status deskriptif yang didukung.

Memerlukan minimal 1 item.
numericCapabilities Objek

Menjelaskan kemungkinan nilai numerik yang dapat dilaporkan sensor.
rawValueUnit String

Wajib.

Satuan numerik yang didukung.

Lihat Sensor yang Didukung untuk mengetahui detail selengkapnya tentang berbagai kemampuan dan jenis sensor yang didukung oleh 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 kemampuan terkaitnya.

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

Status PERANGKAT

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment 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.
alarmState String

Status alarm yang sesuai dengan pembacaan sensor saat ini. Pra-alarm atau alarm dapat dipicu saat pembacaan sensor mendekati dan mencapai tingkat berbahaya.

Nilai yang didukung:

IDLE
Alarm tidak aktif; level yang terdeteksi tidak berbahaya.
PRE_ALARM_1
Tingkat yang terdeteksi meningkat, tetapi belum mencapai tingkat darurat; tingkat tersebut mungkin akan segera menjadi berbahaya.
PRE_ALARM_2
Jika perangkat mendukung beberapa pemberitahuan sebelum mencapai tingkat darurat, hal ini menunjukkan tingkat deteksi yang lebih tinggi daripada PRE_ALARM_1; tingkatnya terus meningkat dan mungkin akan segera mendekati tingkat darurat.
ALARM
Tingkat yang terdeteksi telah mencapai tingkat darurat dan alarm telah dipicu.
alarmSilenceState String

Menunjukkan status senyap untuk alarm sensor, termasuk apakah saat ini senyap alarm aktif diizinkan. Status ini dapat diberikan saat status pra-alarm atau alarm aktif. Untuk Pendeteksi Asap, nilai ALLOWED dan DISALLOWED tidak digunakan. Aplikasi Google Home memiliki logika bawaan untuk menentukan apakah alarm dapat dibisukan dari aplikasi.

Nilai yang didukung:

ALLOWED
Alarm tidak dibisukan dan saat ini alarm dibisukan.
DISALLOWED
Alarm tidak dibisukan dan saat ini menonaktifkan suara alarm tidak diizinkan.
SILENCED
Alarm telah dibisukan.

Lihat Sensor yang Didukung untuk mengetahui detail selengkapnya tentang berbagai kemampuan dan jenis sensor yang didukung oleh 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 sensor yang melaporkan nilai status deskriptif dan numerik serta menunjukkan bahwa alarm aktif.

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

Perangkat sensor yang melaporkan nilai status deskriptif dan numerik serta menunjukkan bahwa alarm dibisukan.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "SILENCED"
    }
  ]
}

Perintah Perangkat

Tidak ada.

NOTIFIKASI Perangkat

Perangkat dengan karakteristik ini dapat menampilkan payload notifikasi berikut sebagai bagian dari perubahan status perangkat. Untuk mempelajari penerapan notifikasi lebih lanjut, lihat Notifikasi untuk Action smart home.

Kolom Jenis Deskripsi
SensorState Objek

Wajib.

Payload notifikasi.
priority Bilangan Bulat

Wajib.

Mewakili tingkat notifikasi. Nilai yang saat ini didukung adalah 0, yang menunjukkan bahwa notifikasi harus diucapkan dengan lantang.
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 mengetahui detail selengkapnya tentang berbagai kemampuan yang didukung oleh setiap jenis sensor.

Contoh

mendeteksi asap.

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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.