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

스마트 홈 OnOff 속성 스키마

action.devices.traits.OnOff - 플러그와 스위치, 향후 출시될 기기 등 바이너리를 켜거나 끄는 모든 기기의 기본 켜기 및 끄기 기능

기기 속성

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

속성 유형 설명
commandOnlyOnOff Boolean

(기본값: false)

기기가 명령어를 통해서만 제어할 수 있고 상태 정보를 쿼리할 수 없는지 여부를 나타냅니다.

queryOnlyOnOff Boolean

(기본값: false)

기기를 상태 정보에 대해서만 쿼리할 수 있고 명령어를 통해 제어할 수 없는지 여부를 나타냅니다.

사용/사용 중지 명령어 및 보고 상태를 지원하는 기기

{
  "commandOnlyOnOff": false,
  "queryOnlyOnOff": false
}

사용/사용 중지 명령어만 지원하는 기기

{
  "commandOnlyOnOff": true,
  "queryOnlyOnOff": false
}

기기의 켜기/끄기 상태만 지원하는 기기 (일반적으로 센서)

{
  "queryOnlyOnOff": true,
  "commandOnlyOnOff": false
}

기기 상태

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

상태 유형 설명
on Boolean

켜기/끄기 스위치가 있는 기기의 전원 켜기 또는 끄기

기기가 켜져 있나요?

{
  "on": true
}

기기가 꺼져 있나요?

{
  "on": false
}

기기 명령어

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

action.devices.commands.OnOff

기기를 켜거나 끕니다.

매개변수

매개변수 유형 설명
on Boolean

필수.

기기 켜기 또는 끄기

기기를 켭니다.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": true
  }
}

기기를 끕니다.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": false
  }
}

샘플 발화

de-DE

  • Bitte Licht aus
  • Bitte das Wohnzimmer einschalten
  • Bitte die Küche ausstellen
  • Lampen an

en-US

  • turn off the AC
  • turn on my lights

es-ES

  • enciende el robot de limpieza
  • enciéndeme el salón

fr-FR

  • Tu peux éteindre le salon ?
  • allume la chambre
  • allume les lumières
  • éteins les lumières

hi-IN

  • किचन को ऑन करो
  • बत्तियाँ जला दें
  • बालकनी ऑफ कर दो
  • लाइट ऑफ करो

it-IT

  • Accendimi la luce in cucina
  • accendere in cucina
  • spegni la luce della camera
  • spengi camera bimbi

ja-JP

  • ベッドルーム をつけて
  • リビング をオフにして
  • 照明 をオンにして
  • 照明 を消して

ko-KR

  • 거실 꺼 줘
  • 거실 에어컨 전원 켜
  • 거실 켜 줘
  • 에어컨 전원 꺼 줘

nl-NL

  • babykamer aandoen
  • doe het licht aan
  • doe het licht uit

pt-BR

  • Acender a luz .
  • Apagar a luz .
  • acender a sala
  • quero desligar o quarto

sv-SE

  • stäng av lampan
  • sätt på ljuset

기기 오류

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