스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 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

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 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: 현재 지원되지 않는 입력입니다.