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 inteligentnego efektu inteligentnego domu

action.devices.traits.LightEffects – ten atrybut należy do urządzeń, które obsługują złożone polecenia oświetleniowe służące do zmiany stanu, np. odtwarzania w różnych kolorach.

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
defaultColorLoopDuration Liczba całkowita

(domyślnie: 1800)

Domyślny czas (w sekundach) dla efektu wywołanego przez polecenie action.devices.commands.ColorLoop.

defaultSleepDuration Liczba całkowita

(domyślnie: 1800)

Domyślny czas (w sekundach) dla efektu wywołanego przez polecenie action.devices.commands.Sleep.

defaultWakeDuration Liczba całkowita

(domyślnie: 1800)

Domyślny czas (w sekundach) dla efektu wywołanego przez polecenie action.devices.commands.Wake.

supportedEffects Tablica

Wymagany.

Lista efektów obsługiwanych przez urządzenie.

[item, ...] Ciąg

Obsługiwany efekt.

Obsługiwane wartości:

colorLoop
Losowo zmienia się przez różne kolory.
sleep
stopniowo obniża jasność i opcjonalnie koryguje temperaturę kolorów na przestrzeni czasu.
wake
stopniowo zwiększa jasność i opcjonalnie koryguje temperaturę kolorów na przestrzeni czasu.

Przykłady

Efekt działania pętli kolorów na urządzeniu.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Urządzenie obsługujące efekty snu i wybudzenia.

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

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
activeLightEffect Ciąg

Aktualnie aktywny efekt świetlny (jeśli istnieje). Jeden z supportedEffects

Obsługiwane wartości:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Liczba całkowita

Sygnatura czasowa uniksowa, która zgodnie z przewidywanym efektem ma się zakończyć.

Przykłady

Jaki jest obecny wpływ na moje urządzenie?

{
  "activeLightEffect": "colorLoop"
}

Jaki jest obecny wpływ na moje urządzenie?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

Brak efektu świetlnego.

{}

Polecenie urządzenia

W ramach operacji EXECUTE urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.ColorLoop

Poproś urządzenie o cykle kolorów.

To polecenie wymaga tych atrybutów:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parametry

Parametry Typ Opis
duration Liczba całkowita

Czas trwania polecenia koloru (w sekundach).

Przykłady

Popętlaj kolor moich lampek przez 60 minut.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

Stopniowo zmniejszaj jasność urządzenia i opcjonalnie reguluj temperaturę kolorów na przestrzeni czasu.

To polecenie wymaga tych atrybutów:
{
  "supportedEffects": [
    "sleep"
  ]
}

Parametry

Parametry Typ Opis
duration Liczba całkowita

Czas trwania polecenia uśpienia (w sekundach).

Przykłady

Pozwól mi zapalić światła na 60 minut.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

Zatrzymaj bieżący efekt świetlny.

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Wyłącz światło.

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

Stopniowo zwiększaj jasność urządzenia i opcjonalnie reguluje temperaturę kolorów na przestrzeni czasu.

To polecenie wymaga tych atrybutów:
{
  "supportedEffects": [
    "wake"
  ]
}

Parametry

Parametry Typ Opis
duration Liczba całkowita

Czas trwania polecenia wybudzania w sekundach.

Przykłady

Obudź światło na 60 minut.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

Emulacja efektów świetlnych

Jeśli Twoje urządzenie implementuje cechę Brightness, ale nie jest to cecha LightEffects, platforma obsługuje emulowane efekty snu i wybudzenia bez konieczności stosowania dodatkowego kodu. Platforma emuluje efekty, wysyłając serię intencji EXECUTE.

Przykładowe wypowiedzi

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

Urządzenie ERRORS

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