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