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

스마트 홈 모드 특성 스키마

action.devices.traits.Modes - 이 특성은 기기에서 사용할 수 있는 모든 모드와 모드별 설정을 다룹니다.

이 특성은 임의의 'n-way' 모드가 있는 모든 기기에 속하며, 이 모드에서는 각 모드의 모드와 설정이 임의적이며 각 기기 또는 기기 유형에 고유합니다. 각 모드에는 여러 설정이 있을 수 있지만 한 번에 하나만 선택할 수 있습니다. 건조기는 '민감', '일반', '중량' 모드를 동시에 사용할 수 없습니다. 간단히 사용 설정 또는 중지할 수 있는 설정은 전환 특성에 속합니다.

예를 들어 세탁기의 적재량과 온도를 설정할 수 있습니다. 이 두 가지 모드는 서로 독립적이기 때문에 모두 모드가 되지만, 각 모드는 한 번에 하나의 상태에만 있을 수 있습니다. 사용자는 세탁기 온도를 냉방으로 설정과 같은 명령어를 사용하여 온도와 같은 모드를 명시적으로 설정할 수 있습니다.

일부 모드는 '정렬된' 상태이며 위/아래 조정, 음성 증가/감소로 조정할 수도 있습니다. 예를 들어 로드 크기 (소형, 중형, 대형)와 온도의 순서가 명확하게 정렬되어 있지만 (다른 기기와 마찬가지로 온도는 목표값이 있는 실제 온도 조절기가 아님) 로드 유형(섬세함, 보통, 양모 등)은 정렬 순서가 아닐 수 있습니다.

이 특성은 사용자가 설정할 수 있는 하나 이상의 개별 모드를 다룹니다. 일반적으로 이러한 모드는 다른 기기 동작에서 연결 해제된 기능에 사용되어야 합니다. 기기 자체 사용 설정 또는 사용 중지와 같은 연결된 동작은 더 구체적인 특성을 사용해야 합니다 (예: TemperatureSetting 특성의 thermostatMode).

기기 속성

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

속성 유형 설명
availableModes 배열

필수.

사용 가능한 모드 목록입니다.

[item, ...] 객체

사용 가능한 모드입니다.

name String

필수.

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

name_values 배열

필수.

지원되는 각 언어에서 해당 모드의 동의어입니다.

[item, ...] 객체

지정된 언어로 된 모드의 동의어입니다.

name_synonym 배열

필수.

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

[item, ...] String

동의어 이름입니다.

lang String

필수.

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

settings 배열

필수.

이 모드에서 지원되는 설정

[item, ...] 객체

지원되는 설정.

항목이 2개 이상 필요합니다.

setting_name String

필수.

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

setting_values 배열

필수.

지원되는 각 언어로 설정의 동의어입니다.

[item, ...] 객체

특정 언어로 된 설정의 동의어입니다.

setting_synonym 배열

필수.

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

[item, ...] String

동의어 이름입니다.

lang String

필수.

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

ordered Boolean

(기본값: false)

true로 설정하면 증가/감소 로직의 추가 문법이 설정 배열의 순서 (증가)로 적용됩니다.

commandOnlyModes Boolean

(기본값: false)

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

queryOnlyModes Boolean

(기본값: false)

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

다양한 모드와 설정을 갖춘 기기

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "load",
            "size",
            "load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "small",
                "half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "medium",
                "normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "large",
                "full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "temperature",
            "temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "hot",
                "white"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "warm",
                "color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "cold",
                "delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

명령어 전용 모드를 사용하는 기기

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "light",
            "lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "day",
                "bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "night",
                "dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "reading",
                "ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

기기 상태

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

상태 유형 설명
currentModeSettings 객체

필수.

기기의 모드 name를 키로 사용하고 현재 setting_name를 값으로 사용하는 키-값 쌍입니다.

<string> String

현재 setting_name.

기기가 어떤 모드인가요?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

기기 명령어

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

action.devices.commands.SetModes

모드 설정을 업데이트합니다.

매개변수

매개변수 유형 설명
updateModeSettings 객체

필수.

기기의 모드 name를 키로 사용하고 새 setting_name를 값으로 사용하는 키-값 쌍입니다.

<string> String

setting_name

큰 부하로 설정합니다.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

샘플 발화

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

기기 오류

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