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: 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 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, maxTimerLimitSec]. Đặt thành -1 để cho biết không có bộ tính giờ nào đang chạy.

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, 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ờ.

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 [-maxTimerLimitSec, maxTimerLimitSec].

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
  }
}

Đã 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": {}
}

Đã 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": {}
}

Đã 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": {}
}

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

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

noTimerExists

Thiết bị ERRORS

Xem danh sách đầy đủ lỗi và trường hợp ngoại lệ.