스마트 홈 모드 특성 스키마
action.devices.traits.Modes - 이 트레잇은 기기에 사용 가능한 모든 모드와 모드별 설정에 적용됩니다.
이 트레잇은 임의의 수의 'n-way'를 가진 기기에 속합니다. 사용할 수 있는 각 모드의 모드 및 설정은 임의적이며 각 기기 또는 기기 유형에 따라 다릅니다. 각 모드에는 여러 가지 가능한 설정이 있지만 한 번에 하나만 선택할 수 있습니다. 건조기는 '섬세'하고 'normal' '무거운 작업' 동시에 사용할 수 있습니다. 사용자가 켜기 또는 끄기가 가능하다는 것이 Toggles 특성에 속합니다.
예를 들어 세탁기에서 세탁량 및 온도를 설정할 수 있습니다. 이 둘은 서로 독립적이기 때문에 모드일 수 있지만 한 번에 한 가지 상태만 있을 수 있습니다. 사용자는 다음과 같은 모드를 설정할 수 있습니다. 세탁기 온도를 다음과 같이 설정 있습니다
일부 교통수단이 '정렬됨' 또한 위/아래로도 조정할 수 있습니다. 설명 증가/감소 예를 들어 로드 크기 (작음, 보통, 큼)와 온도는 명확한 순서로 정렬되어 있습니다 (온도는 실제값은 아니며 숫자 타겟이 있는 온도 조절기), 부하 유형이 있을 수 있습니다. (섬세한 제품, 일반 제품, 양모 제품 등)는 아닐 수 있습니다.
이 트레잇은 사용자가 설정할 수 있는 하나 이상의 개별 모드를 다룹니다. 일반적으로
이러한 모드는 다른 기기와 연결되지 않은 기능에 사용해야 함
있습니다. 기기 자체 켜기 또는 끄기와 같은 연결된 동작은
더 구체적인 트레잇을 사용합니다 (예: thermostatMode
트레잇 TemperatureSetting).
기기 속성
이 특성이 있는 기기는 다음을 보고할 수 있습니다.
속성을 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 |
(기본값: true로 설정하면 설정 배열의 순서 (증가)에 따라 증가/감소 로직에 대한 추가 문법이 적용됩니다. |
commandOnlyModes |
Boolean |
(기본값: 기기가 단방향 (true) 통신 사용을 지원하는지 또는 양방향 (false) 통신 사용을 지원하는지 여부를 나타냅니다. 기기가 이 트레잇에 관한 QUERY 인텐트 또는 상태 보고에 응답할 수 없는 경우 이 속성을 true로 설정합니다. |
queryOnlyModes |
Boolean |
(기본값: 기기가 쿼리 전용 실행을 지원하는 경우 필요합니다. 이 속성은 기기가 상태 정보에 대해서만 쿼리할 수 있고 제어할 수 없는지를 나타냅니다. |
예
다중 모드 및 설정이 있는 기기
{
"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 |
객체 |
필수사항. 기기의 모드 |
<string> |
String |
현재 |
예
기기가 어떤 모드로 설정되어 있나요?
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
기기 명령어
이 특성을 가진 기기는 다음에 응답할 수 있습니다.
EXECUTE 작업의 일부로 사용할 수 있습니다. 배우기 위해
EXECUTE 인텐트 처리에 관한 자세한 내용은
인텐트 처리.
action.devices.commands.SetModes
업데이트 모드 설정
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
updateModeSettings |
객체 |
필수사항. 기기의 모드 |
<string> |
String |
새 |
예
대용량 부하로 설정합니다.
{
"command": "action.devices.commands.SetModes",
"params": {
"updateModeSettings": {
"load_mode": "large_load"
}
}
}
샘플 발화
<ph type="x-smartling-placeholder">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