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

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

Ví dụ: bộ điều khiển tưới nước thông minh hoặc đèn thông minh công tắc có thể có tích hợp sẵn bộ hẹn giờ. Trait này có thể dùng để điều khiển đồng hồ hẹn giờ tích hợp bật 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 và hỏi xem còn bao nhiêu thời gian nữa.

ATTRIBUTE của thiết bị

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

Thuộc tính Loại Mô tả
maxTimerLimitSec Số nguyên

Bắt buộc.

Cho biết thời gian hẹn giờ lâu nhất được đo bằng giây trên thiết bị.

commandOnlyTimer Boolean

(Mặc định: false)

Cho biết thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false). Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Trạng thái báo cáo đối với đặc điểm này.

Ví dụ

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

{
  "maxTimerLimitSec": 7200
}

Thiết bị STATES

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

Tiểu bang Loại Mô tả
timerRemainingSec Số nguyên

Bắt buộc.

Thời gian hiện tại còn lại tính bằng giây, -1 hoặc [0, maxTimerLimitSec]. Đặt là -1 để cho biết không có đồng hồ hẹn giờ nào đang chạy.

timerPaused Boolean

Đúng nếu một bộ tính giờ đang hoạt động tồn tại nhưng hiện đang tạm dừng.

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 lâu nữa thì xong trên đồng hồ hẹn giờ cho 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ị? (bị tạm dừng).

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

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem Thực hiện ý định.

action.devices.commands.TimerStart

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

Tham số

Tham số Loại Mô tả
timerTimeSec Số nguyên

Bắt buộc.

Thời lượng của bộ tính giờ tính bằng giây; phải nằm trong khoảng [1, maxTimerLimitSec].

Ví dụ

Chạy đồng hồ hẹn giờ cho thiết bị trong 5 phút.

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

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

Tham số

Tham số Loại Mô tả
timerTimeSec Số nguyên

Bắt buộc.

Mức điều chỉnh dương hoặc âm của đồng hồ hẹn giờ tính bằng giây; phải nằm trong khoảng [-maxTimerLimitSec, maxTimerLimitSec].

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ộ tính giờ của thiết bị.

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

Đã xảy ra lỗi khi điều chỉnh đồng hồ 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ờ.

Tham số

Tham số Loại Mô tả

Không có thuộc tính nào

Ví dụ

Tạm dừng đồng hồ hẹn giờ trên thiết bị.

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

Đã xảy ra lỗi khi tạm dừng đồng hồ 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ờ.

Tham số

Tham số Loại Mô tả

Không có thuộc tính nào

Ví dụ

Tiếp tục đồng hồ hẹn giờ trên thiết bị.

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

Đã 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ờ.

Tham số

Tham số Loại Mô tả

Không có thuộc tính nào

Ví dụ

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

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

Đã xảy ra lỗi khi dừng bộ tính giờ.

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

noTimerExists

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.