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: 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.

Wartość filtra od początku śledzenia

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 okres ważności 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

Cząstki

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

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 sensorStatesSupported.
currentSensorState	Ciąg	Bieżąca wartość opisowa stanu. Dopasowuje wartość z 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 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 wykrywa dym.

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

Urządzenie ERRORS

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