Giản đồ đặc điểm hẹn giờ cho nhà thông minh
action.devices.traits.Timer
– Đặc điểm bộ hẹn giờ đại diện cho bộ tính giờ trên một 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ộ tính giờ tích hợp sẵn. Trait này có thể được dùng để điều khiển bộ tính giờ tích hợp sẵn trên thiết bị, chẳng hạn như bắt đầu bộ tính giờ mới cũng như tạm dừng và huỷ bộ tính giờ đang chạy, cũng như hỏi thời gian còn lại.
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 quá trình SYNC
. Để tìm hiểu thêm về cách xử lý ý định SYNC
, vui lòng xem phần Thực hiện ý định.
Thuộc tính | Loại | Nội dung mô tả |
---|---|---|
maxTimerLimitSec |
Số nguyên |
Bắt buộc. Cho biết chế độ cài đặt thời gian hẹn giờ dài nhất có trên thiết bị, tính bằng giây. |
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 cho trait này. |
Ví dụ
Thiết bị có thể hẹn giờ trong 2 giờ.
{ "maxTimerLimitSec": 7200 }
TRẠNG THÁI của 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 trong thao tác QUERY
. Để tìm hiểu thêm về cách xử lý ý định QUERY
, vui lòng xem phần Thực hiện ý định.
Tiểu bang | Loại | Nội dung 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 bộ hẹn giờ đang hoạt động tồn tại nhưng hiện bị tạm dừng. |
Ví dụ
Còn bao nhiêu thời gian trên thiết bị hẹn giờ? (không chạy).
{ "timerRemainingSec": -1 }
Còn bao nhiêu thời gian trên thiết bị hẹn giờ? (đang chạy).
{ "timerRemainingSec": 60 }
Còn bao nhiêu thời gian trên thiết bị hẹn giờ? (đang tạm dừng).
{ "timerRemainingSec": 30, "timerPaused": true }
Lệnh trên thiết bị
Các thiết bị có trait này có thể phản hồi các lệnh sau đây trong quá trình thao tác EXECUTE
. Để tìm hiểu thêm về cách xử lý ý định EXECUTE
, vui lòng 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ố
Thông số | Loại | Nội dung 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 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ờ.
Thông số
Thông số | Loại | Nội dung mô tả |
---|---|---|
timerTimeSec |
Số nguyên |
Bắt buộc. Mức điều chỉnh tích cực hoặc âm của bộ tính giờ tính bằng giây; phải nằm trong khoảng [ |
Ví dụ
Thêm 1 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 từ bộ tính giờ trên 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 đồ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ờ.
Thông số
Thông số | Loại | Nội dung 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 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ờ.
Thông số
Thông số | Loại | Nội dung mô tả |
---|---|---|
Không có thuộc tính nào |
Ví dụ
Tiếp tục hẹn giờ cho thiết bị.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Lỗi liên quan
Đã xảy ra lỗi khi tiếp tục đồ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ố
Thông số | Loại | Nội dung 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 liên quan
Đã xảy ra lỗi khi dừng đồng hồ hẹn giờ.
Các giá trị được hỗ trợ:
noTimerExists