Schemat ruchowy inteligentnego czujnika domu
action.devices.traits.SensorState
– ta cecha obejmuje zarówno pomiary ilościowe, jak i jakościowe.
ATTRIBUTES urządzenia
W ramach operacji SYNC
urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC
znajdziesz w sekcji Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
sensorStatesSupported |
Tablica |
Wymagane. Każdy obiekt reprezentuje stan czujnika obsługiwany przez konkretne urządzenie. Każdy czujnik musi mieć co najmniej funkcję opisową lub liczbową. Czujniki mogą również zgłaszać oba te elementy. W takim przypadku preferowana jest wartość liczbowa. |
[item, ...] |
Obiekt |
Obsługiwane możliwości czujników Wymagany jest co najmniej 1 element. |
name |
String |
Wymagane. Obsługiwany typ czujnika. Zobacz tabelę Obsługiwane czujniki. |
descriptiveCapabilities |
Obiekt |
Opis możliwości czujników. |
availableStates |
Tablica |
Wymagane. Lista stanów dostępnych na urządzeniu. Stan „nieznany” jest domyślnie obsługiwany, gdy czujnik nie zwraca wartości. |
[item, ...] |
String |
Obsługiwana wartość opisowa. Wymagany jest co najmniej 1 element. |
numericCapabilities |
Obiekt |
Opisuje możliwe wartości liczbowe, które może rejestrować czujnik. |
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
Urządzenie czujnika, które zgłasza opisową wartość stanu.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Urządzenie czujnika, które raportuje wartość stanu.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Urządzenie czujnika do raportowania wartości opisowych i liczbowych.
{ "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 możliwości.
Jakość powietrza
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Tlenek węgla
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Poziom zadymienia
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Czystość filtra
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Nieobsługiwane. |
Wyciek wody
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Nieobsługiwane. |
Wykrywanie deszczu
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Nieobsługiwane. |
Czas trwania filtra
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obliczony czas trwania filtra
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Stężenie dwutlenku węgla
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
pyły zawieszone
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Bezpłatne związki organiczne
Nazwa | Funkcje opisowe | Możliwości liczbowe |
---|---|---|
Obsługiwane wartości:
|
Nieobsługiwane. | Obsługiwane wartości:
|
Urządzenie STATES
W ramach operacji QUERY
encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
currentSensorStateData |
Tablica |
Wymagane. Lista obecnych stanów czujników. |
[item, ...] |
Obiekt |
Obecny stan czujnika. |
name |
String |
Wymagane. Nazwa stanu czujnika. Odpowiada wartości parametru |
currentSensorState |
String |
Bieżąca wartość opisowa stanu. Odpowiada wartości parametru |
rawValue |
Number |
Bieżąca 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
Urządzenie czujnika, które zgłasza opisową wartość stanu.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Urządzenie czujnika, które raportuje wartość stanu.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Urządzenie czujnika do raportowania wartości opisowych i liczbowych.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
Urządzenie CommandS
Brak.
POWIADOMIENIA O URZĄDZENIACH
W ramach zmiany stanu urządzenia urządzenia z tą cechą mogą zwracać ten ładunek powiadomień. Więcej informacji o implementowaniu powiadomień znajdziesz w artykule Powiadomienia dotyczące inteligentnych działań w domu.
Pola | Typ | Opis |
---|---|---|
SensorState |
Obiekt |
Wymagane. Ładunek powiadomień. |
priority |
Liczba całkowita |
Wymagane. Określa poziom powiadomień. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być odczytywane 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ń. |
Ładunek powiadomień może zawierać te typy czujników:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
Więcej informacji o funkcjach obsługiwanych przez poszczególne typy czujników znajdziesz w artykule Obsługiwane czujniki.
Przykłady
Urządzenie
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }