스마트 홈이 특성 스키마를 전환함
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 |
(기본값: 기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요. |
queryOnlyToggles |
Boolean |
(기본값: 기기가 쿼리 전용 실행을 지원하는 경우 필요합니다. 이 속성은 기기를 상태 정보에 대해서만 쿼리할 수 있으며 제어할 수 없는지 여부를 나타냅니다. |
예
여러 전환 스위치가 있는 기기
{ "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 |
객체 |
필수. 기기의 전환 버튼 |
<string> |
Boolean |
현재 전환 상태입니다. |
예
살균 처리되어 있나요?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.SetToggles
지정된 전환 상태를 설정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
updateToggleSettings |
객체 |
필수. 기기의 전환 버튼 |
<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 aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duré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 opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen