Đám mây với đám mây SDK cục bộ trên Home SDK thiết bị
Google Home Playground là một ứng dụng web mô phỏng một dự án nhà với các loại thiết bị và đặc điểm có thể định cấu hình. Bạn có thể tạo tài khoản ảo thiết bị, sửa đổi 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 và nhập/xuất cấu hình thiết bị.
Hoàn tất việc 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 với vào tài khoản của mình. Mở Google Home app (GHA) trên điện thoại rồi tiếp tục thông qua 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 Đă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 để cho phép liên kết tài khoản.
Sau khi bạn 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ẽ 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 cùng một tài khoản mà bạn được 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 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 để xem thông tin về thiết bị đó và tạo thiết bị ảo qua bảng điều khiển này.
- Thông tin thiết bị cho biết thông tin về thiết bị ảo được 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.
- Khu vực nhật ký 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 cho 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 về thiết bị đượ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.
- Đặc điểm:các đặc điểm được hỗ trợ của thiết bị.
- Attributes (Thuộc tính): các thuộc tính theo tính trạng cụ thể 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 người dùng phụ của thiết bị.
Chỉnh sửa thông tin thiết bị ảo
Bên cạnh 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 lưu trữ trong Home Graph thông qua phần Thông tin thiết bị bảng điều khiển.
Sửa đổi các đặc điểm đượ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 đặ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 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), rồi trait đã cập nhật sẽ được áp dụng cho Home Graph.
- Bạn có thể xem các nội dung cập nhật về đặc điểm này trong Khu vực nhật ký.
Sửa đổi thuộc tính của thiết bị
- Chọn tab Attributes (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 chỉnh sửa xong, hãy nhấn phím Enter và các thay đổi đối với thuộc tính sẽ 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 Khu vực nhật ký.
Sửa đổi trạng thái thiết bị
- Chọn thẻ States (Trạng thái) rồi trực tiếp chỉnh sửa trạng thái. Những thay đổi về trạng thái sẽ 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 Khu vực nhật ký.
Thêm phương thức xác minh thứ hai cho người dùng vào thiết bị ảo
Bạn có thể thêm một chiếc SUV vào 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ị. Bạn có thể thêm một chiếc SUV vào các thiết bị ảo cũng như định cấu hình loại thử thách và 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 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 điều khiển Thông tin thiết bị, hãy chọn thẻ SUV rồi định cấu hình các thông tin sau:
- Bật: dù SUV đang bật hay tắt (không có thử thách) đang bật thiết bị.
- Loại thử thách: liệu xe SUV có cần xác nhận rõ ràng hay không (ackNeeded) hoặc 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 sai, liệu có nên yêu cầu người dùng một lần nữa và nếu không thì lỗi để phản hồi.
Xác định thiết bị hỗ trợ SUV
Trong bảng Device list (Danh sách thiết bị), một biểu tượng chìa khoá phím hiển thị bên cạnh từng thiết bị hỗ trợ SUV.
Dưới đây là danh sách các đặc điểm cần có đối với xe 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ị 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 tất tất cả các bước này, 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 điều khiển Thông tin thiết bị, hãy chọn thẻ Thông tin cơ bản rồi nhấp vào
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 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 được nhúng.
Chỉnh sửa hoặc sao chép và dán phản hồi của bạn khi đồng bộ hoá rồi nhấp vào Lưu để áp dụng các thay đổi để xem cách thức hoạt động của thiết bị này 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 sự cố, bạn có thể xuất các thiết bị ảo của mình với trạng thái của họ vào một tệp và chia sẻ với người khác tệp cần nhập và sao chép các thiết bị ảo của bạn.
Xuất thiết bị ảo sang một tệp
- Nhấp vào để xuất thiết bị ảo vào một 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 xuống tệp thiết bị ảo đã xuất.
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 mà 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 các thiết bị đã nhập thông tin và trạng thái của thiết bị 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 tự động áp dụng thay đổi bạn đã thực hiện cho Home Graph. Chiến lược phát hành đĩa đơn các hoạt động tương tác với Home Graph được ghi lại vào Vùng nhật ký bảng điều khiển 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ủa cấu trúc sau:
{
"uri": string,
"request": object,
"response": object
}
| 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 tài liệu tham khảo cho định dạng của mỗi 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 tài liệu tham khảo cho định dạng của mỗi phương thức. |
Xem các loại thiết bị và đặc điểm được hỗ trợ
Trợ giúp dấu hỏi biểu tượng ở góc trên cùng bên phải sẽ hiển thị loại thiết bị và danh sách trait hiện tại được Google Home Playground hỗ trợ.
Báo cáo sự cố
Chúng tôi muốn nghe ý kiến của bạn! Báo cáo sự cố gặp phải bằng cách sử dụng biểu tượng dấu chấm than ý kiến phản hồi về trên cùng bên phải.
