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

스마트 홈 AppSelector 특성 스키마

action.devices.traits.AppSelector: 이 특성은 입력을 전환할 수 있는 기기에 사용됩니다.

기기 속성

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

속성 유형 설명
availableApplications 배열

필수.

애플리케이션 목록입니다. 각 애플리케이션에는 지원되는 각 언어에 하나 이상의 동의어가 있습니다. 첫 번째 동의어가 응답에 사용됩니다.

[item, ...] 객체

이 기기의 사용자가 상호작용할 수 있는 애플리케이션

key String

필수.

음성 또는 응답으로 사용자에게 노출되지 않는 애플리케이션의 고유 키입니다.

names 배열

필수.

각 애플리케이션의 이름과 언어별 동의어

[item, ...] 객체

애플리케이션 동의어

name_synonym 배열

필수.

특정 언어로 된 애플리케이션 이름의 사용자 친화적인 동의어입니다. 첫 번째 동의어가 응답에 사용됩니다.

[item, ...] String

애플리케이션 이름입니다.

lang String

필수.

언어 코드입니다.

YouTube 앱이 설치된 기기

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "youtube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "youtube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

기기 상태

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

상태 유형 설명
currentApplication String

필수.

포그라운드에서 활성 상태인 현재 애플리케이션의 키 값입니다.

YouTube 앱이 현재 포그라운드에서 활성화되어 있는 기기

{
  "currentApplication": "youtube"
}

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.appInstall

지정된 애플리케이션을 설치합니다.

매개변수

매개변수 유형 설명
newApplication String

설치할 애플리케이션의 키입니다.

newApplicationName String

설치할 애플리케이션의 이름입니다.

키별 YouTube 앱 설치

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "youtube"
  }
}

이름으로 YouTube 앱 설치하기

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

지정된 애플리케이션을 검색합니다.

매개변수

매개변수 유형 설명
newApplication String

검색할 애플리케이션의 키입니다.

newApplicationName String

검색할 애플리케이션의 이름입니다.

키로 YouTube 앱 검색하기

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "youtube"
  }
}

이름으로 YouTube 앱 검색

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

지정된 애플리케이션을 선택합니다.

매개변수

매개변수 유형 설명
newApplication String

선택할 애플리케이션의 키입니다.

newApplicationName String

선택할 애플리케이션의 이름입니다.

키별 YouTube 앱 선택

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "youtube"
  }
}

이름으로 YouTube 앱 선택

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

샘플 발화

de-DE

  • Öffne Netflix auf dem Fernseher .

en-US

  • begin using YouTube app on the smart TV

es-ES

  • pon netflix en la tele del salón

fr-FR

  • Mets Netflix sur la télé .

hi-IN

  • टीवी पर नेटफ्लिक्स ऍप लॉन्च करो

it-IT

  • Apri Netflix sulla televisione della mia camera .

ja-JP

  • YouTube のアプリを テレビ でスタート

ko-KR

  • TV 에서 유튜브 앱 열어 줘

nl-NL

  • Start Netflix op mijn TV .

pt-BR

  • Abra o Netflix na TV para mim.
  • Abre o Youtube na televisão .

sv-SE

  • Öppna Youtube TV:n

기기 오류

오류 및 예외의 전체 목록을 참조하세요.
  • noAvailableApp: 애플리케이션이 존재하지 않거나 사용할 수 없습니다.
  • appLaunchFailed: 애플리케이션을 실행하지 못했습니다.
  • alreadyInstalledApp: 애플리케이션이 이미 설치되어 있습니다.