Giản đồ đặc điểm của tính năng hẹn giờ trong nhà thông minh

action.devices.traits.Timer – Thuộc tính Timer (Hẹn giờ) đại diện cho một bộ hẹn giờ trên thiết bị.

Ví dụ: bộ điều khiển vòi phun thông minh hoặc công tắc đèn thông minh có thể tích hợp sẵn bộ hẹn giờ. Tính năng này có thể được dùng để điều khiển một bộ tính giờ tích hợp trên thiết bị, chẳng hạn như bắt đầu một bộ tính giờ mới cũng như tạm dừng và huỷ một bộ tính giờ đang chạy, cũng như hỏi xem còn bao nhiêu thời gian nữa.

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau trong thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Ví dụ

Thiết bị có giới hạn bộ hẹn giờ 2 giờ.

{
  "maxTimerLimitSec": 7200
}

Trạng thái thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem bài viết Thực hiện ý định.

Ví dụ

Còn bao lâu nữa thì xong trên đồng hồ hẹn giờ cho thiết bị? (không chạy).

{
  "timerRemainingSec": -1
}

Còn bao nhiêu thời gian trên đồng hồ hẹn giờ của thiết bị? (đang chạy).

{
  "timerRemainingSec": 60
}

Còn bao lâu nữa thì xong trên đồng hồ hẹn giờ cho thiết bị? (đang tạm dừng).

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

lệnh của thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem bài viết Thực hiện ý định.

action.devices.commands.TimerStart

Bắt đầu một bộ hẹn giờ mới.

Thông số

Ví dụ

Chạy bộ hẹn giờ của thiết bị trong 5 phút.

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

Lỗi có liên quan

Đã xảy ra lỗi khi khởi động bộ hẹn giờ.

Các giá trị được hỗ trợ:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Điều chỉnh thời lượng của đồng hồ hẹn giờ.

Thông số

Ví dụ

Thêm một phút vào đồng hồ hẹn giờ của thiết bị.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

Trừ 30 giây khỏi bộ hẹn giờ của thiết bị.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

Lỗi có liên quan

Đã xảy ra lỗi khi điều chỉnh bộ hẹn giờ.

Các giá trị được hỗ trợ:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerPause

Tạm dừng đồng hồ hẹn giờ.

Thông số

Ví dụ

Tạm dừng đồng hồ hẹn giờ của thiết bị.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

Lỗi liên quan

Đã xảy ra lỗi khi tạm dừng đồng hồ.

Các giá trị được hỗ trợ:

noTimerExists

action.devices.commands.TimerResume

Tiếp tục đồng hồ hẹn giờ.

Thông số

Ví dụ

Tiếp tục chạy đồng hồ hẹn giờ của thiết bị.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

Lỗi liên quan

Đã xảy ra lỗi khi tiếp tục chạy bộ hẹn giờ.

Các giá trị được hỗ trợ:

noTimerExists

action.devices.commands.TimerCancel

Huỷ đồng hồ hẹn giờ.

Thông số

Ví dụ

Dừng đồng hồ hẹn giờ của thiết bị.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

Lỗi liên quan

Đã xảy ra lỗi khi dừng đồng hồ.

Các giá trị được hỗ trợ:

noTimerExists

Thiết bị ERRORS