Schemat funkcji selektora danych wejściowych inteligentnego domu

action.devices.traits.InputSelector – ta cecha jest używana na urządzeniach, które mogą przełączać wejścia.

Dane wejściowe multimediów mogą mieć dynamiczne nazwy poszczególnych urządzeń, które odpowiadają kanałom audio lub wideo. Takie kanały mogą być przewodowe lub sieciowe, ale powinny mieć nazwę i łatwo trwałe. Ta cecha nie obsługuje dowolnych tymczasowych kanałów, takich jak biblioteka sieciowa do przeszukiwania. Obsługiwane są sparowane źródła Bluetooth o nazwie. Źródła mogą mieć wiele nazw, więc nazwy utworzone i wykryte przez użytkownika oraz nazwy domyślne. Na przykład „hdmi_1” może oznaczać też „odtwarzacz DVD”, a „usb_1” może też być „dysk twardy”.

Sygnały wejściowe mogą być uporządkowane tak, by obsługiwały polecenia „next” i „previous”.

Podobnie jak w przypadku Toggles i Modes, nazwy danych wejściowych należy podawać we wszystkich dostępnych językach. Jest to szczególnie istotne w przypadku nazw domyślnych.

Urządzenie ATTRIBUTES

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

Atrybuty Typ Opis
availableInputs Tablica

Wymagane.

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

[item, ...] Obiekt

Dostępne dane wejściowe.

key String

Wymagane.

Unikalny klucz dla danych wejściowych. Nie należy ujawniać klucza podczas mówienia ani odpowiadania użytkownikom.

names Tablica

Wymagane.

Lista nazw danych wejściowych dla wszystkich dostępnych języków.

[item, ...] Obiekt

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

lang String

Wymagane.

Kod języka.

name_synonym Tablica

Wymagane.

Łatwe w obsłudze nazwy wpisywania tekstu w danym języku. Pierwszy synonim jest używany w odpowiedzi Asystenta Google.

[item, ...] String

Nazwa danych wejściowych.

commandOnlyInputSelector Wartość logiczna

(Domyślnie: false)

Określa, 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 tej cechy.

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 „następne” i „poprzednie”.

Przykłady

Urządzenie z 2 uporządkowanymi 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

Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule o realizacji intencji.

Stany Typ Opis
currentInput String

Wymagane.

Klucz aktualnie używanego źródła.

Przykłady

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

{
  "currentInput": "hdmi_1"
}

CommandS na urządzeniu

Urządzenia z tą cechą mogą reagować na podane niżej polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule o realizacji intencji.

action.devices.commands.SetInput

Ustaw wejście multimediów.

Parametry

Parametry Typ Opis
newInput String

Wymagane.

Klawisz dla nowych danych wejściowych.

Przykłady

Wybierz wejście USB

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

action.devices.commands.NextInput

Wybierz następne źródło sygnału. 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 źródło sygnału. 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: wartość nie jest obecnie obsługiwana.