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