스마트 홈 InputSelector 속성 스키마
action.devices.traits.InputSelector
: 이 특성은 입력을 전환할 수 있는 기기에 사용됩니다.
미디어 입력에는 기기마다 오디오 또는 동영상 피드를 나타내는 동적 이름이 있을 수 있습니다. 이러한 피드는 유선 연결되거나 네트워킹될 수 있지만, 이름이 지정되고 일정하게 지속되어야 합니다. 이 특성은 검색 가능한 네트워크 라이브러리와 같은 임의의 임시 피드를 지원하지 않습니다. 페어링되고 이름이 지정된 블루투스 소스가 지원됩니다. 소스에는 이름이 여러 개 있을 수 있으므로 사용자가 만들고 발견한 이름과 기본 이름이 지원됩니다. 예를 들어 'hdmi_1'은 'DVD 플레이어' 또는 'usb_1'도 '하드 드라이브'일 수 있습니다.
미디어 입력을 정렬하여 '다음' 및 '이전' 명령어를 지원할 수 있습니다.
전환 및 모드와 마찬가지로 입력 이름은 사용 가능한 모든 언어로 제공되어야 합니다. 이는 기본 이름과 특히 관련이 있습니다.
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
availableInputs |
배열 |
필수. 입력 오디오 또는 동영상 피드를 나타내는 객체 목록입니다. 피드는 유선 연결되거나 네트워크에 연결될 수 있습니다. 각 피드는 이름이 지정되어야 하며 상당히 영구적이어야 합니다. 원치 않는 과도한 트리거가 발생하지 않도록 동의어를 신중하게 정의해야 합니다. |
[item, ...] |
객체 |
사용 가능한 입력입니다. |
key |
String |
필수. 입력의 고유 키입니다. 키는 음성이나 응답으로 사용자에게 노출되어서는 안 됩니다. |
names |
배열 |
필수. 사용 가능한 모든 언어의 입력 이름 목록입니다. |
[item, ...] |
객체 |
사용 가능한 특정 언어로 입력합니다. |
lang |
String |
필수. 언어 코드입니다. |
name_synonym |
배열 |
필수. 지정된 언어로 된 사용자 친화적인 입력 이름. 첫 번째 동의어는 Google 어시스턴트의 사용자 응답에서 사용됩니다. |
[item, ...] |
String |
입력 이름입니다. |
commandOnlyInputSelector |
Boolean |
(기본값: 기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요. |
orderedInputs |
Boolean |
(기본값: 출력 목록이 정렬된 경우 true입니다. 또한 '다음' 및 '이전' 기능을 사용할 수 있음을 나타냅니다. |
예
두 가지 순서가 지정된 입력이 있는 기기.
{ "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 }
기기 상태
이 특성이 있는 기기는 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
상태 | 유형 | 설명 |
---|---|---|
currentInput |
String |
필수. 현재 사용 중인 입력의 키입니다. |
예
현재 HDMI 입력이 선택된 기기입니다.
{ "currentInput": "hdmi_1" }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.SetInput
미디어 입력을 설정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
newInput |
String |
필수. 새 입력의 키입니다. |
예
USB 입력 선택
{ "command": "action.devices.commands.SetInput", "params": { "newInput": "usb_1" } }
action.devices.commands.NextInput
다음 입력을 선택합니다. orderedInputs
속성이 true로 설정된 경우에만 적용됩니다.
{ "orderedInputs": true }속성이 필요합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.NextInput", "params": {} }
action.devices.commands.PreviousInput
이전 입력을 선택합니다. orderedInputs
속성이 true로 설정된 경우에만 적용됩니다.
{ "orderedInputs": true }속성이 필요합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.PreviousInput", "params": {} }
샘플 발화
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é surHDMI 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 opbluetooth
pt-BR
-
Muda a entrada da
TV paraHDMI2 . -
mudar a entrada para
AUX
sv-SE
-
Sätt på
hdmi 1
기기 오류
오류 및 예외의 전체 목록을 참조하세요.unsupportedInput
: 현재 지원되지 않는 입력입니다.