Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev SensorState Özellik Şeması

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

Cihaz ATTRIBUTES

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

Özellikler Type Açıklama
sensorStatesSupported Dizi

Zorunludur.

Her nesne, söz konusu cihaz tarafından desteklenen sensör durumu özelliklerini temsil eder. Her sensör en az açıklayıcı veya sayısal kapasiteye sahip olmalıdır. Sensörler de her ikisini de 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ılabilir durumların listesi. "Bilinmeyen" durumu, sensör bir değer döndürmediğinde 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 bilgi için Desteklenen Sensörler'e bakın.

Örnekler

Açıklayıcı durum değerini raporlayan 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 bir sensör.

{
  "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 listelenmektedir.

Hava kalitesi

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

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 Beceriler

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 Beceriler

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 Beceriler

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 Beceriler

Desteklenen değerler:

WaterLeak

Desteklenen değerler:

leak
no leak
unknown
Desteklenmiyor.

Yağmur algılama

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

Desteklenen değerler:

RainDetection

Desteklenen değerler:

rain detected
no rain detected
unknown
Desteklenmiyor.

Filtre süresi

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

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 Beceriler

Desteklenen değerler:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
Desteklenmiyor.

Desteklenen değerler:

PERCENTAGE

Karbondioksit seviyesi

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

Desteklenen değerler:

CarbonDioxideLevel
Desteklenmiyor.

Desteklenen değerler:

PARTS_PER_MILLION

Parçacıklı maddeler

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

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 Beceriler

Desteklenen değerler:

VolatileOrganicCompounds
Desteklenmiyor.

Desteklenen değerler:

PARTS_PER_MILLION

Cihaz STATUS

Bu özelliğe sahip varlıklar, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Eyaletler Type Açıklama
currentSensorStateData Dizi

Zorunludur.

Mevcut sensör durumlarının listesi.

[item, ...] Nesne

Mevcut sensör durumu.

name Dize

Zorunludur.

Sensör durum adı. sensorStatesSupported alanındaki bir değerle eşleşiyor.

currentSensorState Dize

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

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 bilgi için Desteklenen Sensörler'e bakın.

Örnekler

Açıklayıcı durum değerini raporlayan 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 bir sensör.

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

Cihaz Komisyonları

Yok.

Cihaz BİLDİRİMLERİ

Bu özelliğe sahip cihazlar, cihaz durumu değişikliğinin bir parçası olarak aşağıdaki bildirim yükünü döndürebilir. Bildirimlerin uygulanması hakkında daha fazla bilgi için Akıllı ev İşlemleri bildirimlerine bakın.

Alanlar Type Açıklama
SensorState Nesne

Zorunludur.

Bildirim yükü.

priority Integer

Zorunludur.

Bildirim düzeyini gösterir. Şu anda desteklenen değer 0 ise bildirimin sesli olarak okunması gerektiğini belirtir.

name Dize

Zorunludur.

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

currentSensorState Dize

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 bir sensör türünün desteklediği farklı özellikler hakkında daha fazla bilgi edinmek için Desteklenen Sensörler'e bakın.

Örnekler

, duman algıladı.

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.