สคีมาฟีเจอร์เครื่องควบคุมเวลาอัจฉริยะ

action.devices.traits.Timer - ลักษณะเฉพาะของตัวจับเวลาแสดงตัวจับเวลาบนอุปกรณ์

เช่น ตัวควบคุมสปริงเกอร์อัจฉริยะหรือสวิตช์ไฟอัจฉริยะอาจมีตัวตั้งเวลาในตัว ลักษณะนี้สามารถใช้เพื่อควบคุมตัวจับเวลาในตัวของอุปกรณ์ เช่น การเริ่มต้นตัวจับเวลาใหม่ รวมถึงการหยุดและการยกเลิกตัวจับเวลาที่ทํางานอยู่ชั่วคราว และถามเวลาที่เหลือ

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC โปรดดูการดําเนินการ Intent

Attributes	ประเภท	คำอธิบาย
maxTimerLimitSec	จำนวนเต็ม	ต้องระบุ ระบุการตั้งค่าตัวจับเวลานานที่สุดที่มีอยู่ในอุปกรณ์ โดยจะวัดเป็นวินาที
commandOnlyTimer	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อความตั้งใจหรือสถานะรายงานสําหรับลักษณะเฉพาะนี้ได้

ตัวอย่าง

อุปกรณ์ที่มีตัวจับเวลา 2 ชั่วโมง

{
  "maxTimerLimitSec": 7200
}

อุปกรณ์ STATES

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY โปรดดูการดําเนินการ Intent

รัฐ	ประเภท	คำอธิบาย
timerRemainingSec	จำนวนเต็ม	ต้องระบุ เวลาปัจจุบันที่เหลืออยู่เป็นวินาที คือ -1 หรือ [0, maxTimerLimitSec] ตั้งค่าเป็น -1 เพื่อระบุว่าไม่มีตัวจับเวลาใดๆ ทํางานอยู่
timerPaused	บูลีน	เป็นจริงหากมีตัวจับเวลาที่ใช้อยู่แต่หยุดไว้ชั่วคราวในขณะนี้

ตัวอย่าง

ตัวจับเวลาของอุปกรณ์เหลืออีกกี่นาที (ไม่ทํางาน)

{
  "timerRemainingSec": -1
}

ตัวจับเวลาของอุปกรณ์เหลืออีกกี่นาที (กําลังทํางาน)

{
  "timerRemainingSec": 60
}

ตัวจับเวลาของอุปกรณ์เหลืออีกกี่นาที (หยุดชั่วคราว)

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE โปรดดูการดําเนินการ Intent

action.devices.commands.TimerStart

เริ่มตัวจับเวลาใหม่

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
timerTimeSec	จำนวนเต็ม	ต้องระบุ ระยะเวลาของตัวจับเวลาเป็นวินาที จะต้องอยู่ภายใน [1, maxTimerLimitSec]

ตัวอย่าง

จับเวลาอุปกรณ์ 5 นาที

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

ข้อผิดพลาดที่เกี่ยวข้อง

เกิดข้อผิดพลาดขณะเริ่มจับเวลา

ค่าที่รองรับ

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

ปรับระยะเวลาของตัวจับเวลา

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
timerTimeSec	จำนวนเต็ม	ต้องระบุ การจับเวลาเชิงบวกหรือเชิงลบของตัวจับเวลาในหน่วยวินาที ต้องอยู่ในระยะ [-maxTimerLimitSec, maxTimerLimitSec]

ตัวอย่าง

เพิ่มตัวจับเวลา 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

อุปกรณ์ ERRORS

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด