Schemat cechy SensorState w inteligentnym domu

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

ATRYBUTY URZĄDZENIA

Urządzenia z tą cechą mogą raportować te atrybuty w ramach operacji SYNC. Więcej informacji o obsługiwaniu intencji SYNC znajdziesz w artykule 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 jedną funkcję opisową lub liczbową. Sensory mogą też przekazywać obie wartości, w którym przypadku preferowana jest wartość liczbowa.
[item, ...] Obiekt

Obsługiwane funkcje czujnika.

Wymaga co najmniej 1 elementu.
name String

Wymagany.

Obsługiwany typ czujnika. Zobacz tabelę Obsługiwane czujniki.
descriptiveCapabilities Obiekt

Opis możliwości czujnika.
availableStates Tablica

Wymagany.

Lista dostępnych stanów urządzenia. Stan „unknown” (nieznany) jest obsługiwany domyślnie, gdy czujnik nie zwraca wartości.
[item, ...] String

Obsługiwana wartość stanu opisowego.

Wymaga co najmniej 1 elementu.
numericCapabilities Obiekt

Opisuje możliwe wartości liczbowe, które może podać czujnik.
rawValueUnit String

Wymagany.

Obsługiwana jednostka liczbowa.

Więcej informacji o różnych możliwościach i typach czujników obsługiwanych przez tę cechę znajdziesz w sekcji Obsługiwane czujniki.

Przykłady

Urządzenie czujnika, które przekazuje opisową wartość stanu.

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

Urządzenie czujnika, które przekazuje wartość stanu liczbowego.

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

Urządzenie z czujnikiem, które przesyła 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 i ich możliwości.

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

STANY URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
currentSensorStateData Tablica

Wymagany.

Lista bieżących stanów czujników.
[item, ...] Obiekt

Bieżący stan czujnika.
name String

Wymagany.

Nazwa stanu czujnika. Pasuje do wartości z sensorStatesSupported.
currentSensorState String

Bieżąca wartość stanu opisowego. Pasuje do wartości z sensorStatesSupported.
rawValue Number

Bieżąca wartość liczbowa czujnika.
alarmState String

Stan alarmu odpowiadający bieżącemu odczytowi czujnika. Gdy odczyty czujnika zbliżają się do niebezpiecznych poziomów lub osiągają je, może zostać uruchomiony wstępny alarm lub alarm.

Obsługiwane wartości:

IDLE
Alarm jest nieaktywny; wykryte poziomy nie są niebezpieczne.
PRE_ALARM_1
Wykryte poziomy są podwyższone, ale nie osiągnęły jeszcze poziomu alarmowego. Mogą wkrótce stać się niebezpieczne.
PRE_ALARM_2
Jeśli urządzenie obsługuje wiele alertów przed osiągnięciem poziomu alarmowego, oznacza to wyższy poziom wykrywania niż PRE_ALARM_1. Poziomy stale rosną i wkrótce mogą osiągnąć poziom alarmowy.
ALARM
Wykryte poziomy osiągnęły stan alarmowy i wystąpił alarm.
alarmSilenceState String

Wskazuje stan wyciszenia alarmu czujnika, w tym czy wyciszenie aktywnego alarmu jest obecnie dozwolone. Ten stan może być podany, gdy aktywny jest stan przed alarmem lub alarm. W przypadku czujnika dymu nie używa się wartości ALLOWED ani DISALLOWED. Aplikacja Google Home ma wbudowaną logikę, która określa, czy alarm można wyciszyć z aplikacji.

Obsługiwane wartości:

ALLOWED
Alarm nie jest wyciszony i można go wyciszyć.
DISALLOWED
Alarm nie jest wyciszony i nie można go wyciszyć.
SILENCED
Alarm został wyciszony.

Więcej informacji o różnych możliwościach i typach czujników obsługiwanych przez tę cechę znajdziesz w sekcji Obsługiwane czujniki.

Przykłady

Urządzenie czujnika, które przekazuje opisową wartość stanu.

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

Urządzenie czujnika, które przekazuje wartość stanu liczbowego.

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

Urządzenie z czujnikiem, które przesyła opisową i liczbową wartość stanu.

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

Urządzenie z czujnikiem, które przekazuje opisową i liczbową wartość stanu oraz wskazuje, że alarm jest aktywny.

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

Urządzenie z czujnikiem, które przekazuje opisową i liczbową wartość stanu oraz wskazuje, że alarm jest wyciszony.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "SILENCED"
    }
  ]
}

Polecenia urządzenia

Brak.

POWIADOMIENIA NA URZĄDZENIU

Urządzenia z tą cechą mogą zwracać następujący ładunek powiadomienia w ramach zmiany stanu urządzenia. Więcej informacji o implementowaniu powiadomień znajdziesz w artykule Powiadomienia dla działań związanych z inteligentnym domem.

Pola Typ Opis
SensorState Obiekt

Wymagany.

Treść powiadomienia.
priority Liczba całkowita

Wymagany.

Reprezentuje poziom powiadomienia. Obecnie obsługiwana wartość to 0, która oznacza, że powiadomienie powinno być odczytane na głos.
name String

Wymagany.

Nazwa stanu czujnika. Zobacz listę obsługiwanych typów czujników do powiadomień.
currentSensorState String

Wymagany.

Bieżąca wartość stanu opisowego. Zobacz listę obsługiwanych typów czujników do powiadomień.

Ładunek powiadomienia może 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"
  }
}

BŁĘDY urządzenia

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