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.