Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, một điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục tạo các hành động trong Bảng điều khiển Actions.

Sân chơi trên Google Home

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

SDK của thiết bị

Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.

Hoàn tất việc liên kết tài khoản

Để sử dụng Home Playground, bạn nên liên kết công cụ với tài khoản của mình trước tiên. Mở Google Home app (GHA) on your phone, and go through the account linking process:

  1. Nhấp vào biểu tượng dấu cộng (+) ở góc trên cùng bên trái.
  2. Chọn Thiết lập thiết bị > Hoạt động với Google.
  3. Tìm Hành động có tiêu đề Google Home Playground.
  4. Chọn Hành động và GHA sẽ đưa bạn đến trang đăng nhập. Nhấp vào Sign in with Google (Đăng nhập bằng Tài khoản) rồi chọn tài khoản của bạn để đăng nhập.
  5. Nhấp vào nút Uỷ quyền để uỷ quyền liên kết tài khoản.
Hình này thể hiện quy trình 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 việc 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.

Hình này cho thấy danh sách thiết bị mặc định được điền sẵ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

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

Phát hành Playground

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 việc liên kết tài khoản.

Hình này cho thấy trạng thái ban đầu của Google Home Playground, đồng thời 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, Home Playground sẽ hiển thị các thiết bị ảo được lưu trữ trong Home Graph.

Hình này cho thấy danh sách thiết bị, thông tin thiết bị và khu vực nhật ký ở 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 và tạo thiết bị ảo thông 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à xoá 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 Home PlaygroundHome Graph. Bạn có thể mở rộng nhật ký để kiểm tra tải trọng của yêu cầu và phản hồi để 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.
  • Đặ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 dành riêng cho đặ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 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 một 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 điều khiển 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 đ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ợ cho thiết bị.
  3. Sau khi cập nhật xong các đặc điểm được hỗ trợ, hãy nhấp vào Lưu và những đặc điểm đã cập nhật sẽ được áp dụng cho Home Graph.
  4. Bạn có thể xem các thông tin cập nhật về đặc điểm này trong phần Nhật ký.
Hình này cho thấy công cụ trải nghiệm người dùng dùng để 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 thuộc tính thiết bị

  1. Chọn thẻ Thông tin cơ bản/Thuộc tính và chỉnh sửa thuộc tính này cho các đặc điểm mà thiết bị hỗ trợ.
  2. Sau khi bạn hoàn tất chỉnh sửa, hãy nhấn phím Enter và các thay đổi đối với thuộc tính sẽ áp dụng cho Home Graph.
  3. Bạn có thể xem các thuộc tính đã cập nhật này trong phần Nhật ký.

Sửa đổi trạng thái thiết bị

  1. Chọn thẻ Trạng thái và chỉnh sửa trực tiếp trạng thái. Các thay đổi về trạng thái sẽ áp dụng cho Home Graph.
  2. 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 của mỗi thiết bị đó.

Định 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 định cấu hình.
  2. Trong bảng Thông tin thiết bị, hãy chọn thẻ SUV và định cấu hình các mục sau:
    • Bật: Cho biết có bật hoặc tắt SUV (không thử thách) trên thiết bị hay không.
    • Loại thử thách: liệu SUV có yêu cầu xác nhận rõ ràng (thiếu cần) hay 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ó hỏi lại người dùng hay không và nếu không thì lỗi sẽ phản hồi.
Hình này cho thấy công cụ trải nghiệm người dùng cho phép xác định các đặc điểm phụ của người dùng trên một thiết bị đã chọn trong Google Home Playground.

Xác định các thiết bị hỗ trợ SUV

Trong bảng Danh sách thiết bị, một biểu tượng khoá khoá sẽ hiển thị bên cạnh mỗi thiết bị có hỗ trợ SUV.

Hình này cho thấy những thiết bị được đề xuất để bật
            tính năng xác minh người dùng phụ.

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

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

  1. Trong bảng 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ị 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.
  3. 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.
Hình này cho thấy công cụ trải nghiệm người dùng để 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 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 thông báo bật lên.
  3. Sau khi bạn xác nhận việc xoá thiết bị, thiết bị đó sẽ bị xoá khỏi Home Graph.
Hình này cho thấy công cụ trải nghiệm người dùng dùng để xoá một loại thiết bị ảo trong
            Google Home Playground.

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 bằng trạng thái của thiết bị sang tệp và chia sẻ với người khác tệp để nhập và sao chép thiết bị ảo.

Hình này cho thấy công cụ trải nghiệm người dùng dùng để 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 các thiết bị ảo sang tệp.
  2. Nhập tên tệp bạn muốn xuất và 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 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 mà bạn muốn nhập rồi nhấp vào OK.
  3. Sau khi bạn xác nhận tệp cần nhập, 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 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, Home Playground sẽ tự động áp dụng thay đổi của bạn cho Home Graph. Các tương tác với Home Graph sẽ được ghi lại vào bảng điều khiển Khu vực nhật ký, nơi bạn có thể mở rộng từng mục nhập để kiểm tra yêu cầu API và tải trọng phản hồi 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
}
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. Hãy xem 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 để 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 help ở 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 Home Playground hỗ trợ.

Hình này cho thấy công cụ trải nghiệm người dùng để thêm một loại thiết bị mới trong Google Home Playground.

Các vấn đề về phản hồi và báo cáo

Chúng tôi muốn được nghe ý kiến của bạn! Hãy 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 khuôn mặt cười Affinity_satisfied ở trên cùng bên phải hoặc báo cáo các 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.

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