Akıllı Ev SensorState Trait Şeması

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

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Ö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 işlevi olmalıdır. Sensörler de ikisini birden bildirebilir. Bu durumda sayısal değer tercih edilir.
[item, ...]	Nesne	Desteklenen sensör özellikleri. En az 1 öğe gereklidir.
name	Dize	Zorunludur. Desteklenen sensör türü. Desteklenen Sensörler tablosuna bakın.
descriptiveCapabilities	Nesne	Sensörün özellikleriyle ilgili açıklama.
availableStates	Dizi	Zorunludur. Cihaz için kullanılabilen durumların listesi. Sensör bir değer döndürmediğinde "bilinmeyen" durumu dolaylı olarak desteklenir.
[item, ...]	Dize	Desteklenen açıklayıcı durum değeri. En az 1 öğe gereklidir.
numericCapabilities	Nesne	Sensörün raporlayabileceği olası sayısal değerleri açıklar.
rawValueUnit	Dize	Zorunludur. Desteklenen sayısal birim.

Bu özelliğin desteklediği farklı özellikler ve sensör türleri hakkında daha fazla bilgiyi Desteklenen Sensörler bölümünde bulabilirsiniz.

Örnekler

Açıklayıcı durum değeri 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ğeri 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 temizliği

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

Hesaplanmış 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

Konuya katkıda bulunma

Ad	Açıklayıcı Özellikler	Sayısal Özellikler
Desteklenen değerler: PM2.5 PM10	Desteklenmiyor.	Desteklenen değerler: MICROGRAMS_PER_CUBIC_METER

Değişken organik bileşikler

Ad	Açıklayıcı Özellikler	Sayısal Özellikler
Desteklenen değerler: VolatileOrganicCompounds	Desteklenmiyor.	Desteklenen değerler: PARTS_PER_MILLION

Cihaz durumu

Bu özelliğe sahip cihazlar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Eyaletler	Tür	Açıklama
currentSensorStateData	Dizi	Zorunludur. Mevcut sensör durumlarının listesi.
[item, ...]	Nesne	Mevcut sensör durumu.
name	Dize	Zorunludur. Sensör durumu adı. sensorStatesSupported ile eşleşen bir değer.
currentSensorState	Dize	Geçerli açıklayıcı durum değeri. sensorStatesSupported ile eşleşen bir değer.
rawValue	Number	Mevcut sayısal sensör değeri.

Bu özelliğin desteklediği farklı özellikler ve sensör türleri hakkında daha fazla bilgiyi Desteklenen Sensörler bölümünde bulabilirsiniz.

Örnekler

Açıklayıcı durum değeri 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ğeri bildiren sensör cihazı.

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

Cihaz FTC'leri

Yok.

Cihaz BİLDİRİMLERİ

Bu özelliğe sahip cihazlar, cihaz durumu değişikliği kapsamında aşağıdaki bildirim yükünü iade edebilir. Bildirimleri uygulama hakkında daha fazla bilgi için Akıllı ev işlemleri bildirimleri bölümüne bakın.

Alanlar	Tür	Açıklama
SensorState	Nesne	Zorunludur. Bildirim yükü.
priority	Integer	Zorunludur. Bildirim düzeyini gösterir. Şu anda desteklenen değer 0'dır. Bu, bildirimin sesli olarak söylenmesi gerektiğini belirtir.
name	Dize	Zorunludur. Sensör durumu adı. Bildirimler için desteklenen sensör türlerinin listesine bakın.
currentSensorState	Dize	Zorunludur. Geçerli 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 bir sensör türünün desteklediği farklı özellikler hakkında ayrıntılı bilgi edinmek için Desteklenen Sensörler bölümüne bakın.

Örnekler

Duman algılar.

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.