Mục đích

Ý định của nhà thông minh là các đối tượng nhắn tin đơn giản giúp 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 action.devices không gian tên và bạn phải cung cấp phương thức thực hiện cho các không gian tên đó. 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 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 smart home thiết bị mà người dùng đã kết nối và đang 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), 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 gửi ý định action.devices.SYNC đến phương thức thực hiện để 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 mình.

Hình này thể hiện sự tương tác giữa cơ sở hạ tầng của Google và cơ sở hạ tầng của đối tác. Từ cơ sở hạ tầng của Google có danh sách các đối tác có trong ứng dụng khách Trợ lý, sau đó chuyển đến cơ sở hạ tầng của đối tác để hoàn tất quy trình xác thực OAuth. OAuth xác thực ở phía đối tác là chế độ xem web do đối tác thiết lập, chế độ xem web OAuth, các chế độ cài đặt và điều khoản không bắt buộc, cũng như các dịch vụ đám mây của đối tác. Cơ sở hạ tầng của đối tác, sau đó trả về thông tin đăng nhập OAuth cho ứng dụng khách Trợ lý. Đối tác các dịch vụ đám mây sẽ gửi các thiết bị và chức năng có sẵn đến các dịch vụ của Trợ lý, sau đó lưu trữ thông tin trong Home Graph.
Hình 1: Tương tác giữa Google và Đối tác cơ sở hạ tầng

Để 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á thành Assistant. Thao tác này sẽ gửi ý định action.devices.SYNC vào 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 Triển khai tính năng đồng bộ hoá yêu cầu để tìm hiểu thêm của bạn.

Sơ đồ luồng của ý định SYNC
Hình 2: Ý định SYNC

Trong quá trình thiết lập phương thức thực hiện tại địa phương, Nền tảng Local Home 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 tại địa phương, hãy xem 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 trong tổng số smart home thiết bị.

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, trong bếp đang bật những đèn nào?, Assistant gửi ý định action.devices.QUERY đến phương thức thực hiện.

Sơ đồ luồng về ý định QUERY
Hình 3: Ý định QUERY

Để 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 thiết bị mà người dùng sử dụng Google Home Graph. Ví dụ: tính năng này cho phép Assistant biết liệu người dùng có bật đèn thông minh bằng tính năng công tắc đèn vật lý.

Báo cáo trạng thái thiết bị bằng Trạng thái báo cáo
Hình 4: Báo cáo trạng thái thiết bị

THỰC THI

Ý định action.devices.EXECUTE được dùng để cung cấp các lệnh để thực thi trên smart home thiết bị.

Khi người dùng gửi lệnh đến thiết bị có Assistant, phương thức thực hiện nhận được một ý định action.devices.EXECUTE để thực hiện đơn hàng 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 thi 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.

Sơ đồ quy trình của một ý định EXECUTE
Hình 5: Ý định THỰC THI

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 khỏi Assistant. Sau khi nhận được ý định action.devices.DISCONNECT, bạn không nên báo cáo cho thiết bị của người dùng này.

Trước
Loại thiết bị và đặc điểm
Tiếp
Quy trình thực hiện đơn hàng