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 domu EnergyStorage

action.devices.traits.EnergyStorage – ten atrybut należy do urządzeń, które mogą przechowywać energię w baterii i mogą się naładować.

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
queryOnlyEnergyStorage Wartość logiczna

Wymagany.

Wartość to „prawda”, jeśli urządzenie obsługuje tylko zapytania o zapisany poziom energii i opcjonalnie stan ładowania aktywnego (zależnie od atrybutu isRechargeable), ale nie obsługuje rozpoczynania i zatrzymywania ładowania.

energyStorageDistanceUnitForUX Ciąg

(domyślnie: "KILOMETERS")

Będzie on używany w odpowiedziach użytkownika.

Obsługiwane wartości:

KILOMETERS
MILES
isRechargeable Wartość logiczna

(domyślnie: false)

Ustaw wartość „true”, jeśli urządzenie można doładować. Oznacza to, że urządzenie może raportować stan capacityUntilFull, isCharging i opcjonalnie isPluggedIn, a także akceptować polecenie Charge.

Przykłady

Urządzenie z możliwością ładowania

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

Urządzenie z możliwością ładowania, które pokazuje aktualny poziom naładowania w milach

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

Urządzenie, którego nie można ponownie naładować, obsługujące wyłącznie raportowanie bieżącego poziomu naładowania

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

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

Wymagany.

Wysokiej jakości opis poziomu energii. Dotyczy to sytuacji, gdy nie ma żadnych danych liczbowych. Jeśli dostępne są również dane liczbowe dotyczące pojemności, w miarę możliwości będą miały pierwszeństwo przed opisami.

Obsługiwane wartości:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Tablica

Tablica par jednostki/wartości, które zawierają informacje o zdolności energetycznej urządzenia. Na przykład: Ile mil korzysta obecnie z urządzenia <device> lub Jakie procent naładowania baterii ma <device>?

[item, ...] Obiekt

Pozostały rozmiar w parze jednostki i wartości.

rawValue Liczba całkowita

Wymagany.

Wartość pojemności.

unit Ciąg

Wymagany.

Jednostka pojemności.

Obsługiwane wartości:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Tablica

Tablica par jednostki/wartości przechowujących informacje o pojemności do momentu pełnego naładowania urządzenia. Na przykład: Ile czasu zostało do pełnego naładowania urządzenia <device>.

[item, ...] Obiekt

Wydajność do naładowania.

rawValue Liczba całkowita

Wymagany.

Wartość pojemności.

unit Ciąg

Wymagany.

Jednostka pojemności.

Obsługiwane wartości:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Wartość logiczna

Określa, czy urządzenie się ładuje.

isPluggedIn Wartość logiczna

Wskazuje, czy urządzenie jest podłączone. Urządzenie można podłączyć, ale się nie ładuje.

Przykłady

Urządzenie z możliwością ładowania

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Urządzenie z możliwością ładowania, które pokazuje aktualny poziom naładowania w milach

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Urządzenie, którego nie można ponownie naładować, obsługujące wyłącznie raportowanie bieżącego poziomu naładowania

{
  "descriptiveCapacityRemaining": "LOW"
}

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

Rozpocznij lub zatrzymaj ładowanie.

To polecenie wymaga tych atrybutów:
{
  "isRechargeable": true
}

Parametry

Parametry Typ Opis
charge Wartość logiczna

Wymagany.

Prawda, aby rozpocząć ładowanie, fałsz, aby zatrzymać ładowanie

Przykłady

Rozpocznij ładowanie polecenia

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Zatrzymaj ładowanie polecenia

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

Urządzenie ERRORS

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

deviceUnplugged: użytkownik próbował ładować urządzenie, które nie jest podłączone do zasilania.