Giản đồ đặc điểm cảnh trong nhà thông minh

action.devices.traits.Scene – Đặc điểm này dùng để triển khai các thiết bị ảo cùng với loại thiết bị SCENE.

Hãy xem Hướng dẫn về loại cảnh để biết thêm thông tin.

Ví dụ: nếu một thiết bị cho phép người dùng định cấu hình tính năng nhóm các lệnh bằng một lần chạm – đặt đèn thành các màu cụ thể, hoặc sắp xếp các tính năng bảo mật khác nhau hoặc bất kỳ tổ hợp hoạt động nào khác – thì cấu hình này có thể được hiển thị thông qua SYNC dưới dạng một cảnh được đặt tên và Trợ lý sẽ cung cấp các cảnh này cho người dùng thông qua cú pháp kích hoạt đơn giản:

  • Bắt đầu Chế độ tiệc.
  • Kích hoạt cảnh nửa đêm.

Là đối tượng ảo, cảnh có thể được đặt trong phòng (nếu có liên quan) để phân biệt:

  • Bắt đầu bữa tiệc trong bếp.
  • Bật chế độ ánh sáng ban đêm trong phòng ngủ.

Một điểm khác biệt giữa cảnh và mục tiêu thực tế là Trợ lý sẽ tự động áp dụng hiệu ứng số nhiều cho các lệnh Cảnh, cho phép người dùng kích hoạt cảnh trên nhiều đối tác. Ví dụ: nếu người dùng có cảnh "chế độ tiệc" trên hai đối tác khác nhau, một đối tác cho mục đích bảo mật và một đối tác cho mục đích chiếu sáng, thì thao tác Kích hoạt chế độ tiệc sẽ kích hoạt cả hai.

Cảnh sẽ tương tác hiệu quả với các Hành động cá nhân sắp tới theo ngữ pháp tuỳ chỉnh (ví dụ: Kích hoạt Chế độ nhóm -> Hãy bắt đầu bữa tiệc thôi!).

Cảnh phải luôn có tên do người dùng cung cấp thay vì tên mặc định "Cảnh BobCo". Mỗi cảnh là một thiết bị ảo riêng, có (các) tên riêng. Tên do người dùng cung cấp có thể bắt nguồn từ SYNC.

ATTRIBUTE 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 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.

Thuộc tính Loại Mô tả
sceneReversible Boolean

(Mặc định: false)

Cho biết bạn có thể huỷ cảnh này. Thuộc tính này chỉ liên quan đến các cảnh sửa đổi trạng thái và ghi nhớ trạng thái trước đó. Thiết bị hỗ trợ lệnh ActivateScene với tham số deactivate thành true.

Ví dụ

Thiết bị hỗ trợ cảnh có thể đảo ngược.

{
  "sceneReversible": true
}

Trạng thái thiết bị

Không có.

LỆNH 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.ActivateScene

Kích hoạt hoặc huỷ kích hoạt một cảnh.

Thông số

Thông số Loại Mô tả
deactivate Boolean

Bắt buộc.

True để huỷ một cảnh nếu cảnh đó có thể đảo ngược, false để kích hoạt một cảnh.

Ví dụ

Kích hoạt cảnh theo tên.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Huỷ kích hoạt cảnh theo tên.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.