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

스마트 홈이 특성 스키마를 전환함

action.devices.traits.Toggles - 이 특성은 두 상태 중 하나에만 존재할 수 있는 설정을 가진 모든 기기에 속합니다.

이러한 설정은 켜기/끄기, 활성/비활성 상태의 실제 버튼, HTML의 체크박스 또는 기타 구체적으로 사용 설정/사용 중지된 요소를 나타낼 수 있습니다. 설정의 상태가 3개 이상이거나 바이너리 옵션 중 어느 것도 선택되어 있지 않은 상태의 경우 다중 모드 다이얼, 라디오 버튼 (물리적 또는 HTML) 또는 명시적으로 사용/사용 중지되지 않은 바이너리 상태 (예: 'AM/FM' 또는 '핫/콜드')와 같은 모드 특성으로 표현됩니다.

이 특성은 사용자가 설정할 수 있는 하나 이상의 개별 전환을 다룹니다. 일반적으로 이러한 전환 버튼은 다른 기기 동작에서 연결 해제된 기능에 사용해야 합니다. 기기 자체를 켜거나 끄는 것과 같은 연결된 동작에서는 더 구체적인 특성 (예: TemperatureSetting 특성의 thermostatMode)을 사용해야 합니다.

기기 속성

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

속성 유형 설명
availableToggles 배열

필수.

사용 가능한 전환 목록

[item, ...] 객체

사용 가능한 전환 버튼

name String

필수.

명령어 및 상태에 사용될 전환 버튼의 내부 이름입니다. 이 버전은 사용자 친화적이지 않을 수 있으며 모든 언어로 공유됩니다.

name_values 배열

필수.

지원되는 각 언어로 된 전환 동의어입니다.

[item, ...] 객체

특정 언어로 된 토글 동의어.

name_synonym 배열

필수.

전환 동의어입니다. 이 목록의 첫 번째 문자열은 해당 언어의 표준 이름으로 사용됩니다.

[item, ...] String

동의어 이름입니다.

lang String

필수.

언어 코드 (ISO 639-1). 지원되는 언어를 참고하세요.

commandOnlyToggles Boolean

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요.

queryOnlyToggles Boolean

(기본값: false)

기기가 쿼리 전용 실행을 지원하는 경우 필요합니다. 이 속성은 기기를 상태 정보에 대해서만 쿼리할 수 있으며 제어할 수 없는지 여부를 나타냅니다.

여러 전환 스위치가 있는 기기

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

명령어 전용 전환 기능이 있는 기기

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

쿼리 전용 전환 기능이 있는 기기

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

기기 상태

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

상태 유형 설명
currentToggleSettings 객체

필수.

기기의 전환 버튼 name를 키로, 현재 상태를 값으로 사용하는 키-값 쌍입니다.

<string> Boolean

현재 전환 상태입니다.

살균 처리되어 있나요?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

기기 명령어

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

action.devices.commands.SetToggles

지정된 전환 상태를 설정합니다.

매개변수

매개변수 유형 설명
updateToggleSettings 객체

필수.

기기의 전환 버튼 name를 키로, 새 상태를 값으로 사용하는 키-값 쌍입니다.

<string> Boolean

새 전환 상태

에너지 절약 기능을 사용 설정합니다.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

필터를 사용 중지합니다.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

샘플 발화

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 急速冷凍 つけて
  • 冷蔵庫 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze frysen

기기 오류

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