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:
|
Desteklenen değerler:
|
Desteklenen değerler:
|
Karbonmonoksit
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenen değerler:
|
Desteklenen değerler:
|
Duman seviyesi
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenen değerler:
|
Desteklenen değerler:
|
Filtre temizliği
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenen değerler:
|
Desteklenmiyor. |
Su sızıntısı
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenen değerler:
|
Desteklenmiyor. |
Yağmur algılama
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenen değerler:
|
Desteklenmiyor. |
Filtre ömrü
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenen değerler:
|
Desteklenen değerler:
|
Hesaplanmış filtre ömrü
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenmiyor. | Desteklenen değerler:
|
Karbondioksit seviyesi
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenmiyor. | Desteklenen değerler:
|
Konuya katkıda bulunma
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenmiyor. | Desteklenen değerler:
|
Değişken organik bileşikler
Ad | Açıklayıcı Özellikler | Sayısal Özellikler |
---|---|---|
Desteklenen değerler:
|
Desteklenmiyor. | Desteklenen değerler:
|
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ı. |
currentSensorState |
Dize |
Geçerli açıklayıcı durum değeri. |
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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }