스마트 홈 AppSelector 트레잇 스키마

action.devices.traits.AppSelector: 이 특성은 애플리케이션 간에 전환할 수 있는 기기에 사용됩니다.

기기 ATTRIBUTES

이 특성이 있는 기기는 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 på TV:n

기기 오류

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