Schemat działania inteligentnego czujnika domu
action.devices.traits.SensorState
– ta cecha obejmuje zarówno pomiary ilościowe, jak i stan ilościowy.
ATRYBUTY 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 |
Wymagany. Każdy obiekt reprezentuje możliwości stanu czujnika obsługiwane przez to konkretne urządzenie. Każdy czujnik musi mieć co najmniej funkcję opisową lub liczbową. Czujniki mogą też rejestrować oba rodzaje wartości – w takim przypadku preferowana jest wartość liczbowa. |
[item, ...] |
Obiekt |
Obsługiwane funkcje czujników. Wymagany jest co najmniej 1 element. |
name |
Ciąg |
Wymagany. Obsługiwany typ czujnika. Zobacz tabelę Obsługiwane czujniki. |
descriptiveCapabilities |
Obiekt |
Opis możliwości czujników. |
availableStates |
Tablica |
Wymagany. Lista stanów dostępnych dla urządzenia. Stan „nieznany” jest domyślnie obsługiwany, gdy czujnik nie zwraca wartości. |
[item, ...] |
Ciąg |
Obsługiwana wartość opisowa. Wymagany jest co najmniej 1 element. |
numericCapabilities |
Obiekt |
Opisuje możliwe wartości liczbowe, które czujnik może zgłosić. |
rawValueUnit |
Ciąg |
Wymagany. Obsługiwana jednostka liczbowa. |
Więcej informacji na temat różnych możliwości i typów czujników obsługiwanych przez dany atrybut znajdziesz w sekcji Obsługiwane czujniki.
Przykłady
Urządzenie czujnikowe, które zgłasza opisową wartość stanu.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Urządzenie czujnikowe, które raportuje wartość stanu.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Urządzenie czujnikowe, które raportuje wartość opisową i numeryczną.
{ "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 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. |
Wartość filtra od początku śledzenia
Nazwa | Opisowe możliwości | Funkcje liczbowe |
---|---|---|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obsługiwane wartości:
|
Obliczony okres ważności 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:
|
Cząstki
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
W ramach operacji QUERY
encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
currentSensorStateData |
Tablica |
Wymagany. Lista bieżących stanów czujników. |
[item, ...] |
Obiekt |
Bieżący stan czujnika. |
name |
Ciąg |
Wymagany. Nazwa stanu czujnika. Dopasowuje wartość z |
currentSensorState |
Ciąg |
Bieżąca wartość opisowa stanu. Dopasowuje wartość z |
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 dany atrybut znajdziesz w sekcji Obsługiwane czujniki.
Przykłady
Urządzenie czujnikowe, które zgłasza opisową wartość stanu.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Urządzenie czujnikowe, które raportuje wartość stanu.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Urządzenie czujnikowe, które raportuje wartość opisową i numeryczną.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
Polecenie urządzenia
Brak.
POWIADOMIENIA O URZĄDZENIACH
W przypadku zmiany stanu urządzenia urządzenia z tą cechą mogą zwracać ładunek powiadomień. Więcej informacji o wdrażaniu powiadomień znajdziesz w artykule Powiadomienia dotyczące inteligentnych działań w domu.
Pola | Typ | Opis |
---|---|---|
SensorState |
Obiekt |
Wymagany. Ładunek powiadomienia. |
priority |
Liczba całkowita |
Wymagany. Określa poziom powiadomienia. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być odczytywane na głos. |
name |
Ciąg |
Wymagany. Nazwa stanu czujnika. Zobacz listę obsługiwanych typów czujników powiadomień. |
currentSensorState |
Ciąg |
Wymagany. Bieżąca wartość opisowa stanu. Zobacz listę obsługiwanych typów czujników powiadomień. |
Ładunek powiadomienia może zawierać te typy czujników:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
W sekcji Obsługiwane czujniki znajdziesz szczegółowe informacje o funkcjach obsługiwanych przez poszczególne typy czujników.
Przykłady
Urządzenie
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }