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: 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: 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.
{ "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.
{ "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.