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 wyboru wejścia do domu

action.devices.traits.InputSelector – to atrybut jest używany w przypadku urządzeń, które mogą przełączać sygnały wejściowe.

Wejściowe dane multimediów mogą mieć dynamiczne nazwy na urządzenie reprezentujące kanały audio lub wideo. Te kanały mogą być przewodowe lub sieciowe, ale powinny mieć nazwę i być trwałe. Ten atrybut nie obsługuje dowolnych tymczasowych plików danych, np. biblioteki sieci z możliwością wyszukiwania. Sparowane źródła Bluetooth są obsługiwane. Źródła mogą mieć wiele nazw, więc nazwy utworzone i wykryte przez użytkownika są obsługiwane, a także domyślne. Na przykład „hdmi_1” to na przykład „Odtwarzacz DVD”, a „usb_1” – dysk twardy.

Kolejność wprowadzania danych multimedialnych można ustawić tak, aby obsługiwała polecenia „next” i „previous”.

Tak jak w przypadku opcji Przełączniki i Tryby, nazwy wprowadzania powinny być podane we wszystkich dostępnych językach. Jest to szczególnie ważne w przypadku nazw domyślnych.

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
availableInputs Tablica

Wymagany.

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ę i być trwały. Zadbaj o to, żeby synonimy były dobrze zdefiniowane – pozwoli to uniknąć niepożądanych działań (nadmiernych).

[item, ...] Obiekt

Dostępne dane.

key Ciąg

Wymagany.

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

names Tablica

Wymagany.

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

[item, ...] Obiekt

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

lang Ciąg

Wymagany.

Kod języka.

name_synonym Tablica

Wymagany.

Łatwe do wprowadzania nazwy w danym języku. Asystent Google odpowiada pierwszemu synonimowi.

[item, ...] Ciąg

Nazwa urządzenia wejściowego.

commandOnlyInputSelector Wartość logiczna

(domyślnie: false)

Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy 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 wyników jest uporządkowana. Oznacza to również, że dostępne są funkcje „następne” i „poprzednie”.

Przykłady

Urządzenie z 2 wprowadzonymi wejściami.

{
  "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
}

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

Wymagany.

Klucz obecnie używanego klucza.

Przykłady

Obecnie jest wybrane urządzenie z wejściem HDMI.

{
  "currentInput": "hdmi_1"
}

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

Ustaw wejście audio.

Parametry

Parametry Typ Opis
newInput Ciąg

Wymagany.

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 dane wejściowe. 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 dane. 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

  • change input mode to HDMI 1

es-ES

  • cambia a hdmi 1

fr-FR

  • Activation du mode HDMI1 .
  • Mets la télé sur HDMI 1 .

hi-IN

  • टीवी की इनपुट HDMI 1 में स्विच करो

it-IT

  • metti ingresso aux sulla tv

ja-JP

  • テレビ HDMI1 にして

ko-KR

  • TV HDMI 1 로 바꿔 줘

nl-NL

  • zet de TV op bluetooth

pt-BR

  • Muda a entrada da TV para HDMI2 .
  • mudar a entrada para AUX

sv-SE

  • Sätt på hdmi 1

Urządzenie ERRORS

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

unsupportedInput: ta opcja nie jest obecnie obsługiwana.