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" didukung secara implisit 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:
|
Nilai yang didukung:
|
Nilai yang didukung:
|
Karbon monoksida
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Nilai yang didukung:
|
Nilai yang didukung:
|
Tingkat asap
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Nilai yang didukung:
|
Nilai yang didukung:
|
Kebersihan filter
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Nilai yang didukung:
|
Tidak didukung. |
Kebocoran air
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Nilai yang didukung:
|
Tidak didukung. |
Deteksi hujan
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Nilai yang didukung:
|
Tidak didukung. |
Masa pakai filter
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Nilai yang didukung:
|
Nilai yang didukung:
|
Masa pakai filter yang dihitung
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Tidak didukung. | Nilai yang didukung:
|
Tingkat karbon dioksida
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Tidak didukung. | Nilai yang didukung:
|
Materi partikulat
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Tidak didukung. | Nilai yang didukung:
|
Senyawa organik volatil
Nama | Kemampuan Deskriptif | Kemampuan Numerik |
---|---|---|
Nilai yang didukung:
|
Tidak didukung. | Nilai yang didukung:
|
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 |
currentSensorState |
String |
Nilai status deskriptif saat ini. Mencocokkan nilai dari |
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:
|
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. Nilai 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.
{ "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", "alarmSilenceState": "DISALLOWED" } ] }
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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }