Akıllı Ev SensorState Özelliği Şeması

action.devices.traits.SensorState: Bu özellik hem nicel ölçümü hem de niteliksel durumu kapsar.

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
sensorStatesSupported Dizi

Zorunludur.

Her nesne, bu cihaz tarafından desteklenen sensör durumu özelliklerini temsil eder. Her sensörün en az bir açıklayıcı veya sayısal özelliği olmalıdır. Sensörler her ikisini de bildirebilir. Bu durumda, sayısal değer tercih edilir.
[item, ...] Nesne

Desteklenen sensör özellikleri.

En az 1 öğe gereklidir.
name String

Zorunludur.

Desteklenen sensör türü. Desteklenen Sensörler tablosuna bakın.
descriptiveCapabilities Nesne

Sensörün özelliklerinin açıklaması.
availableStates Dizi

Zorunludur.

Cihaz için kullanılabilen durumların listesi. Sensör bir değer döndürmediğinde "bilinmiyor" durumu dolaylı olarak desteklenir.
[item, ...] String

Desteklenen açıklayıcı durum değeri.

En az 1 öğe gereklidir.
numericCapabilities Nesne

Sensörün bildirebileceği olası sayısal değerleri açıklar.
rawValueUnit String

Zorunludur.

Desteklenen sayısal birim.

Bu özelliğin desteklediği farklı özellikler ve sensör türleri hakkında daha fazla bilgi için Desteklenen Sensörler başlıklı makaleyi inceleyin.

Örnekler

Açıklayıcı durum değerini bildiren sensör cihazı.

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

Sayısal durum değerini bildiren sensör cihazı.

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

Açıklayıcı ve sayısal durum değerini bildiren sensör cihazı.

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

Desteklenen Sensörler

Aşağıdaki tablolarda desteklenen sensör türleri ve bunlarla ilişkili özellikler listelenmiştir.

Hava kalitesi

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

AirQuality

Desteklenen değerler:

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

Desteklenen değerler:

AQI

Karbonmonoksit

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

CarbonMonoxideLevel

Desteklenen değerler:

carbon monoxide detected
high
no carbon monoxide detected
unknown

Desteklenen değerler:

PARTS_PER_MILLION

Duman seviyesi

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

SmokeLevel

Desteklenen değerler:

smoke detected
high
no smoke detected
unknown

Desteklenen değerler:

PARTS_PER_MILLION

Filtre temizlik seviyesi

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

FilterCleanliness

Desteklenen değerler:

clean
dirty
needs replacement
unknown
 Desteklenmiyor.

Su sızıntısı

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

WaterLeak

Desteklenen değerler:

leak
no leak
unknown
 Desteklenmiyor.

Yağmur algılama

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

RainDetection

Desteklenen değerler:

rain detected
no rain detected
unknown
 Desteklenmiyor.

Filtre ömrü

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

FilterLifeTime

Desteklenen değerler:

new
good
replace soon
replace now
unknown

Desteklenen değerler:

PERCENTAGE

Hesaplanan filtre ömrü

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 Desteklenmiyor.

Desteklenen değerler:

PERCENTAGE

Karbondioksit seviyesi

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

CarbonDioxideLevel
 Desteklenmiyor.

Desteklenen değerler:

PARTS_PER_MILLION

Partikül madde

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

PM2.5
PM10
 Desteklenmiyor.

Desteklenen değerler:

MICROGRAMS_PER_CUBIC_METER

Uçucu organik bileşikler

Ad Açıklayıcı Özellikler Sayısal Özellikler

Desteklenen değerler:

VolatileOrganicCompounds
 Desteklenmiyor.

Desteklenen değerler:

PARTS_PER_MILLION

Cihaz DURUMLARI

Bu özelliği taşıyan öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
currentSensorStateData Dizi

Zorunludur.

Mevcut sensör durumlarının listesi.
[item, ...] Nesne

Sensörün mevcut durumu.
name String

Zorunludur.

Sensör durumu adı. sensorStatesSupported alanındaki bir değerle eşleşir.
currentSensorState String

Mevcut açıklayıcı durum değeri. sensorStatesSupported alanındaki bir değerle eşleşir.
rawValue Number

Mevcut sayısal sensör değeri.
alarmState String

Mevcut sensör ölçümüne karşılık gelen alarm durumu. Sensör ölçümleri tehlikeli seviyelere yaklaştığında veya ulaştığında ön alarm veya alarm tetiklenebilir.

Desteklenen değerler:

IDLE
Alarm devre dışıdır; algılanan seviyeler tehlikeli değildir.
PRE_ALARM_1
Tespit edilen seviyeler yüksek ancak henüz acil durum seviyelerine ulaşmadı. Seviyeler yakında tehlikeli hale gelebilir.
PRE_ALARM_2
Cihaz, acil durum seviyelerine ulaşmadan önce birden fazla uyarıyı destekliyorsa bu, PRE_ALARM_1'den daha yüksek algılama seviyelerinin olduğunu gösterir. Seviyeler artmaya devam eder ve yakında acil durum seviyelerine yaklaşabilir.
ALARM
Algılanan seviyeler acil durum seviyelerine ulaştı ve bir alarm tetiklendi.
alarmSilenceState String

Etkin bir alarmın şu anda kapatılmasına izin verilip verilmediği de dahil olmak üzere sensörün alarmının sessiz durumunu gösterir. Bu durum, alarm öncesi veya alarm durumu etkin olduğunda sağlanabilir. Duman dedektörü için ALLOWED ve DISALLOWED değerleri kullanılmaz. Google Home uygulamasında, alarmın uygulamadan kapatılıp kapatılamayacağına karar veren yerleşik bir mantık vardır.

Desteklenen değerler:

ALLOWED
Alarmın sesi kapatılmamış ve alarmın sesini kapatmaya şu anda izin veriliyor.
DISALLOWED
Alarmın sesi kapatılmadı ve alarmın sesini kapatmaya şu anda izin verilmiyor.
SILENCED
Alarmın sesi kapatıldı.

Bu özelliğin desteklediği farklı özellikler ve sensör türleri hakkında daha fazla bilgi için Desteklenen Sensörler başlıklı makaleyi inceleyin.

Örnekler

Açıklayıcı durum değerini bildiren sensör cihazı.

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

Sayısal durum değerini bildiren sensör cihazı.

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

Açıklayıcı ve sayısal durum değerini bildiren sensör cihazı.

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

Açıklayıcı ve sayısal durum değerini bildiren ve alarmın etkin olduğunu belirten sensör cihazı.

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

Açıklayıcı ve sayısal durum değerini bildiren ve alarmın susturulduğunu belirten sensör cihazı.

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

Cihaz KOMUTLARI

Yok.

CİHAZ BİLDİRİMLERi

Bu özelliğe sahip cihazlar, cihaz durumu değişikliği kapsamında aşağıdaki bildirim yükünü döndürebilir. Bildirimleri uygulama hakkında daha fazla bilgi edinmek için Akıllı ev işlemleri için bildirimler başlıklı makaleyi inceleyin.

Alanlar Tür Açıklama
SensorState Nesne

Zorunludur.

Bildirim yükü.
priority Tamsayı

Zorunludur.

Bildirim düzeyini temsil eder. Şu anda desteklenen değer 0'dır. Bu değer, bildirimin sesli okunması gerektiğini gösterir.
name String

Zorunludur.

Sensör durumu adı. Bildirimler için desteklenen sensör türlerinin listesine bakın.
currentSensorState String

Zorunludur.

Mevcut açıklayıcı durum değeri. Bildirimler için desteklenen sensör türlerinin listesine bakın.

Bildirim yükü aşağıdaki sensör türlerini içerebilir:

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

Her sensör türünün desteklediği farklı özellikler hakkında daha fazla bilgi için Desteklenen Sensörler başlıklı makaleyi inceleyin.

Örnekler

duman algıladı.

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.