Cloud sang đám mây SDK Local Home SDK thiết bị
Google Home Playground là một ứng dụng web mô phỏng dự án nhà thông minh với các loại và đặc điểm thiết bị có thể định cấu hình. Bạn có thể tạo thiết bị ảo, sửa đổi các thuộc tính và trạng thái của thiết bị, xem các thiết bị này trong Google Home Graph cũng như nhập hoặc xuất cấu hình thiết bị.
Hoàn tất quá trình liên kết tài khoản
Để sử dụng Google Home Playground, trước tiên bạn nên liên kết công cụ này với tài khoản của mình. Mở Google Home app (GHA) trên điện thoại và thực hiện quy trình liên kết tài khoản:
- Nhấp vào biểu tượng dấu cộng (+) ở góc trên cùng bên trái.
- Chọn Thiết lập thiết bị > Hoạt động với Google.
- Tìm Hành động có tiêu đề Google Home Playground.
- Chọn Hành động và GHA sẽ chuyển bạn đến trang đăng nhập. Nhấp vào Sign in with Google (Đăng nhập bằng Google) rồi chọn tài khoản của bạn để đăng nhập.
- Nhấp vào nút Uỷ quyền để uỷ quyền liên kết tài khoản.

Sau khi hoàn tất quá trình liên kết tài khoản, một nhóm thiết bị ảo mặc định sẽ hiển thị trên GHA để bạn tương tác.

Đăng nhập
Chạy Google Home Playground bằng cách nhấp vào nút bên dưới:
Nhấp vào Sign in with Google (Đăng nhập bằng Tài khoản Google). Hãy nhớ đăng nhập bằng chính tài khoản mà bạn đã dùng trong GHA để hoàn tất quá trình liên kết tài khoản.

Sau khi bạn đăng nhập, Google Home Playground sẽ hiển thị các thiết bị ảo được lưu trữ trong Home Graph.

Giao diện người dùng web bao gồm ba bảng:
- Danh sách thiết bị cho thấy mọi thiết bị ảo của bạn. Bạn có thể chọn một thiết bị ảo nhất định để xem thông tin của thiết bị đó và tạo các thiết bị ảo thông qua bảng điều khiển này.
- Device info (Thông tin thiết bị) cho biết thông tin của thiết bị ảo đã chọn. Bạn cũng có thể chỉnh sửa thông tin này và xoá thiết bị ảo đã chọn thông qua bảng điều khiển.
- Vùng nhật ký hiển thị nhật ký tương tác từ Google Home Playground đến Home Graph. Bạn có thể mở rộng nhật ký để kiểm tra các tải trọng yêu cầu và phản hồi nhằm khắc phục sự cố.
Thiết bị ảo
Xem thông tin về thiết bị ảo
Trong bảng Device list (Danh sách thiết bị), hãy chọn thiết bị ảo mà bạn muốn xem. Trong bảng Device list (Danh sách thiết bị), hãy chọn thiết bị ảo mà bạn muốn xem. Bảng Thông tin thiết bị sẽ hiển thị thông tin được phân loại thành 5 thẻ:
- Thông tin cơ bản: các thuộc tính cấp cao nhất của thiết bị, bao gồm loại thiết bị, mã nhận dạng và tên thiết bị.
- Trait (Đặc điểm): các đặc điểm được hỗ trợ của thiết bị.
- Thuộc tính: thuộc tính riêng theo đặc điểm của thiết bị.
- Trạng thái: tất cả trạng thái thiết bị.
- SUV: Cấu hình Xác minh thứ hai khi xác minh người dùng của thiết bị.
Chỉnh sửa thông tin của thiết bị ảo
Ngoài việc xem thông tin của thiết bị ảo, bạn cũng có thể chỉnh sửa trực tiếp thông tin của thiết bị được lưu trữ trong Home Graph thông qua bảng điều khiển Device info (Thông tin thiết bị).
Sửa đổi các trait được hỗ trợ
- Chọn thẻ Đặc điểm; nhấp vào nút Chỉnh sửa.
- Trong bảng điều khiển bật lên, bạn có thể thấy các trait hiện được hỗ trợ của thiết bị cũng như các trait có sẵn để thêm. Sử dụng các nút mũi tên
(arrow_forward/arrow_back) để thêm hoặc xoá trait được hỗ trợ cho thiết bị. - Khi bạn cập nhật xong các trait được hỗ trợ, hãy nhấp vào Save (Lưu) và các trait đã cập nhật sẽ được áp dụng cho Home Graph.
- Bạn có thể xem những thông tin cập nhật về trait này trong Khu vực nhật ký.

Sửa đổi thuộc tính thiết bị
- Chọn thẻ Attributes (Thuộc tính) rồi chỉnh sửa thuộc tính cho các trait mà thiết bị hỗ trợ.
- Sau khi chỉnh sửa xong, hãy nhấn phím Enter và các thay đổi về thuộc tính sẽ được áp dụng cho Home Graph.
- Bạn có thể xem các thuộc tính mới cập nhật này trong Khu vực nhật ký.
Sửa đổi trạng thái thiết bị
- Chọn thẻ Trạng thái rồi chỉnh sửa trực tiếp trạng thái. Các thay đổi về trạng thái sẽ được áp dụng cho Home Graph.
- Bạn có thể xem những nội dung sửa đổi trạng thái này trong Khu vực nhật ký.
Thêm một phương thức xác minh thứ hai khi xác minh người dùng vào thiết bị ảo
Bạn có thể thêm xe SUV vào các thiết bị ảo và định cấu hình loại thử thách cũng như hành vi tương ứng trên từng thiết bị. Bạn có thể thêm một chiếc SUV vào các thiết bị ảo và định cấu hình loại thử thách cũng như hành vi tương ứng trên từng thiết bị.
Định cấu hình SUV trên thiết bị
- Trong bảng điều khiển Device list (Danh sách thiết bị), hãy chọn thiết bị ảo mà bạn muốn định cấu hình.
- Trong bảng Device info (Thông tin thiết bị), hãy chọn thẻ SUV rồi định cấu hình các mục sau:
- Enabled (Bật): cho biết bật hay tắt SUV (không có thử thách) trên thiết bị.
- Loại thử thách: liệu SUV có yêu cầu xác nhận rõ ràng (ackNeeded) hay mã số nhận dạng cá nhân (pinNeeded).
- Mã PIN: Mã PIN hợp lệ.
- Xử lý mã PIN không chính xác: khi mã PIN không chính xác, liệu có cần hỏi lại người dùng hay không và nếu không thì sẽ gặp lỗi khi phản hồi.

Xác định các thiết bị hỗ trợ xe SUV
Trong bảng điều khiển Device list (Danh sách thiết bị), một khoá biểu tượng khoá sẽ hiển thị bên cạnh từng thiết bị hỗ trợ SUV.

Danh sách các đặc điểm sau đây yêu cầu xe SUV:
Tạo thiết bị ảo mới
- Trong bảng Device list (Danh sách thiết bị), hãy nhấp vào Add a device (Thêm thiết bị).
- Trong bảng điều khiển bật lên, hãy chọn loại thiết bị và nhập tên cho thiết bị mới của bạn. Ngoài ra, bạn có thể chọn một nhóm thiết bị được xác định trước để thêm.
- Sau khi bạn hoàn thành tất cả các bước, thiết bị mới sẽ được thêm vào Home Graph.

Xoá thiết bị ảo
- Trong bảng Danh sách thiết bị, hãy chọn thiết bị mà bạn muốn xoá.
Sau đó, trong bảng Device info (Thông tin thiết bị), hãy chọn thẻ Basic Information (Thông tin cơ bản), sau đó, trong bảng Device info (Thông tin thiết bị), hãy chọn thẻ Basic Information (Thông tin cơ bản) rồi nhấp vào
Remove device (Xoá thiết bị) ở dưới cùng.
- Xác nhận việc xoá thiết bị trong thông báo bật lên.
- Sau khi bạn xác nhận việc xoá thiết bị, thiết bị đó sẽ bị xoá khỏi Home Graph.

Trình chỉnh sửa phản hồi đồng bộ hoá
Bạn có thể xác thực hoặc cập nhật phản hồi đồng bộ hoá trong Google Home Playground. Nhấp vào Sync Response Editor (Trình chỉnh sửa phản hồi đồng bộ hoá) để mở IDE đã nhúng.

Chỉnh sửa hoặc sao chép và dán nội dung phản hồi đồng bộ hoá rồi nhấp vào Lưu để áp dụng các thay đổi nhằm xem cách hoạt động của phản hồi đó trong hệ sinh thái Google Home.

Nhập và xuất thiết bị ảo
Để khắc phục sự cố hoặc tái tạo vấn đề, bạn có thể xuất các thiết bị ảo cùng với trạng thái của chúng sang một tệp và chia sẻ tệp đó với người khác để nhập và sao chép thiết bị ảo.

Xuất thiết bị ảo sang tệp
- Nhấp vào để xuất thiết bị ảo sang tệp.
- Nhập tên tệp bạn muốn xuất rồi nhấp vào OK.
- Sau khi bạn nhập tên tệp, trình duyệt sẽ tải tệp của các thiết bị ảo đã xuất xuống.
Nhập thiết bị ảo từ tệp
- Nhấp vào để nhập thiết bị ảo từ tệp.
- Chọn tệp bạn muốn nhập rồi nhấp vào OK.
- Sau khi bạn xác nhận tệp cần nhập, Google Home Playground sẽ nhập các thiết bị ảo có trạng thái từ tệp và cập nhật thông tin cũng như trạng thái của các thiết bị đã nhập trong Home Graph.
Kiểm tra nhật ký tương tác
Khi bạn tương tác với các thiết bị ảo, Google Home Playground sẽ tự động áp dụng thay đổi của bạn cho Home Graph. Các lượt tương tác với Home Graph được ghi lại vào bảng Log Area (Khu vực nhật ký), nơi bạn có thể mở rộng từng mục nhập để kiểm tra các tải trọng phản hồi và yêu cầu API Home Graph.
Mỗi mục nhập nhật ký là một mảng JSON chứa các phần tử có cấu trúc sau:
{
"uri": string,
"request": object,
"response": object
}
Các trường | Loại | Nội dung mô tả |
---|---|---|
uri |
string |
URL của lệnh gọi API Home Graph. |
request |
object |
Nội dung yêu cầu của lệnh gọi API Home Graph. Hãy xem tài liệu tham khảo tài liệu tham khảo để biết định dạng của từng phương thức. |
response |
object |
Nội dung phản hồi của lệnh gọi API Home Graph. Hãy xem tài liệu tham khảo tài liệu tham khảo để biết định dạng của từng phương thức. |
Xem các loại thiết bị và trait được hỗ trợ
Biểu tượng dấu chấm hỏi trợ giúp ở trên cùng bên phải sẽ hiển thị danh sách loại thiết bị và đặc điểm hiện tại được Google Home Playground hỗ trợ.

Báo cáo vấn đề
Chúng tôi muốn nghe ý kiến của bạn! Báo cáo vấn đề gặp phải bằng cách sử dụng biểu tượng dấu chấm than phản hồi ở trên cùng bên phải.
