สคีมาแบบสลับเปิด/ปิดอัจฉริยะ
action.devices.traits.Toggles
- ลักษณะนี้เป็นของอุปกรณ์ที่มีการตั้งค่าได้เฉพาะกับสถานะใดสถานะหนึ่งจาก 2 สถานะเท่านั้น
การตั้งค่าเหล่านี้อาจแสดงปุ่มจริงที่มีสถานะเปิด/ปิด หรือมีสถานะใช้งานอยู่/ไม่ใช้งาน ช่องทําเครื่องหมายใน HTML หรือองค์ประกอบที่เปิดใช้งาน/ปิดใช้ประเภทอื่นๆ โดยเฉพาะ หากการตั้งค่ามีมากกว่า 2 สถานะ หรือมีรัฐที่ไม่ได้เลือกตัวเลือกไบนารี ก็จะแสดงเป็นลักษณะเฉพาะของโหมด ซึ่งจะเทียบเท่ากับการเรียกแบบหลายรัฐ ปุ่มตัวเลือก (ทางกายภาพหรือ HTML) หรือสถานะไบนารีที่ไม่ได้เปิด/ปิดอย่างชัดเจน (เช่น "AM/FM" หรือ "hot/Cold")
ลักษณะนี้จะครอบคลุมปุ่มเปิด-ปิดแต่ละรายการที่ผู้ใช้ตั้งค่าได้ โดยทั่วไปแล้ว ปุ่มเปิด/ปิดเหล่านี้ควรใช้กับฟังก์ชันที่ไม่ได้ลิงก์กับพฤติกรรมอื่นๆ ของอุปกรณ์ พฤติกรรมที่ลิงก์ เช่น การเปิดหรือปิดอุปกรณ์เอง ควรใช้ลักษณะเฉพาะที่เฉพาะเจาะจงมากขึ้น (เช่น thermostatMode
ใน TemperatureSetting)
แอตทริบิวต์ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
โปรดดูการดําเนินการ Intent
แอตทริบิวต์ | Type | คำอธิบาย |
---|---|---|
availableToggles |
อาร์เรย์ |
ต้องระบุ รายการปุ่มสลับที่ใช้ได้ |
[item, ...] |
ออบเจ็กต์ |
ปุ่มเปิด/ปิด |
name |
สตริง |
ต้องระบุ ชื่อภายในของปุ่มสลับ ซึ่งจะใช้ในคําสั่งและสถานะ ปัญหานี้อาจไม่เป็นมิตรกับผู้ใช้ และจะแชร์กับทุกภาษา |
name_values |
อาร์เรย์ |
ต้องระบุ คําพ้องความหมายของการสลับสําหรับแต่ละภาษาที่สนับสนุน |
[item, ...] |
ออบเจ็กต์ |
คําพ้องความหมายของปุ่มสลับในภาษาหนึ่งๆ |
name_synonym |
อาร์เรย์ |
ต้องระบุ คําพ้องความหมายของปุ่มเปิด/ปิด สตริงแรกในรายการนี้จะใช้เป็นชื่อตามรูปแบบบัญญัติของระดับในภาษานั้น |
[item, ...] |
สตริง |
ชื่อคําพ้องความหมาย |
lang |
สตริง |
ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ |
commandOnlyToggles |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อความตั้งใจหรือสถานะรายงานสําหรับลักษณะเฉพาะนี้ได้ |
queryOnlyToggles |
บูลีน |
(ค่าเริ่มต้น: ต้องระบุหากอุปกรณ์รองรับการดําเนินการสําหรับคําค้นหาเท่านั้น แอตทริบิวต์นี้ระบุว่าอุปกรณ์ค้นหาได้เฉพาะข้อมูลสถานะเท่านั้น และจะควบคุมไม่ได้ |
ตัวอย่าง
อุปกรณ์ที่มีสวิตช์หลายตัว
{ "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 }
อุปกรณ์ STATES
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
โปรดดูการดําเนินการ Intent
รัฐ | Type | คำอธิบาย |
---|---|---|
currentToggleSettings |
ออบเจ็กต์ |
ต้องระบุ คู่คีย์/ค่าที่มีปุ่มสลับ |
<string> |
บูลีน |
สถานะปุ่มสลับปัจจุบัน |
ตัวอย่าง
การฆ่าเชื้อเปิดอยู่ไหม
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
อุปกรณ์ COMMANDS
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
โปรดดูการดําเนินการ Intent
action.devices.commands.SetToggles
ตั้งค่าสถานะการสลับที่ระบุ
พารามิเตอร์
พารามิเตอร์ | Type | คำอธิบาย |
---|---|---|
updateToggleSettings |
ออบเจ็กต์ |
ต้องระบุ คู่คีย์/ค่าที่มีปุ่มสลับ |
<string> |
บูลีน |
สถานะปุ่มสลับใหม่ |
ตัวอย่าง
เปิดการประหยัดพลังงาน
{ "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 på frysen