สคีมาของตัวจับเวลาตัวจับเวลาสมาร์ทโฮม
action.devices.traits.Timer
- ลักษณะเฉพาะของตัวจับเวลาแสดงถึงตัวจับเวลาในอุปกรณ์
เช่น ตัวควบคุมหัวกระจายน้ําอัจฉริยะหรือสวิตช์ไฟอัจฉริยะอาจมีตัวจับเวลาในตัว ลักษณะนี้สามารถใช้เพื่อควบคุมตัวจับเวลาในตัวอุปกรณ์ เช่น การเริ่มตัวจับเวลาใหม่ รวมถึงการหยุดและการยกเลิกตัวจับเวลาที่เดินอยู่ รวมถึงการถามระยะเวลาที่เหลือ
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
maxTimerLimitSec |
จำนวนเต็ม |
ต้องระบุ ระบุการตั้งค่าตัวจับเวลาที่ยาวที่สุดในอุปกรณ์ โดยวัดเป็นหน่วยวินาที |
commandOnlyTimer |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้ |
ตัวอย่าง
อุปกรณ์ที่มีขีดจํากัดตัวจับเวลา 2 ชั่วโมง
{ "maxTimerLimitSec": 7200 }
สถานะอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
timerRemainingSec |
จำนวนเต็ม |
ต้องระบุ เวลาปัจจุบันที่เหลือเป็นวินาที -1 หรือ [0, |
timerPaused |
บูลีน |
เป็นจริงหากมีตัวจับเวลาที่ใช้อยู่แต่หยุดชั่วคราวอยู่ |
ตัวอย่าง
ตัวจับเวลาของอุปกรณ์เหลือเวลาอีกเท่าไร (ไม่ทํางาน)
{ "timerRemainingSec": -1 }
ตัวจับเวลาของอุปกรณ์เหลือเวลาอีกเท่าไร (กําลังทํางาน)
{ "timerRemainingSec": 60 }
ตัวจับเวลาของอุปกรณ์เหลือเวลาอีกเท่าไร (หยุดชั่วคราว)
{ "timerRemainingSec": 30, "timerPaused": true }
คําสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
ได้ที่การดําเนินการตามความตั้งใจ
action.devices.commands.TimerStart
เริ่มตัวจับเวลาใหม่
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
timerTimeSec |
จำนวนเต็ม |
ต้องระบุ ระยะเวลาของตัวจับเวลาเป็นวินาที ต้องอยู่ภายใน [1, |
ตัวอย่าง
เรียกใช้ตัวจับเวลาของอุปกรณ์เป็นเวลา 5 นาที
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดขณะเริ่มจับเวลา
ค่าที่รองรับมีดังต่อไปนี้
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
ปรับระยะเวลาของตัวจับเวลา
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
timerTimeSec |
จำนวนเต็ม |
ต้องระบุ การปรับตัวจับเวลาที่เป็นค่าบวกหรือเชิงลบเป็นวินาทีเป็นวินาที ต้องอยู่ภายใน [ |
ตัวอย่าง
เพิ่มตัวจับเวลา 1 นาทีในอุปกรณ์
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
ลบ 30 วินาทีจากตัวจับเวลาของอุปกรณ์
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดในการปรับตัวจับเวลา
ค่าที่รองรับมีดังต่อไปนี้
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
หยุดจับเวลาชั่วคราว
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ไม่มีพร็อพเพอร์ตี้ |
ตัวอย่าง
หยุดตัวจับเวลาของอุปกรณ์ชั่วคราว
{ "command": "action.devices.commands.TimerPause", "params": {} }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดขณะหยุดจับเวลาชั่วคราว
ค่าที่รองรับมีดังต่อไปนี้
noTimerExists
action.devices.commands.TimerResume
จับเวลาต่อ
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ไม่มีพร็อพเพอร์ตี้ |
ตัวอย่าง
จับเวลาอุปกรณ์ต่อ
{ "command": "action.devices.commands.TimerResume", "params": {} }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดขณะจับเวลาต่อ
ค่าที่รองรับมีดังต่อไปนี้
noTimerExists
action.devices.commands.TimerCancel
ยกเลิกตัวจับเวลา
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ไม่มีพร็อพเพอร์ตี้ |
ตัวอย่าง
หยุดตัวจับเวลาของอุปกรณ์
{ "command": "action.devices.commands.TimerCancel", "params": {} }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดขณะที่หยุดตัวจับเวลา
ค่าที่รองรับมีดังต่อไปนี้
noTimerExists