Sân chơi trên Google Home

Từ đám mây đến đám mây    Local Home SDK    Home API

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, đồng thời nhập hoặc xuất cấu hình thiết bị.

Hoàn tất quy 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 rồi thực hiện quy trình liên kết tài khoản như mô tả tại phần Kết nối thiết bị nhà thông minh của bên thứ ba trong ứng dụng Google Home.

  1. Tìm chế độ tích hợp có tên Google Home Playground.
  2. Chọn chế độ tích hợp, rồi 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.
  3. Nhấp vào nút Uỷ quyền để uỷ quyền liên kết tài khoản.
Hình này hiển thị luồng liên kết tài khoản ứng dụng Google Home để kết nối Google Home Playground.

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

Hình này hiển thị danh sách thiết bị mặc định sẽ xuất hiện khi người dùng liên kết thành công Google Home Playground với tài khoản của họ.

Đăng nhập

Khởi chạy Google Home Playground bằng cách nhấp vào nút bên dưới:

Ra mắt Sân chơi

Nhấp vào Sign in with Google (Đăng nhập bằng Tài khoản Google). Hãy đảm bảo đăng nhập bằng cùng một 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.

Hình này hiển thị trạng thái ban đầu của Google Home Playground và làm nổi bật nút đăng nhập ở góc trên bên phải.

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.

Hình này hiển thị danh sách thiết bị, thông tin thiết bị và khu vực nhật ký của chế độ xem mặc định của Google Home Playground.

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 của thiết bị đó và tạo thiết bị ảo thông qua bảng điều khiển này.
  • Thông tin thiết bị hiển thị 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.
  • 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 để khắc phục sự cố.

Thiết bị ảo

Xem thông tin về 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. 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 điều khiển Thông tin thiết bị sẽ cho thấy 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, mã nhận dạng và tên thiết bị.
  • Trait: các trait được hỗ trợ của thiết bị.
  • Attributes (Thuộc tính): các thuộc tính dành riêng cho đặc điểm của thiết bị.
  • Trạng thái: tất cả trạng thái của thiết bị.
  • SUV: Cấu hình Xác minh người dùng thứ hai 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 một thiết bị ảo, bạn cũng có thể chỉnh sửa trực tiếp thông tin đượ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ợ

  1. Chọn thẻ Đặc điểm; nhấp vào nút Chỉnh sửa.
  2. Trong bảng bật lên, bạn có thể thấy các đặc điểm hiện được thiết bị hỗ trợ và các đặc điểm có sẵn để thêm vào. Sử dụng các nút mũi tên (arrow_forward/arrow_back) để thêm hoặc xóa các đặc điểm được hỗ trợ cho thiết bị.
  3. Khi bạn hoàn tất việc cập nhật 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.
  4. Bạn có thể xem những nội dung cập nhật về đặc điểm này trong Khu vực nhật ký.
Hình này minh hoạ công cụ UX để thêm hoặc xoá các đặc điểm được hỗ trợ trên một thiết bị đã chọn trong Google Home Playground.

Sửa đổi các thuộc tính của thiết bị

  1. Chọn thẻ Thuộc tính rồi chỉnh sửa thuộc tính cho các đặc điểm mà thiết bị hỗ trợ.
  2. Sau khi bạn chỉnh sửa xong, hãy nhấn Enter và các thay đổi về thuộc tính sẽ được áp dụng cho Home Graph.
  3. 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ị

  1. Chọn tab Tiểu bang và chỉnh sửa trực tiếp tiểu bang. Các thay đổi về trạng thái sẽ được áp dụng cho Home Graph.
  2. Bạn có thể xem những thay đổ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 khi xác minh người dùng 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à 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 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 của SUV trên mỗi thiết bị.

Cấu hình SUV trên thiết bị

  1. Trong bảng Danh sách thiết bị, hãy chọn thiết bị ảo mà bạn muốn cấu hình.
  2. 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 như sau:
    • Đã bật: liệu SUV có được bật hay tắt (không có thử thách) trên thiết bị hay không.
    • Loại thử thách: liệu SUV có yêu cầu người dùng 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, có nên hỏi lại người dùng hay không và nếu không, lỗi cần phản hồi.
Hình này cho thấy công cụ UX để bật các đặc điểm xác minh người dùng thứ hai trên một thiết bị đã chọn trong Google Home Playground.

Xác định những thiết bị cho phép SUV

Trong bảng điều khiển Danh sách thiết bị, một biểu tượng khoá key sẽ xuất hiện bên cạnh mỗi thiết bị có bật SUV.

Hình này cho thấy những thiết bị nên bật quy trình xác minh người dùng thứ hai.

Danh sách các đặc điểm sau đây yêu cầu SUV:

Tạo thiết bị ảo mới

  1. Trong bảng điều khiển Danh sách thiết bị, hãy nhấp vào Thêm thiết bị.
  2. 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 thiết bị 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.
  3. Sau khi bạn hoàn tất tất cả các bước, thiết bị mới sẽ được thêm vào Home Graph.
Hình này minh hoạ công cụ UX để thêm một loại thiết bị mới trong Google Home Playground.

Xoá thiết bị ảo

  1. 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 Biểu tượng thùng rácXoá thiết bị ở dưới cùng.
  2. Xác nhận việc xoá thiết bị trong cảnh báo bật lên.
  3. Sau khi bạn xác nhận xoá thiết bị, thiết bị đó sẽ bị xoá khỏi Home Graph.
Hình này hiển thị công cụ UX để xóa loại thiết bị ảo trong Google Home Playground.

Trình chỉnh sửa phản hồi Sync

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 để mở IDE nhúng.

Hình này cho thấy nút mở trình chỉnh sửa phản hồi đồng bộ.

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

Hình này hiển thị cửa sổ để chỉnh sửa phản hồi đồng bộ.

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 vào một tệp, rồi chia sẻ tệp đó với người khác để nhập và sao chép các thiết bị ảo của bạn.

Hình này cho thấy công cụ UX để nhập và xuất các thiết bị ảo trong Google Home Playground.

Xuất thiết bị ảo sang tệp

  1. Nhấp vào để xuất thiết bị ảo vào tệp.
  2. Nhập tên tệp bạn muốn xuất rồi nhấp vào OK.
  3. 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ừ một tệp

  1. Nhấp vào để nhập thiết bị ảo từ một tệp.
  2. Chọn tệp bạn muốn nhập và nhấp vào OK.
  3. 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, đồng thời cập nhật thông tin và 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 điều khiển Khu vực nhật ký. Tại đây, bạn có thể mở rộng từng mục để kiểm tra tải trọng yêu cầu và phản hồi API Home Graph.

Mỗi mục 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
}
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. 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à đặc điểm đượ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ẽ cho biết danh sách loại thiết bị và đặc điểm hiện tại mà Google Home Playground hỗ trợ.

Hình này minh hoạ công cụ UX để thêm một loại thiết bị mới trong Google Home Playground.

Báo cáo sự cố

Chúng tôi rất mong nhận được thư trả lời của bạn! 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 ở trên cùng bên phải.

Hình ảnh này cho thấy các biểu tượng để gửi ý kiến phản hồi và báo cáo vấn đề trong Google Home Playground.