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

SDK thiết bị

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

Tiện ích Google Home cho mã VS

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ủa bạn 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 Mã VS.

Tương tự như Trình mô phỏng hiện có trong Bảng điều khiển Actions, Assistant Simulator cho phép bạn dễ dàng điều khiển thiết bị bằng cách nhập truy vấn, ví dụ: "Bật đèn". Bên trong Mã VS, Assistant Simulator sẽ phản hồi bằng các tin nhắn văn bản dựa trên lệnh của bạn, ví dụ: "OK, bật đèn". Hãy xem bài viết Sử dụng Trình mô phỏng Trợ lý Google để biết thêm thông tin chi tiết.

Pin theo lô

Để kiểm thử khả năng tích hợp Google Home như một máy tự động, bạn có thể gửi các câu nói hàng loạt đến Trình mô phỏng Trợ lý Google bằng cách chạy một tập lệnh phát âm. Vui lòng xem phần Chạy Batch Utterances để biết thêm thông tin chi tiết.

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

Công cụ ghi nhật ký Matter có thể thu thập mọi nhật ký liên quan đến việc gỡ lỗi theo chuẩn Matter, bao gồm cả 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 Mã VS bằng các lượt tìm kiếm bằng bộ lọc và 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, chẳng hạn như Android và Phiên bản ứng dụng, rồi gửi cho Google để báo cáo các 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 nắm được thông tin chi tiết 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 Ghi nhật ký đám mây 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 ghi nhật ký trên đám mây để biết thêm thông tin chi tiết.

Trình xem Home Graph

Home Graph Viewer 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 Mã VS. Hãy xem phần Xem Home Graph và Chạy kiểm thử để biết thêm chi tiết.

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

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

  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.

    Thị trường tiện ích Google Home

Bạn cũng có thể tải Google Home Extension xuống trực tiếp từ Thị trường mã VS.

Tải xuống Google Home Extension

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

Sau khi cài đặt Google Home Extension và tải lại Mã VS, 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 tính năng Ghi nhật ký trên đám mây.

Đă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 và cho phép mã VS thay mặt bạn giao tiếp với các dịch vụ của Google.

  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 để mở chế độ xem đăng nhập trong trình duyệt của bạn.

    Mã so với mã Đăng nhập bằng Google
  3. Chọn tài khoản 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ở mã Visual Studio) sẽ xuất hiện. Nhấp vào Open Visual Studio Code (Mở mã Visual Studio) để tiếp tục.

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

    Cho phép tiện ích Google Home mở URI
  7. Sau khi đă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 Select a project (Chọn 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 dự á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 bộ công cụ SoC của thiết bị Matter

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

  1. Hầu hết hệ thống SoC của 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ý trực tiếp từ thiết bị.
  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). Hãy 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 mã VS

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 về quá trình phát triển của mình thông qua 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 Mã VS, hãy nhấp vào Trình mô phỏng HỖ TRỢ GOOGLE trên Thanh bên. Trong hộp Message (Thông báo), hãy nhập truy vấn của bạn rồi nhấn Enter.

Bạn có thể xem các câu trả lời của Assistant Simulator và nhấp vào nút sau truy vấn để Gửi lại câu trả lời đó.

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

Chạy hàng loạt pin

Di chuột đến thanh trình đơn TÊN NGƯỜI DÙNG HỖ TRỢ CỦA GOOGLE rồi chọn trong số 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 nói hiện có.

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

    Biểu tượng trình đơn về lô lựa chọn

Để bắt đầu gửi cách nói hàng loạt, hãy chọn trong số các tuỳ chọn sau:

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

    Biểu tượng chạy hàng loạt dữ liệu

Xem ghi nhật ký trên đám mây

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

Sử dụng tính năng ghi nhật ký trên đám mây

Người dùng có thể lọc nhật ký dựa trên mức độ nghiêm trọng và phạm vi 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 người dùng muốn xem thêm nhật ký, hãy di chuyển xuống dưới cùng rồi nhấp vào Thêm để xem thêm nhật ký.

Xem thêm nhật ký

Xem Biểu đồ nhà và chạy kiểm thử

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

Trình xem Home Graph

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

Bộ kiểm tra Google Home

Bạn có thể kiểm tra thông tin chi tiết về hoạt động kiểm thử và xem nhật ký sau khi toàn bộ quá trình kiểm thử hoàn tất.

Kết quả kiểm tra

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

Ghi nhật ký Android

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

Ghi nhật ký Android

Sau khi điện thoại Android được kết nối, bạn có thể xem từng dòng nhật ký. Xin lưu ý rằng nhật ký được lọc bỏ có nghĩa là chỉ các nhật ký liên quan đến GHA mô-đun Google Play services Matter mới đượ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ý.

Đã lọc nhật ký Android

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

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

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

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

Chọn thiết bị ghi nhật ký thiết bị theo chuẩn Matter

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

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

Tải toàn bộ nhật ký Matter xuống

Trong phần TRUY CẬP NHANH, hãy nhấp vào Download log (Tải nhật ký xuống) để mở hộp thoại Download Logs (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 cần tải nhật ký xuống rồi nhấp vào Lưu:

Lưu nhật ký vấn đề

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, bạn sẽ thấy thông tin thiết bị và tệp nhật ký.

Tệp ZIP của nhật ký Matter

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

Gỡ lỗi nhật ký vấn đề

Gửi phản hồi

Để gửi ý kiến hoặc ý kiến 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 bằng Google Home Extension, hãy chọn trong các tuỳ chọn sau:

  • Trong bảng TRỢ GIÚP VÀ PHẢN HỒI, hãy nhấp vào Gửi phản hồi để gửi nội dung đề xuất cho chúng tôi.
  • Trong bảng 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 đề 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 biểu tượng phản hồi trên trang Tài nguyên.