Schemat cechy Smart Home SensorState

action.devices.traits.SensorState – ta cecha obejmuje zarówno pomiary ilościowe, jak i jakościowe.

Urządzenia – ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać te problemy jako część operacji SYNC. Aby się uczyć więcej informacji o obsłudze intencji SYNC znajdziesz tutaj Realizacja intencji.

Atrybuty	Typ	Opis
sensorStatesSupported	Tablica	Wymagane. Każdy obiekt reprezentuje funkcje stanu czujnika obsługiwane przez to konkretne urządzenie. Każdy czujnik musi mieć przynajmniej funkcje opisowe lub liczbowe. Czujniki mogą też zgłaszać obie te wartości. W takim przypadku preferowana będzie 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 dostępnych stanów urządzenia. Atrybut „nieznany” ten stan 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 o różnych modelach urządzeń znajdziesz w sekcji Obsługiwane czujniki. możliwości i typy czujników, które obsługuje ta cecha.

Przykłady

Urządzenie czujnika przesyłające opisową wartość stanu.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Czujnik, który zgłasza wartość liczbową stanu.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Czujnik, który zgłasza opisową i liczbową 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 oraz powiązanych z nimi funkcji.

Jakość powietrza

Nazwa	Funkcje opisowe	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	Funkcje opisowe	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	Funkcje opisowe	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	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: FilterCleanliness	Obsługiwane wartości: clean dirty needs replacement unknown	Nieobsługiwane.

Wyciek wody

Nazwa	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: WaterLeak	Obsługiwane wartości: leak no leak unknown	Nieobsługiwane.

Wykrywanie deszczu

Nazwa	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: RainDetection	Obsługiwane wartości: rain detected no rain detected unknown	Nieobsługiwane.

Czas eksploatacji filtra

Nazwa	Funkcje opisowe	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 eksploatacji filtra

Nazwa	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Nieobsługiwane.	Obsługiwane wartości: PERCENTAGE

Stężenie dwutlenku węgla

Nazwa	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: CarbonDioxideLevel	Nieobsługiwane.	Obsługiwane wartości: PARTS_PER_MILLION

Pył zawieszony

Nazwa	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: PM2.5 PM10	Nieobsługiwane.	Obsługiwane wartości: MICROGRAMS_PER_CUBIC_METER

Lotne związki organiczne

Nazwa	Funkcje opisowe	Funkcje liczbowe
Obsługiwane wartości: VolatileOrganicCompounds	Nieobsługiwane.	Obsługiwane wartości: PARTS_PER_MILLION

Urządzenie STATES

Jednostki o tej cechie mogą zgłaszać: stanów w ramach operacji QUERY. Aby się uczyć więcej informacji o obsłudze intencji QUERY znajdziesz tutaj Realizacja intencji.

Stany	Typ	Opis
currentSensorStateData	Tablica	Wymagane. Lista bieżących stanów czujnika.
[item, ...]	Obiekt.	Bieżący stan czujnika.
name	String	Wymagane. Nazwa stanu czujnika. Pasuje do wartości z: sensorStatesSupported.
currentSensorState	String	Bieżąca opisowa wartość stanu. Pasuje do wartości z: sensorStatesSupported.
rawValue	Number	Bieżąca wartość liczbowa czujnika.

Więcej informacji o różnych modelach urządzeń znajdziesz w sekcji Obsługiwane czujniki. możliwości i typy czujników, które obsługuje ta cecha.

Przykłady

Urządzenie czujnika przesyłające opisową wartość stanu.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Czujnik, który zgłasza wartość liczbową stanu.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Czujnik, który zgłasza opisową i liczbową wartość stanu.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

Polecenia na urządzeniu

Brak.

POWIADOMIENIA NA urządzeniu

Urządzenia z tą cechą mogą zwracać te wartości: ładunek powiadomień w ramach zmiany stanu urządzenia. Aby się uczyć więcej o implementowaniu powiadomień, zobacz Powiadomienia dotyczące działań inteligentnego domu.

Pola	Typ	Opis
SensorState	Obiekt.	Wymagane. Dane powiadomień.
priority	Liczba całkowita	Wymagane. Reprezentuje poziom powiadomień. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być wypowiadane na głos.
name	String	Wymagane. Nazwa stanu czujnika. Sprawdź listę obsługiwanych typów czujników powiadomień.
currentSensorState	String	Wymagane. Bieżąca opisowa wartość stanu. Sprawdź 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 różnych modelach urządzeń znajdziesz w sekcji Obsługiwane czujniki. możliwości obsługiwanych przez poszczególne typy czujników.

Przykłady

Urządzenie wykrywa dym

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

Urządzenie ERRORS

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