Giản đồ đặc điểm cảnh trong nhà thông minh
action.devices.traits.Scene
– Đặc điểm này được 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.
- Kích hoạ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 tốt với các Hành động cá nhân sắp ra mắt cho ngữ pháp tuỳ chỉnh (ví dụ: Kích hoạt Chế độ tiệc -> Hãy bắt đầu tiệc tùng!).
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ể đến từ SYNC
.
Thuộc tính 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 thực hiện 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: 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 |
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 của 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. Đúng để huỷ một cảnh nếu cảnh đó có thể đảo ngược, sai để 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 } }