Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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.