Lược đồ đặc điểm của đồng hồ hẹn giờ nhà thông minh

action.devices.traits.Timer – Đặc điểm Timer (Bộ hẹn giờ) biểu thị một bộ hẹn giờ trên thiết bị.

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

THUỘC TÍNH của 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 đây 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 hẹn giờ là 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 thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Ví dụ

Đồng hồ hẹn giờ trên thiết bị còn bao nhiêu thời gian? (không chạy).

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

Đồng hồ hẹn giờ trên thiết bị còn bao nhiêu thời gian? (đã tạm dừng).

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

LỆNH trên 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 thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.TimerStart

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

Thông số

Ví dụ

Chạy bộ hẹn giờ trên thiết bị trong 5 phút.

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

Các lỗi liên quan

Đã xảy ra lỗi khi bắt đầu 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ờ trên thiết bị.

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

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

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

Các lỗi 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ờ trên thiết bị.

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

Các lỗi liên quan

Đã xảy ra lỗi khi tạm dừng bộ hẹn giờ.

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

noTimerExists

action.devices.commands.TimerResume

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

Thông số

Ví dụ

Tiếp tục chạy bộ hẹn giờ trên thiết bị.

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

Các 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 bộ tính giờ trên thiết bị.

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

Các lỗi liên quan

Đã xảy ra lỗi khi dừng bộ hẹn giờ.

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

noTimerExists

LỖI thiết bị