Ý định cho nhà thông minh là các đối tượng nhắn tin đơn giản mô tả smart home Action to perform such as turn on a light or cast audio to a speaker.
Tất cả ý định smart home đều nằm trong
không gian tên action.devices và bạn phải cung cấp phương thức thực hiện cho các ý định đó. Bất cứ khi nào
Google Assistant sends an intent to fulfillment, a user's
third-party OAuth 2 access token is passed in the Authorization header.
Dưới đây là những ý định smart home được hỗ trợ:
ĐỒNG BỘ HÓA
Ý định action.devices.SYNC được dùng để yêu cầu danh sách các thiết bị smart home mà người dùng đã kết nối và có sẵn để sử dụng.
Khi người dùng thiết lập thiết bị của họ bằng Google Home app (GHA), they also
get authenticated to your cloud infrastructure. Then,
Assistant receives an OAuth2 token. At this point,
Assistant sends a action.devices.SYNC intent to your
fulfillment to retrieve the initial list of user devices and capabilities from
your cloud infrastructure.
Để tránh việc huỷ liên kết và liên kết lại tài khoản của người dùng, bạn có thể gửi yêu cầu đồng bộ hoá đến Assistant. Thao tác này sẽ gửi ý định action.devices.SYNC đến phương thức thực hiện để đồng bộ hóa danh sách thiết bị và chức năng. Xem phần Triển khai tính năng yêu cầu đồng bộ hoá để biết thêm thông tin.
Trong quá trình thiết lập phương thức thực hiện đơn hàng tại địa phương, nền tảng Trang chủ địa phương sẽ kiểm tra phản hồi SYNC từ quá trình thực hiện qua đám mây của Hành động smart home. Để tìm hiểu thêm về cách
sửa đổi phản hồi SYNC để hỗ trợ quá trình thực hiện cục bộ, hãy xem
Cập nhật phản hồi SYNC trong quá trình thực hiện đám mây.
QUERY Hỏi
Ý định action.devices.QUERY dùng để truy vấn trạng thái hiện tại của các thiết bị smart home.
Khi người dùng đang truy vấn trạng thái thiết bị, để trả lời một câu hỏi như Ok Google, đèn trong nhà bếp đang bật là gì?,
Assistant gửi ý định action.devices.QUERY để thực hiện đơn hàng.
Để có trải nghiệm người dùng tốt nhất, bạn nên triển khai Trạng thái báo cáo để chủ động báo cáo trạng thái hiện tại của các thiết bị của người dùng cho Google Home Graph. For example, this lets Assistant know if your user turned on a smart light with a physical light switch.
QUẢN LÝ
Ý định action.devices.EXECUTE được dùng để cung cấp các lệnh để thực thi trên thiết bị smart home.
Khi người dùng gửi lệnh đến thiết bị bằng Assistant, phương thức thực hiện đơn hàng của bạn sẽ nhận được ý định action.devices.EXECUTE để thực hiện hành động và mô tả hành động đó cũng như các thiết bị để thực hiện hành động. Người dùng có thể thực hiện thao tác trên thiết bị bằng lệnh như Ok Google, bật đèn phòng khách của tôi.
NGẮT KẾT NỐI
Ý định action.devices.DISCONNECT được kích hoạt để thông báo cho bạn khi người dùng đã hủy liên kết tài khoản ứng dụng khỏi Assistant.
Sau khi nhận được ý định action.devices.DISCONNECT, bạn không nên báo cáo trạng thái cho thiết bị của người dùng này.