Phần mở rộng của Google Home cho mã VS

Matter    SDK Local Home từ đám mây đến đám mây

Google Home Extension for Visual Studio Code được thiết kế và tạo cho các nhà phát triển Google Home Platform. Tiện ích này cho phép bạn truy cập vào Google Assistant Simulator, Google Cloud Logging, Trình xem Home Graph và các công cụ khác để đơn giản hoá quy trình phát triển Matter và nhà thông minh.

Tiện ích Google Home cho VS Code

Các tính năng của tiện ích Google Home

Trình mô phỏng Trợ lý Google

Để kiểm tra xem các thiết bị nhà thông minh có hoạt động đúng cách với hệ sinh thái Google Home hay không, bạn có thể tương tác với Assistant Simulator bất cứ lúc nào mà không cần rời khỏi VS Code.

Assistant Simulator cho phép bạn dễ dàng điều khiển các thiết bị bằng cách nhập truy vấn, ví dụ: "Bật đèn" Trong VS Code, Assistant Simulator sẽ phản hồi bằng tin nhắn văn bản dựa trên các lệnh của bạn, ví dụ: "Được rồi, đang bật đèn" Xem bài viết Sử dụng Trình mô phỏng Trợ lý Google để biết thêm thông tin.

Hàng loạt câu lệnh

Để kiểm tra quá trình tích hợp Google Home như một hệ thống tự động, bạn có thể gửi hàng loạt câu lệnh đến Trình mô phỏng Trợ lý Google bằng cách chạy một tập lệnh câu lệnh. Xem bài viết Chạy hàng loạt câu lệnh để biết thêm thông tin.

Công cụ ghi nhật ký Matter

Công cụ ghi nhật ký Matter có thể thu thập tất cả nhật ký liên quan đến Matter việc gỡ lỗi, bao gồm nhật ký Google Home app (GHA) và nhật ký Dịch vụ Google Play (GMS Core). Bạn có thể xem nhật ký trên VS Code bằng các bộ lọc và tìm kiếm từ khoá. Bạn có thể tải nhật ký xuống cùng với thông tin gỡ lỗi bổ sung như Android và phiên bản ứng dụng, đồng thời gửi nhật ký đó cho Google để báo cáo vấn đề.

Ghi nhật ký Matter của tiện ích Google Home

Cloud Logging

Cloud Logging cung cấp thông tin gỡ lỗi và các chỉ số chính để giúp bạn hiểu rõ hơn về mức sử dụng Hành động của mình. Để đơn giản hoá quá trình phát triển, Google Home Extension sẽ hiển thị các thông báo Cloud Logging của Google theo thời gian thực ngay bên cạnh mã của bạn trong quá trình khắc phục sự cố. Xem bài viết Xem Cloud Logging để biết thêm thông tin.

Trình xem Home Graph

Trình xem Home Graph hiện có sẵn trực tiếp trong Google Home Extension để bạn có thể xác minh trạng thái của thiết bị trong Home Graph bên trong VS Code. Xem bài viết Xem Home Graph và chạy kiểm thử để biết thêm thông tin.

Cài đặt tiện ích Google Home cho VS Code

Để cài đặt Google Home Extension, hãy làm theo các bước sau trong VS Code:

  1. Nhấp vào biểu tượng Tiện ích trên Thanh hoạt động.
  2. Tìm kiếm google home, sau đó nhấp vào Cài đặt.

    Google Home Extension Marketplace

Bạn cũng có thể tải Google Home Extension xuống trực tiếp từ VS Code Marketplace.

Tải xuống Google Home Extension

Thiết lập tiện ích Google Home cho VS Code

Sau khi cài đặt Google Home Extension và tải lại VS Code, bạn cần đăng nhập và chọn một dự án thì mới có thể sử dụng Assistant Simulator và xem Cloud Logging.

Đăng nhập bằng Google và chọn một dự án trên đám mây

Bạn có thể đăng nhập vào tài khoản nhà phát triển của mình từ Google Home Extension, cho phép VS Code giao tiếp với các dịch vụ của Google thay mặt bạn.

  1. Nhấp vào biểu tượng Google Home trên Thanh hoạt động để mở Google Home Extension.

    Biểu tượng Tiện ích Google Home
  2. Nhấp vào Đăng nhập bằng Google để khởi chạy khung hiển thị đăng nhập trong trình duyệt.

    Đăng nhập bằng Google trong VS Code
  3. Chọn tài khoản được liên kết với các thiết bị nhà thông minh của bạn.

  4. Trên trang uỷ quyền Đăng nhập bằng Google, hãy nhấp vào Cho phép.

  5. Một thẻ trình duyệt sẽ mở ra và hộp thoại Open Visual Studio Code (Mở Visual Studio Code) sẽ xuất hiện. Nhấp vào Open Visual Studio Code (Mở Visual Studio Code) để tiếp tục.

    Mở hộp thoại VS Code
  6. Bạn sẽ được chuyển hướng đến VS Code, nơi bạn cần cấp quyền để cho phép tiện ích Google Home mở một URI. Nhấp vào Mở để hoàn tất quy trình đăng nhập.

    Cho phép Tiện ích Google Home mở một URI
  7. Sau khi bạn đăng nhập, Google Home Extension sẽ tải các dự án của bạn. Sau khi hoàn tất, hãy nhấp vào Chọn một dự án.

    Chọn dự án
  8. Trong cửa sổ thả xuống Search and select a project (Tìm kiếm và chọn một dự án) xuất hiện, hãy chọn dự án nhà thông minh của bạn.

Cài đặt công cụ Cầu gỡ lỗi Android (ADB)

Để xem nhật ký Matter trên điện thoại Android, bạn cần cài đặt ADB:

  1. Cài đặt ADB trên máy tính.
  2. Bật Tuỳ chọn cho nhà phát triển và Gỡ lỗi qua USB trên điện thoại Android.

Cài đặt công cụ SoC thiết bị Matter

Cách xem nhật ký gỡ lỗi từ các thiết bị Matter:

  1. Hầu hết SoC thiết bị sẽ xuất các cổng nối tiếp như /dev/ttyUSBx trên Linux hoặc /dev/tty.SLAB_USBtoUART hoặc /dev/tty.usbserial trên MacOS. LogViewer có thể đọc nhật ký từ thiết bị trực tiếp.
  2. Một số loại SoC như NXP hoặc Silicon Labs có thể yêu cầu cài đặt các công cụ bên ngoài (ví dụ: JLink). Xem bài viết Thiết bị được hỗ trợ để biết thêm thông tin.

Sử dụng tiện ích Google Home cho VS Code

Xem tài nguyên dành cho nhà phát triển

Trong phần TRỢ GIÚP VÀ PHẢN HỒI, hãy nhấp vào Bắt đầu và tài nguyên để mở trang Tài nguyên. Tại đây, bạn có thể tìm thấy thông tin hữu ích cho quá trình phát triển của mình với hệ sinh thái Google Home.

Tài nguyên cho Hệ sinh thái Google Home

Sử dụng Trình mô phỏng Trợ lý Google

Để mở Assistant Simulator trong VS Code, hãy nhấp vào TRÌNH MÔ PHỎNG TRỢ LÝ GOOGLE trên Thanh bên. Trong hộp Message (Tin nhắn), hãy nhập truy vấn của bạn rồi nhấn Enter.

Bạn có thể xem các phản hồi Assistant Simulator và nhấp vào nút sau truy vấn để Gửi lại truy vấn đó.

Sử dụng Trình mô phỏng Trợ lý Google

Chạy hàng loạt câu lệnh

Di chuột qua thanh trình đơn TRÌNH MÔ PHỎNG TRỢ LÝ GOOGLE rồi chọn một trong các tuỳ chọn sau để thiết lập tập lệnh:

  • Nhấp vào để mở các tập lệnh câu lệnh hiện có.

  • Nhấp vào để lưu nhật ký vào một tập lệnh *.utterance

    Biểu tượng trình đơn cho câu nói theo lô

Để bắt đầu gửi hàng loạt câu lệnh, hãy chọn một trong các tuỳ chọn sau:

  • Nhấp vào để chọn một tập lệnh câu lệnh trong cửa sổ thả xuống.
  • Mở trực tiếp một tệp *.utterance rồi nhấp vào .

    Biểu tượng chạy câu lệnh hàng loạt

Xem Cloud Logging

Trong phần TRUY CẬP NHANH, hãy nhấp vào Nhật ký trên đám mây để mở trang Nhật ký trên đám mây . Tại đây, bạn có thể tìm thấy nhật ký thuộc về dự án đã chọn.

Sử dụng Cloud Logging

Người dùng có thể lọc nhật ký dựa trên mức độ nghiêm trọng và khoảng thời gian.

Lọc nhật ký theo mức độ nghiêm trọng và thời gian

Theo mặc định, nhật ký bị giới hạn ở 50 hàng. Nếu muốn xem thêm nhật ký, người dùng có thể cuộn xuống cuối trang rồi nhấp vào Thêm để xem thêm nhật ký.

Xem thêm nhật ký

Xem Home Graph và chạy kiểm thử

Trong phần TRUY CẬP NHANH , hãy nhấp vào Trình xem Home Graph để mở bảng điều khiển Trình xem Home Graph . Tại đây, bạn có thể tìm thấy các thiết bị thuộc về dự án đã chọn. Bạn cũng có thể nhấp vào Chạy kiểm thử để chạy kiểm thử cho thiết bị.

Home Graph Viewer

Thao tác này sẽ khởi chạy bộ kiểm thử trong trình duyệt của bạn với thiết bị đã chọn và sẵn sàng kiểm thử. Nhấp vào Bắt đầu rồi chờ kết quả kiểm thử.

Bộ kiểm thử Google Home

Bạn có thể xem thông tin chi tiết về kiểm thử và xem nhật ký sau khi tất cả các kiểm thử hoàn tất.

Kết quả thử nghiệm

Sử dụng tiện ích Google Home để gỡ lỗi Matter

Ghi nhật ký trong Android

Trong phần CÔNG CỤ GHI NHẬT KÝ MATTER, hãy nhấp vào Android Nhật ký để mở trang Android Nhật ký, chọn Android điện thoại mà bạn muốn kết nối và bắt đầu hiển thị nhật ký.

Ghi nhật ký trên Android

Sau khi kết nối điện thoại Android, bạn có thể xem nhật ký từng dòng. Xin lưu ý rằng nhật ký được lọc, tức là chỉ những nhật ký liên quan đến GHA Google Play services Matter mô-đun được hiển thị. Bạn cũng có thể đặt Mức độ nghiêm trọng để lọc nhật ký hoặc Tìm kiếm từ khoá trong nhật ký.

Ghi nhật ký Android đã lọc

Ghi nhật ký thiết bị Matter

Trong phần CÔNG CỤ GHI NHẬT KÝ MATTER, hãy nhấp vào Nhật ký thiết bị để mở trang Tài nguyên, chọn Loại SoC trước:

Ghi nhật ký thiết bị theo chuẩn Matter

Tiếp theo, hãy chọn Thiết bị Matter:

Ghi nhật ký thiết bị Matter chọn thiết bị

Sau đó, bạn có thể lấy tất cả nhật ký thiết bị từ thiết bị và sử dụng các bộ lọc như Mức độ nghiêm trọngTìm kiếm để tìm thông tin mà bạn quan tâm.

Ghi nhật ký được lọc cho thiết bị theo chuẩn Matter

Tải tất cả nhật ký Matter xuống

Trong phần TRUY CẬP NHANH, hãy nhấp vào Tải nhật ký xuống để mở hộp thoại Tải nhật ký xuống , chọn nhật ký cần tải xuống rồi nhấn OK.

Tải nhật ký Matter xuống

Chọn thư mục để tải nhật ký xuống rồi nhấp vào Lưu:

Lưu nhật ký Matter

Sau đó, nhật ký sẽ được lưu vào thư mục đích:

Thư mục đích của nhật ký Matter

Giải nén tệp zip đã lưu, tệp này sẽ hiển thị thông tin thiết bị và tệp nhật ký.

Tệp nhật ký Matter Zip

Tệp thông tin thiết bị sẽ bao gồm tất cả thông tin về phiên bản cần thiết để gỡ lỗi sự cố.

Gỡ lỗi nhật ký Matter

Gửi phản hồi

Để gửi ý kiến hoặc phản hồi về cách chúng tôi có thể cải thiện trải nghiệm phát triển với Google Home Extension, hãy chọn một trong các tuỳ chọn sau:

  • Trên bảng điều khiển TRỢ GIÚP VÀ PHẢN HỒI, hãy nhấp vào Gửi phản hồi để đưa ra đề xuất cho chúng tôi.
  • Trên bảng điều khiển TRỢ GIÚP VÀ PHẢN HỒI, hãy nhấp vào Báo cáo vấn đề để báo cáo mọi vấn đề mà bạn gặp phải với Google Home Extension
Biểu tượng gửi ý kiến phản hồi
  • Chúng tôi cũng cung cấp một biểu tượng phản hồi trên trang Tài nguyên.