ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาของตัวจับเวลาตัวจับเวลาสมาร์ทโฮม

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

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

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
maxTimerLimitSec จำนวนเต็ม

ต้องระบุ

ระบุการตั้งค่าตัวจับเวลาที่ยาวที่สุดในอุปกรณ์ โดยวัดเป็นหน่วยวินาที

commandOnlyTimer บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้

ตัวอย่าง

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

{
  "maxTimerLimitSec": 7200
}

สถานะอุปกรณ์

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

รัฐ ประเภท คำอธิบาย
timerRemainingSec จำนวนเต็ม

ต้องระบุ

เวลาปัจจุบันที่เหลือเป็นวินาที -1 หรือ [0, maxTimerLimitSec] ตั้งค่าเป็น -1 เพื่อระบุว่าไม่มีตัวจับเวลาทํางานอยู่

timerPaused บูลีน

เป็นจริงหากมีตัวจับเวลาที่ใช้อยู่แต่หยุดชั่วคราวอยู่

ตัวอย่าง

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

คําสั่งของอุปกรณ์

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

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

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