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: 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, |
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, |
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 } }
Lỗi có liên quan
Đã 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 [ |
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 } }
Lỗi có liên quan
Đã 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": {} }
Lỗi có liên quan
Đã 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": {} }
Lỗi có 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ờ.
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": {} }
Lỗi có liên quan
Đã xảy ra lỗi khi dừng bộ tính giờ.
Các giá trị được hỗ trợ:
noTimerExists