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