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 klucza inteligentnego wyboru urządzenia domowego

action.devices.traits.InputSelector – ten atrybut jest używany w przypadku urządzeń, które mogą zmieniać wejście.

Dane wejściowe multimediów mogą mieć dynamiczne nazwy na urządzenie reprezentujące kanały audio lub wideo. Takie kanały mogą być przewodowe lub sieciowe, ale powinny być nazywane i trwałe. Ten atrybut nie obsługuje dowolnych plików efemerycznych, np. biblioteki z możliwością wyszukiwania w sieci. Obsługiwane są sparowane źródła Bluetooth Źródła mogą mieć wiele nazw, dlatego nazwy utworzone i wykryte przez użytkownika są obsługiwane, a także domyślne, np. „hdmi_1” może być też „odtwarzacz DVD” lub „usb_1” albo „dysk twardy”.

Dane wejściowe w mediach można posortować, tak aby obsługiwały polecenia „next” i „next”.

Podobnie jak w przypadku Togles i Trybów nazwy danych wejściowych należy podawać we wszystkich dostępnych językach. Jest to szczególnie ważne w przypadku nazw domyślnych.

ATRYBUTY na urządzeniu

Urządzenia z tą cechą mogą zgłaszać w ramach operacji SYNC te atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
availableInputs Tablica

Wymagane.

Lista obiektów reprezentujących wejściowe kanały audio i wideo. Pliki danych mogą być przewodowe lub sieciowe. Każdy plik danych powinien mieć nazwę, która będzie trwała. Pamiętaj, aby dokładnie zdefiniować synonimy, aby uniknąć niepożądanych (nadmiernych) wywołań.

[item, ...] Obiekt

Dostępne dane wejściowe.

key Ciąg

Wymagane.

Unikalny klucz do wprowadzania danych. Klucz nie powinien być dostępny dla użytkowników za pomocą mowy lub odpowiedzi.

names Tablica

Wymagane.

Lista nazw danych wejściowych we wszystkich dostępnych językach.

[item, ...] Obiekt

Dane wejściowe dla danego dostępnego języka.

lang Ciąg

Wymagane.

Kod języka.

name_synonym Tablica

Wymagane.

Przyjazne dla użytkowników nazwy wprowadzane w danym języku. Pierwszy synonim jest używany w odpowiedzi Asystenta Google na użytkownika.

[item, ...] Ciąg

Nazwa urządzenia wejściowego.

commandOnlyInputSelector Wartość logiczna

(Domyślnie: false)

Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) lub dwukierunkową (fałsz). Ustaw ten atrybut na wartość „true”, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu.

orderedInputs Wartość logiczna

(Domyślnie: false)

Prawda, jeśli lista danych wyjściowych jest uporządkowana. Oznacza to również, że dostępne są funkcje „dalej” i „poprzednie”.

Przykłady

Urządzenie z 2 uporządkowanymi danymi wejściowymi.

{
  "availableInputs": [
    {
      "key": "hdmi_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "hdmi 1",
            "1st hdmi",
            "DVD player"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "hdmi 1",
            "zuerst hdmi",
            "DVD Spieler"
          ]
        }
      ]
    },
    {
      "key": "usb_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "usb 1",
            "first usb",
            "Hard drive"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "usb 1",
            "zuerst usb",
            "Festplatte"
          ]
        }
      ]
    }
  ],
  "orderedInputs": true
}

STANY urządzenia

Urządzenia z tą cechą mogą w ramach operacji QUERY zgłaszać następujące stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
currentInput Ciąg

Wymagane.

Klucz obecnie używanego sygnału.

Przykłady

Obecnie wybrane urządzenie wejściowe HDMI.

{
  "currentInput": "hdmi_1"
}

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą w ramach operacji EXECUTE reagować na następujące polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.SetInput

Skonfiguruj wejście multimediów.

Parametry

Parametry Typ Opis
newInput Ciąg

Wymagane.

Klucz nowego wejścia.

Przykłady

Wybierz wejście USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

Wybierz następne wejście. Ma zastosowanie tylko wtedy, gdy atrybut orderedInputs ma wartość Prawda.

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

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

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

action.devices.commands.PreviousInput

Wybierz poprzednie wejście. Ma zastosowanie tylko wtedy, gdy atrybut orderedInputs ma wartość Prawda.

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

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

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

Przykładowe wypowiedzi

de-DE

  • ąndere den Eingangskanal auf AUX .

en-US

  • zmień tryb wprowadzania na HDMI 1

es-ES

  • cambia a hdmi 1

fr-FR

  • Aktywacja w trybie duplikowania HDMI1 .
  • Mets la télé sur HDMI 1 .

Urządzenie ERRORS

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

unsupportedInput: ta wartość nie jest obecnie obsługiwana.