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

Wyciek wody

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

Wykrywanie deszczu

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

Czas trwania filtra

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

Obliczony czas trwania filtra

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

Stężenie dwutlenku węgla

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

pyły zawieszone

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

Bezpłatne związki organiczne

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

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 sensorStatesSupported.
currentSensorState	String	Bieżąca wartość opisowa stanu. Odpowiada wartości parametru sensorStatesSupported.
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 wykrywa dym.

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

Urządzenie ERRORS

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