Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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.