Ý định của nhà thông minh là các đối tượng nhắn tin đơn giản, mô tả Hành động smart home cần thực hiện, 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 thực hiện các ý định đó. Bất cứ khi nào Google Assistant gửi một ý định để thực hiện nhiệm vụ, mã truy cập OAuth 2 của bên thứ ba của người dùng sẽ được chuyển vào tiêu đề Uỷ quyền.
Sau đây là các ý định smart home được hỗ trợ:
ĐỒNG BỘ HÓA
Ý định action.devices.SYNC
được dùng để yêu cầu danh sách thiết bị smart home 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ị của họ bằng Google Home app (GHA), họ cũng được xác thực để truy cập vào cơ sở hạ tầng đám mây của bạn. Sau đó, Assistant sẽ 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
để thực hiện nhiệm vụ nhằm truy xuất danh sách thiết bị và chức năng ban đầu 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. Xem phần Triển khai đồng bộ hoá yêu cầu để 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 Local Home sẽ kiểm tra phản hồi SYNC
từ phương thức thực hiện trê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 SYNC trong phương thức thực hiện trên đám mây.
QUERY Hỏi
Ý định action.devices.QUERY
được 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 truy vấn trạng thái thiết bị, để trả lời câu hỏi như Ok Google, đèn nào trong bếp đang bật?,
Assistant gửi ý định action.devices.QUERY
để thực hiện hành động.
Để mang lại trải nghiệm tốt nhất cho người dùng, 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 trên 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 Assistant biết liệu người dùng có bật đèn thông minh bằng công tắc đèn vật lý hay không.
THỰC THI
Ý định action.devices.EXECUTE
được dùng để cung cấp các lệnh sẽ thực thi trên các thiết bị smart home.
Khi người dùng gửi lệnh đến các thiết bị bằng Assistant, phương thức thực hiện của bạn sẽ nhận được một ý định action.devices.EXECUTE
mô tả hành động và các thiết bị cần thực hiện hành động. Người dùng có thể thực hiện một thao tác 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 để cho bạn biết thời điểm người dùng huỷ 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.