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: AirQuality	Obsługiwane wartości: healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	Obsługiwane wartości: AQI

Tlenek węgla

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: CarbonMonoxideLevel	Obsługiwane wartości: carbon monoxide detected high no carbon monoxide detected unknown	Obsługiwane wartości: PARTS_PER_MILLION

Poziom zadymienia

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: SmokeLevel	Obsługiwane wartości: smoke detected high no smoke detected unknown	Obsługiwane wartości: PARTS_PER_MILLION

Czystość filtra

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: FilterCleanliness	Obsługiwane wartości: clean dirty needs replacement unknown	Nieobsługiwane.

Wyciek wody

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: WaterLeak	Obsługiwane wartości: leak no leak unknown	Nieobsługiwane.

Wykrywanie deszczu

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: RainDetection	Obsługiwane wartości: rain detected no rain detected unknown	Nieobsługiwane.

Czas eksploatacji filtra

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: FilterLifeTime	Obsługiwane wartości: new good replace soon replace now unknown	Obsługiwane wartości: PERCENTAGE

Obliczony czas życia filtra

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Nieobsługiwane.	Obsługiwane wartości: PERCENTAGE

Stężenie dwutlenku węgla

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: CarbonDioxideLevel	Nieobsługiwane.	Obsługiwane wartości: PARTS_PER_MILLION

Pył zawieszony

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: PM2.5 PM10	Nieobsługiwane.	Obsługiwane wartości: MICROGRAMS_PER_CUBIC_METER

Lotne związki organiczne

Nazwa	Opisowe możliwości	Funkcje liczbowe
Obsługiwane wartości: VolatileOrganicCompounds	Nieobsługiwane.	Obsługiwane wartości: PARTS_PER_MILLION

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 sensorStatesSupported.
currentSensorState	String	Bieżąca wartość opisowa stanu. Pasuje do wartości z sensorStatesSupported.
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

Wykrywa dym.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.