Cloud-to-cloud Local Home SDK Device SDK
Google Home Playground là một ứng dụng web cho phép bạn mô phỏng một dự án nhà thông minh bằng cách mô phỏng một ngôi nhà ảo với các loại thiết bị và đặc điểm có thể định cấu hình. Google Home Playground cho phép bạn tạo các thiết bị ảo, sửa đổi các thuộc tính và trạng thái thiết bị, xem các thiết bị này trong Google Home Graph và nhập hoặc xuất các cấu hình thiết bị.
Hoàn tất 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ó tên 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 Ủy quyền để ủy quyền liên kết tài khoản.

Sau khi bạn hoàn tất việc liên kết tài khoản, một nhóm các thiết bị ảo mặc định sẽ xuất hiện 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 bạn đã sử dụng trong GHA để hoàn tất việc 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 điều khiển:
- Danh sách thiết bị hiển thị tất cả các 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 và tạo thiết bị ảo qua bảng điều khiển này.
- Thông tin thiết bị trình bày 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à xóa thiết bị ảo đã chọn thông qua bảng điều khiển.
- Nhật ký khu vực hiển thị nhật ký tương tác giữa Google Home Playground và Home Graph. Bạn có thể mở rộng nhật ký để kiểm tra 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 thiết bị ảo
Trong bảng 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ị.
- Đặc điểm: các đặc điểm được hỗ trợ của thiết bị.
- Thuộc tính: các thuộc tính liên quan đến đặc điểm thiết bị.
- Trạng thái: tất cả các trạng thái thiết bị.
- SUV: Cấu hình Xác minh người dùng phụ của thiết bị.
Chỉnh sửa thông tin thiết bị ảo
Ngoài việc xem thông tin của thiết bị ảo, bạn cũng có thể trực tiếp chỉnh sửa thông tin của thiết bị được lưu trữ trong Home Graph thông qua bảng Thông tin thiết bị.
Sửa đổi các đặc điểm được hỗ trợ
- Chọn tab Đặ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ể xem các đặc điểm hiện được hỗ trợ của thiết bị và các đặc điểm 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á các đặc điểm được hỗ trợ của thiết bị. - Khi bạn cập nhật xong các đặc điểm được hỗ trợ, hãy nhấp vào Lưu và các đặc điểm đã cập nhật sẽ được áp dụng cho Home Graph.
- Bạn có thể xem các thông tin cập nhật về đặc điểm này trong phần Vùng nhật ký.

Sửa đổi thuộc tính thiết bị
- Chọn thẻ Basic Information/Attributes (Thông tin cơ bản/Thuộc tính) và chỉnh sửa thuộc tính cho các đặc điểm mà thiết bị hỗ trợ.
- Sau khi bạn chỉnh sửa xong, hãy nhấn phím Enter để thay đổi thuộc tính sẽ được áp dụng cho Home Graph.
- Bạn có thể xem các thuộc tính đã cập nhật này trong Vùng nhật ký.
Sửa đổi trạng thái thiết bị
- Chọn thẻ States (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 các nội dung sửa đổi trạng thái này trong phần Nhật ký.
Thêm phương thức xác minh người dùng phụ vào thiết bị ảo
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 mỗi thiết bị.
Định cấu hình SUV trên thiết bị
- Trong bảng 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 Thông tin thiết bị, hãy chọn thẻ SUV và định cấu hình mục sau:
- Enabled: Cho dù SUV được bật hay tắt (không có thử thách) trên thiết bị.
- Loại xác thực: liệu SUV có cần xác nhận rõ ràng hay không (ackacked) hoặc 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 sai, liệu có cần hỏi lại người dùng hay không và nếu không thì họ sẽ phản hồi như thế nào.

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

Danh sách các đặc điểm sau đây yêu cầu SUV:
Tạo thiết bị ảo mới
- Trong bảng Danh sách thiết bị, hãy nhấp vào 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ị rồi nhập tên thiết bị cho thiết bị mới. Ngoài ra, bạn có thể chọn một tập hợp 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.

Xóa 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 information (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 xóa thiết bị trong thông báo bật lên.
- Sau khi bạn xác nhận xoá thiết bị, thiết bị đó sẽ bị xoá khỏi Home Graph.

Nhập và xuất thiết bị ảo
Để khắc phục sự cố hoặc tái tạo các vấn đề, bạn có thể xuất các thiết bị ảo có 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 của bạn.

Xuất các thiết bị ảo sang một tệp
- Nhấp vào để xuất các thiết bị ảo sang một tệp.
- Nhập tên tệp bạn muốn xuất và nhấp OK.
- Sau khi bạn nhập tên tệp, trình duyệt sẽ tải tệp chứa thiết bị ảo đã xuất xuống.
Nhập thiết bị ảo từ một tệp
- Nhấp vào để nhập thiết bị ảo từ một tệp.
- Chọn tệp bạn muốn nhập và nhấp vào OK.
- Sau khi bạn xác nhận tệp để 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 hoạt động tương tác với Home Graph được ghi lại vào bảng điều khiển Khu vực nhật ký. Tại đây, bạn có thể mở rộng từng mục nhập để kiểm tra yêu cầu API Home Graph và tải trọng phản hồi.
Mỗi mục nhập nhật ký là một mảng JSON, chứa các phần tử của cấu trúc sau:
{
"uri": string,
"request": object,
"response": object
}
Các trường | Loại | 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. Xem tài liệu tham khảo để biết định dạng cho từng phương thức. |
response |
object |
Nội dung phản hồi của lệnh gọi API Home Graph. Xem tài liệu tham khảo để biết định dạng cho từng phương thức. |
Xem các đặc điểm và loại thiết bị đượ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ị loại thiết bị hiện tại và danh sách đặc điểm được Google Home Playground hỗ trợ.

Phản hồi và báo cáo sự cố
Chúng tôi muốn nghe ý kiến của bạn! Gửi ý kiến phản hồi cho chúng tôi bằng cách nhấp vào biểu tượng mặt cười heart_satisfaction ở trên cùng bên phải hoặc báo cáo các 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.
