Ý định nhà thông minh là các đối tượng nhắn tin đơn giản mô tả những gì cần thực hiện trong quá trình tích hợp Cloud-to-cloud, chẳng hạn như bật đèn hoặc truyền âm thanh đến loa.
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 gửi một ý định đến phương thức thực hiện, mã truy cập OAuth 2 của bên thứ ba của người dùng
sẽ được truyền trong tiêu đề Uỷ quyền.
Sau đây là các ý định được hỗ trợ:smart home
SYNC
Ý định action.devices.SYNC được dùng để yêu cầu danh sách các
smart home thiết bị mà người dùng đã kết nối và có
thể sử dụng.
Khi người dùng thiết lập thiết bị bằng Google Home app (GHA), họ cũng
được xác thực với cơ sở hạ tầng đám mây của bạn. Sau đó,
Assistant nhận được mã thông báo OAuth2. Tại thời điểm này,
Assistant sẽ gửi ý định action.devices.SYNC đến phương thức thực hiện của bạn để truy xuất danh sách ban đầu về các thiết bị và chức năng của người dùng từ
cơ sở hạ tầng đám mây của bạn.
Để 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 của bạn để đồng bộ hoá danh sách thiết bị và chức năng. Hãy xem
Triển khai 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 cục bộ, nền tảng Nhà thông minh cục bộ sẽ kiểm tra phản hồi SYNC từ phương thức thực hiện đá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 nhằm hỗ trợ phương thức thực hiện cục bộ, hãy xem
bài viết Cập nhật phản hồi ĐỒNG BỘ HOÁ trong phương thức thực hiện đám mây.
QUERY
Ý định action.devices.QUERY được dùng để truy vấn trạng thái hiện tại
của smart home thiết bị.
Khi người dùng truy vấn trạng thái thiết bị để trả lời một câu hỏi như
Ok Google, những đèn nào đang bật trong bếp?,
Assistant gửi ý định action.devices.QUERY đến phương thức thực hiện của bạn.
Để mang lại trải nghiệm tốt nhất cho người dùng, bạn nên triển khai tính năng Báo cáo trạng thái để chủ động báo cáo trạng thái hiện tại của thiết bị của người dùng trực tiếp cho Google Home Graph. Ví dụ: tính năng này cho phép Assistant biết liệu người dùng của bạn có bật đèn thông minh bằng công tắc đèn vật lý hay không.
EXECUTE
Ý đị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 của bạn
sẽ nhận được ý định action.devices.EXECUTE mô tả hành động và thiết bị cần thực hiện. Người dùng có thể thực thi một hành động trên thiết bị bằng một 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 đã huỷ liên kết tài khoản ứng dụng vớ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.