Giản đồ thuộc tính hẹn giờ 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ờ. Bạn có thể dùng đặc điểm này để kiểm soát 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 thời gian còn lại.

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 đây trong quá trình thực hiện 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 thời gian 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 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 phần Thực hiện ý định.

Ví dụ

Còn bao nhiêu thời gian trên đồng hồ hẹn giờ của 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 nhiêu thời gian trên đồng hồ hẹn giờ của 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 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ờ của thiết bị trong 5 phút.

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

Lỗi 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 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 đồ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 đồng hồ 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

LỖI thiết bị