สคีมาลักษณะของโหมดสมาร์ทโฮม
action.devices.traits.Modes
- ลักษณะนี้จะครอบคลุมโหมดและการตั้งค่าเฉพาะโหมดที่มีให้ใช้งานทั้งหมดในอุปกรณ์
ลักษณะนี้เป็นของอุปกรณ์ที่มีโหมด "n-way" จำนวนมาก ซึ่งโหมดและการตั้งค่าสำหรับแต่ละโหมดจะแตกต่างกันไปตามอุปกรณ์หรืออุปกรณ์แต่ละประเภท แต่ละโหมดมีการตั้งค่าได้หลายอย่าง แต่จะเลือกได้ทีละ 1 รายการเท่านั้น เครื่องอบผ้าต้องไม่อยู่ในโหมด "สำเร็จรูป" "ปกติ" และ "ทำงานหนัก" พร้อมกัน การตั้งค่าที่เปิดหรือปิดได้ง่ายๆ อยู่ในลักษณะ Toggles
เช่น เครื่องซักผ้าอาจตั้งค่าขนาดและอุณหภูมิในการโหลดได้ ทั้ง 2 โหมดนี้จะเป็นโหมดหนึ่ง เนื่องจากแต่ละโหมดเป็นอิสระจากกัน แต่จะอยู่ในสถานะได้ครั้งละ 1 สถานะเท่านั้น ผู้ใช้สามารถตั้งค่าโหมดอย่างอุณหภูมิอย่างชัดเจนด้วยคำสั่งอย่างตั้งอุณหภูมิเครื่องซักผ้าเป็นเย็น
บางโหมดมีการ "เรียงลำดับ" และสามารถปรับเปลี่ยนขึ้น/ลง เพิ่ม/ลดการใช้คำได้ ตัวอย่างเช่น มีการเรียงลำดับขนาดการโหลด (เล็ก กลาง ใหญ่) และอุณหภูมิอย่างชัดเจน (โปรดทราบว่าอุณหภูมิไม่ใช่ตัวควบคุมอุณหภูมิจริงที่มีเป้าหมายเป็นตัวเลข เหมือนในอุปกรณ์อื่นๆ) แต่ประเภทการโหลดอาจไม่เป็นเช่นนั้น (เช่น รายละเอียดปลีกย่อย ปกติ ผ้าขนสัตว์ ฯลฯ)
ลักษณะนี้จะครอบคลุมโหมดแต่ละโหมดที่ผู้ใช้ตั้งค่าได้อย่างน้อย 1 โหมด โดยทั่วไป โหมดเหล่านี้ควรใช้กับฟังก์ชันการทำงานที่ไม่ได้ลิงก์กับลักษณะการทำงานอื่นๆ ของอุปกรณ์ ลักษณะการทำงานที่ลิงก์ เช่น การเปิดหรือปิดอุปกรณ์ ควรใช้ลักษณะที่เฉพาะเจาะจงมากขึ้น (เช่น thermostatMode
ในลักษณะ TemperatureSetting)
ATTRIBUTES ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่Fulfillment Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
availableModes |
อาร์เรย์ |
ต้องระบุ รายการโหมดที่ใช้ได้ |
[item, ...] |
ออบเจ็กต์ |
โหมดพร้อมใช้งาน |
name |
String |
ต้องระบุ ชื่อภายในของโหมด ซึ่งจะนําไปใช้ในคําสั่งและสถานะ ซึ่งอาจใช้งานได้ยากสำหรับผู้ใช้ และจะมีการแชร์ในทุกภาษา |
name_values |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของโหมดนี้ในภาษาที่รองรับแต่ละภาษา |
[item, ...] |
ออบเจ็กต์ |
คำพ้องความหมายของโหมดในภาษาที่ระบุ |
name_synonym |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของโหมด สตริงแรกในรายการนี้จะใช้เป็นชื่อ Canonical ของระดับในภาษานั้น |
[item, ...] |
String |
ชื่อคำพ้องความหมาย |
lang |
String |
ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ |
settings |
อาร์เรย์ |
ต้องระบุ การตั้งค่าที่รองรับสำหรับโหมดนี้ |
[item, ...] |
ออบเจ็กต์ |
การตั้งค่าที่รองรับ ต้องมีอย่างน้อย 2 รายการ |
setting_name |
String |
ต้องระบุ ชื่อภายในของการตั้งค่าโหมด ซึ่งจะนําไปใช้ในคําสั่งและสถานะ ซึ่งอาจใช้งานได้ยากสำหรับผู้ใช้ และจะมีการแชร์ในทุกภาษา |
setting_values |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของการตั้งค่าในแต่ละภาษาที่รองรับ |
[item, ...] |
ออบเจ็กต์ |
คำพ้องความหมายของการตั้งค่าในภาษาที่ระบุ |
setting_synonym |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของการตั้งค่า สตริงแรกในรายการนี้จะใช้เป็นชื่อ Canonical ของระดับในภาษานั้น |
[item, ...] |
String |
ชื่อคำพ้องความหมาย |
lang |
String |
ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ |
ordered |
บูลีน |
(ค่าเริ่มต้น: หากตั้งค่าเป็น "จริง" ระบบจะใช้ไวยากรณ์เพิ่มเติมสำหรับตรรกะการเพิ่ม/ลด ตามลำดับ (เพิ่มขึ้น) ของอาร์เรย์การตั้งค่า |
commandOnlyModes |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ |
queryOnlyModes |
บูลีน |
(ค่าเริ่มต้น: ต้องระบุหากอุปกรณ์รองรับการดำเนินการตามคำค้นหาเท่านั้น แอตทริบิวต์นี้ระบุว่าอุปกรณ์ค้นหาได้เฉพาะข้อมูลสถานะหรือไม่ และจะควบคุมไม่ได้ |
ตัวอย่าง
อุปกรณ์ที่มีโหมดและการตั้งค่าหลายรายการ
{ "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 } ] }
อุปกรณ์ที่มีโหมดแบบ Command เท่านั้น
{ "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
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY
ได้ที่Fulfillment Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentModeSettings |
ออบเจ็กต์ |
ต้องระบุ คู่คีย์/ค่ามีโหมด |
<string> |
String |
ปัจจุบัน |
ตัวอย่าง
อุปกรณ์อยู่ในโหมดใด
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
COMMANDS ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่Fulfillment Intent
action.devices.commands.SetModes
อัปเดตการตั้งค่าโหมด
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
updateModeSettings |
ออบเจ็กต์ |
ต้องระบุ คู่คีย์/ค่ามีโหมด |
<string> |
String |
|
ตัวอย่าง
ตั้งค่าเป็นโหลดขนาดใหญ่
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
ตัวอย่างการเปล่งเสียง
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