Schemat trait Smart Home SensorState
action.devices.traits.SensorState
– ta cecha obejmuje zarówno pomiary ilościowe, jak i jakościowe.
Urządzenie ATTRIBUTES
Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC
. Więcej informacji o obsłudze intencji SYNC
znajdziesz w artykule o realizacji intencji.
Atrybuty | Typ | Opis |
---|---|---|
sensorStatesSupported |
Tablica |
Wymagane. Każdy obiekt reprezentuje możliwości stanu czujnika obsługiwane przez to konkretne urządzenie. Każdy czujnik musi mieć przynajmniej cechę opisową lub numeryczną. Czujniki mogą też zgłaszać oba te rodzaje danych. W takim przypadku preferowana jest wartość liczbowa. |
[item, ...] |
Obiekt |
Obsługiwane funkcje czujnika. Wymaga co najmniej 1 elementu. |
name |
String |
Wymagane. Obsługiwany typ czujnika. Zobacz tabelę Obsługiwane czujniki. |
descriptiveCapabilities |
Obiekt |
Opis możliwości czujnika. |
availableStates |
Tablica |
Wymagane. Lista stanów dostępnych dla urządzenia. Stan „nieznany” jest domyślnie obsługiwany, gdy czujnik nie zwraca wartości. |
[item, ...] |
String |
Obsługiwana opisowa wartość stanu. Wymaga co najmniej 1 elementu. |
numericCapabilities |
Obiekt |
Opisuje możliwe wartości liczbowe, które czujnik może zgłosić. |
rawValueUnit |
String |
Wymagane. Obsługiwana jednostka liczbowa. |
Więcej informacji na temat różnych możliwości i typów czujników obsługiwanych przez tę cechę znajdziesz w artykule Obsługiwane czujniki.
Przykłady
Czujnik, który zgłasza opisową wartość stanu.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Czujnik, który zgłasza liczbową wartość stanu.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Czujnik, który zgłasza opisową i numeryczną wartość stanu.
{ "sensorStatesSupported": [ { "name": "SmokeLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" }, "descriptiveCapabilities": { "availableStates": [ "smoke detected", "high", "no smoke detected" ] } } ] }
Obsługiwane czujniki
W tabelach poniżej znajdziesz listę obsługiwanych typów czujników i powiązanych z nimi funkcji.
Jakość powietrza
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Tlenek węgla
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Poziom zadymienia
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Czystość filtra
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Nieobsługiwane. |
Wyciek wody
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Nieobsługiwane. |
Wykrywanie deszczu
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Nieobsługiwane. |
Czas eksploatacji filtra
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obliczony czas życia filtra
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Stężenie dwutlenku węgla
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Pył zawieszony
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Lotne związki organiczne
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Urządzenie STATES
Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY
. Więcej informacji o obsłudze intencji QUERY
znajdziesz w artykule o realizacji intencji.
Stany | Typ | Opis |
---|---|---|
currentSensorStateData |
Tablica |
Wymagane. Lista bieżących stanów czujnika. |
[item, ...] |
Obiekt |
Obecny stan czujnika. |
name |
String |
Wymagane. Nazwa stanu czujnika. Pasuje do wartości z |
currentSensorState |
String |
Bieżąca wartość opisowa stanu. Pasuje do wartości z |
rawValue |
Number |
Obecna wartość liczbowa czujnika. |
Więcej informacji na temat różnych możliwości i typów czujników obsługiwanych przez tę cechę znajdziesz w artykule Obsługiwane czujniki.
Przykłady
Czujnik, który zgłasza opisową wartość stanu.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Czujnik, który zgłasza liczbową wartość stanu.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Czujnik, który zgłasza opisową i numeryczną wartość stanu.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
CommandS na urządzeniu
Brak.
POWIADOMIENIA Z urządzenia
W ramach zmiany stanu urządzenia z tą cechą mogą zwracać poniższy ładunek powiadomienia. Więcej informacji o implementowaniu powiadomień znajdziesz w artykule Powiadomienia o działaniach związanych z inteligentnym domem.
Pola | Typ | Opis |
---|---|---|
SensorState |
Obiekt |
Wymagane. Ładunek powiadomienia. |
priority |
Liczba całkowita |
Wymagane. Reprezentuje poziom powiadomień. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być wymawiane na głos. |
name |
String |
Wymagane. Nazwa stanu czujnika. Zobacz listę obsługiwanych typów czujników powiadomień. |
currentSensorState |
String |
Wymagane. Bieżąca wartość opisowa stanu. Zobacz listę obsługiwanych typów czujników powiadomień. |
Dane dotyczące powiadomień mogą zawierać te typy czujników:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
Więcej informacji o różnych możliwościach obsługiwanych przez poszczególne typy czujników znajdziesz w artykule Obsługiwane czujniki.
Przykłady
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }