스마트 홈 InputSelector 트레잇 스키마

action.devices.traits.InputSelector - 이 트레잇은 입력을 전환할 수 있는 기기에 사용됩니다.

미디어 입력에는 오디오 또는 동영상 피드를 나타내는 기기별 동적 이름이 있을 수 있습니다. 이러한 피드는 유선으로 연결되거나 네트워크에 연결될 수 있지만 이름이 지정되어 있고 상당히 지속적이어야 합니다. 이 트레잇은 검색 가능한 네트워크 라이브러리와 같은 임시 피드를 지원하지 않습니다. 페어링되고 이름이 지정된 블루투스 소스가 지원됩니다. 소스 이름은 여러 개일 수 있으므로 사용자가 만들고 검색한 이름뿐 아니라 기본 이름도 지원됩니다. 예를 들어 'hdmi_1'은 'DVD 플레이어'일 수도 있고 'usb_1'은 '하드 드라이브'일 수도 있습니다.

미디어 입력은 '다음' 및 '이전' 명령어를 지원하도록 순서를 지정할 수 있습니다.

Toggles 및 Modes와 마찬가지로 입력 이름은 사용 가능한 모든 언어로 제공되어야 합니다. 이는 특히 기본 이름과 관련이 있습니다.

기기 속성

이 트레잇이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
availableInputs 배열

필수사항.

입력 오디오 또는 동영상 피드를 나타내는 객체 목록입니다. 피드는 유선 또는 네트워크를 통해 연결할 수 있습니다. 각 피드는 이름이 지정되고 적절하게 영구적이어야 합니다. 동의어를 신중하게 정의하여 원치 않는 (과다) 트리거가 발생하지 않도록 해야 합니다.
[item, ...] 객체

사용 가능한 입력
key String

필수사항.

입력의 고유 키입니다. 음성이나 응답으로 사용자에게 키를 노출해서는 안 됩니다.
names 배열

필수사항.

사용 가능한 모든 언어의 입력 이름 목록입니다.
[item, ...] 객체

사용 가능한 특정 언어의 입력입니다.
lang String

필수사항.

언어 코드입니다.
name_synonym 배열

필수사항.

지정된 언어로 된 입력의 사용자 친화적인 이름입니다. 첫 번째 동의어는 Google 어시스턴트가 사용자에게 응답할 때 사용됩니다.
[item, ...] String

이름을 입력합니다.
commandOnlyInputSelector Boolean

(기본값: false)

기기가 단방향(true) 또는 양방향(false) 통신 사용을 지원하는지 나타냅니다. 기기가 이 트레잇의 QUERY 인텐트 또는 Report State에 응답할 수 없는 경우 이 속성을 true로 설정합니다.
orderedInputs Boolean

(기본값: false)

출력 목록이 정렬되어 있으면 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é 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

기기 오류

오류 및 예외의 전체 목록을 참고하세요.

unsupportedInput: 현재 입력이 지원되지 않습니다.