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