สคีมาของ Smart Home RunCycle
action.devices.traits.RunCycle
- ลักษณะเฉพาะนี้หมายถึงอุปกรณ์ที่มีระยะเวลาดําเนินการอยู่ซึ่งค้นหาได้
อุปกรณ์เช่นนี้จะรายงานจํานวนรอบทั้งหมดเมื่อเริ่มต้นการทํางาน และแต่ละรอบที่อุปกรณ์ทํางานอยู่ขณะทํางาน ซึ่งจะช่วยให้ผู้ใช้สร้างคําค้นหาได้ เช่น
- เครื่องอบผ้าของฉันมีรอบไหน
- เครื่องล้างจานเหลือกี่รอบ
- เครื่องอบผ้าทําหน้าที่อะไร
- จะล้างรถเมื่อใด
อุปกรณ์บางอย่างจะมีระยะเวลาในรูปแบบที่ไม่ใช่รอบ อุปกรณ์ที่ทํางานในระยะเวลาที่เฉพาะสามารถรายงานเวลาที่เหลือได้โดยไม่มีรอบ นอกจากนี้ ยังจัดการกรณีที่วงจรอาจไม่ตรงกัน (เช่น เครื่องล้างจานอาจใช้วงจรไม่ครบทั้งหมด) เช่น ผู้ใช้อาจถามว่าเครื่องดูดฝุ่นของฉันทํางานนานแค่ไหน ซึ่งจะแสดงระยะเวลาในหน่วยหน่วยกับเวลาที่เหลือ นอกจากนี้ยังมีผลกับอุปกรณ์ที่ระบุไว้ด้านบนด้วย เสื้อผ้าของฉันจะแห้งนานขึ้นเท่าไรจะแสดงระยะเวลาเป็นนาที
อุปกรณ์ต่างๆ สามารถส่งคืนสิ่งที่คุณรู้ และการตอบสนองของ Assistant TTS จะสร้างคําตอบที่ดีที่สุดด้วยข้อมูลที่มีอยู่ (เช่น เครื่องล้างจานกําลังทํางานและจะเสร็จในประมาณ 20 นาที)
ปัจจุบัน RunCycle เป็นแบบอ่านอย่างเดียว ยังไม่มีคําสั่ง มีเฉพาะสถานะที่จะค้นหา ในอนาคตอาจมีกลไกสําหรับการเรียกใช้รอบใหม่หรือการข้ามวงจร (เหมาะสําหรับเครื่องรดน้ําต้นไม้ ที่ไม่ดีสําหรับเครื่องซักผ้า)
แอตทริบิวต์อุปกรณ์
ไม่มี
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentRunCycle |
อาร์เรย์ |
ต้องระบุ มีคําพ้องความหมายสําหรับรอบปัจจุบันในภาษาที่รองรับแต่ละภาษา |
[item, ...] |
วัตถุ |
ชื่อคําพ้องความหมาย |
currentCycle |
สตริง |
ต้องระบุ รอบปัจจุบันแสดงอยู่ |
nextCycle |
สตริง |
ไม่บังคับ วงจรถัดไป |
lang |
สตริง |
ต้องระบุ รหัสภาษาสําหรับชื่อวงจรที่ระบุ ดูภาษาที่รองรับ |
currentTotalRemainingTime |
จำนวนเต็ม |
ต้องระบุ เวลาที่เหลือในการดําเนินการ หน่วยเป็นวินาที |
currentCycleRemainingTime |
จำนวนเต็ม |
ต้องระบุ เวลาที่เหลือในรอบปัจจุบัน หน่วยเป็นวินาที |
ตัวอย่าง
อุปกรณ์จะถูกล้างน้ําอีก 5 นาที และจะดําเนินการใน 20 นาที
{ "currentRunCycle": [ { "currentCycle": "rinse", "lang": "en" } ], "currentTotalRemainingTime": 1200, "currentCycleRemainingTime": 300 }
อุปกรณ์จะถูกล้างน้ําออกอีก 5 นาทีก่อนนําไปหมุน
{ "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 }
คําสั่งของอุปกรณ์
ไม่มี
การแจ้งเตือนของอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจแสดงเพย์โหลดการแจ้งเตือนต่อไปนี้เป็นส่วนหนึ่งของการเปลี่ยนแปลงสถานะอุปกรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานการแจ้งเตือนได้ที่การแจ้งเตือนสําหรับการดําเนินการในบ้านอัจฉริยะ
ช่อง | ประเภท | คำอธิบาย |
---|---|---|
RunCycle |
ต้องระบุ เพย์โหลดการแจ้งเตือน |
|
รองรับการใช้งานอย่างใดอย่างหนึ่งต่อไปนี้ | ||
0
|
วัตถุ |
สำเร็จ |
priority |
จำนวนเต็ม |
ต้องระบุ แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งชี้ว่าควรพูดการแจ้งเตือนดังกล่าว |
status |
สตริง |
ต้องระบุ ผลการดําเนินการ ค่าที่รองรับมีดังต่อไปนี้
|
currentCycleRemainingTime |
จำนวนเต็ม |
ต้องระบุ เวลาที่เหลือในรอบปัจจุบัน หน่วยเป็นวินาที |
1
|
วัตถุ |
ล้มเหลว |
priority |
จำนวนเต็ม |
ต้องระบุ แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งชี้ว่าควรพูดการแจ้งเตือนดังกล่าว |
status |
สตริง |
ต้องระบุ ผลการดําเนินการ ค่าที่รองรับมีดังต่อไปนี้
|
errorCode |
สตริง |
ต้องระบุ ค่านี้อาจเป็นรหัสข้อผิดพลาดสําหรับลักษณะนี้ เช่น |
ตัวอย่าง
อุปกรณ์ทํางานเสร็จแล้ว
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
เกิดข้อผิดพลาดเกี่ยวกับรอบปัจจุบัน
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }