Lưu ý! Chương trình dùng thử dành cho nhà phát triển mới sắp ra mắt. Hãy đăng ký tại đây và trở thành một trong những người đầu tiên dùng thử các công cụ mới cũng như đưa ra ý kiến phản hồi.

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

Matter    Cloud-to-cloud    Local Home SDK    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 Google Home Platform. Tiện ích này cung cấp cho bạn quyền truy cập vào Google Assistant Simulator, Google Cloud Logging, Trình xem biểu đồ gia đình và các công cụ khác để đơn giản hóa quy trình phát triển nhà thông minh của bạn.

Tiện ích Google Home cho mã VS

Tính năng mở rộng của 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 kỳ lúc nào mà không cần rời khỏi VS Code.

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

Số lượng hàng loạt

Để kiểm thử quy trình tích hợp Google Home như một công cụ tự động hoá, 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. Hãy xem bài viết Chạy loạt dữ liệu hàng loạt để biết thêm thông tin chi tiết.

Công cụ ghi nhật ký vấn đề

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

Ghi nhật ký vấn đề về Tiện ích trên Google Home

Cloud Logging

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

Trình xem biểu đồ trang chủ

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 Đồ thị trên trang chủ 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 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 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 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 trước khi 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 rồi 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, ủy quyền cho Mã VS 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 Sign in with Google (Đăng nhập bằng Google) để mở chế độ xem đăng nhập trong trình duyệt của bạn.

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

  4. Trên trang ủy 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 Mở mã Visual Studio để tiếp tục.

    Mở hộp thoại VS Code
  6. Bạn sẽ được chuyển hướng đến Mã VS. Tại đây, bạn cần có quyền của bạn để cho phép Google Home Extension mở một URI. Nhấp vào Open (Mở) để hoàn tất quy trình đăng nhập.

    Cho phép Tiện ích trên 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 một dự án).

    Chọn dự án
  8. Trong cửa sổ thả xuống Tìm kiếm và chọn 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 của thiết bị Matter

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

  1. Hầu hết các thiết bị SoC 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 phần Thiết bị được hỗ trợ để biết thêm thông tin.

Sử dụng tiện ích của Google Home cho mã VS

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

Trong mục 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 bằng 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 GOOGLE ASSISTANT SIMULATOR trên Side Bar. Trong hộp Message (Thông báo), hãy nhập truy vấn và nhấn Enter.

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

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

Chạy dữ liệu hàng loạt

Di chuột qua thanh trình đơn GOOGLE ASSISTANT SIMULATOR và 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 phát âm hiện có.

  • Nhấp vào để lưu lịch sử vào tập lệnh *.utterance.

    Biểu tượng trình đơn phương thức giảm giá theo nhóm

Để bắt đầu gửi hàng loạt cách phát âm, hãy chọn từ các tùy chọn sau đây:

  • Nhấp vào để chọn tập lệnh phát âm từ 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 lỗi hàng loạt

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

Trong phần QUICK ACCESS (Truy cập nhật ký dữ liệu), hãy nhấp vào Cloud Log (Nhật ký trên đám mây) để mở trang Cloud Log (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 mình đã chọn.

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à 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ý được giới hạn trong 50 hàng. Nếu người dùng muốn xem thêm nhật ký, hãy cuộn xuống dưới cùng rồi nhấp vào More (Thêm) để xem thêm nhật ký.

Xem nhật ký khác

Xem Biểu đồ Trang chủ và Chạy Kiểm tra

Trong phần ACCESSICK ACCESS (Truy cập biểu đồ gia đình), hãy nhấp vào Home Graph Viewer để mở bảng Home Graph Viewer. Tại đây, 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 Chạy thử nghiệm để chạy thử nghiệm cho thiết bị.

Trình xem biểu đồ trang chủ

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

Bộ thử nghiệm Google Home

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

Kết quả kiểm tra

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

Ghi nhật ký Android

Trong phần MATTER LOGGING TOOLS (Công cụ ĐĂNG NHẬP)AndroidAndroidAndroid

Ghi nhật ký Android

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

Đã lọc ghi nhật ký Android

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

Trong MATTER LOGGING TOOL (Công cụ ĐĂNG NHẬP)

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

Tiếp theo, chọn Matter Device (Thiết bị màn hình):

Chọn thiết bị quan trọng với tính năng ghi nhật ký 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ư Tính nghiêm trọngTìm kiếm để tìm thông tin mà mình quan tâm.

Ghi nhật ký đã lọc trên thiết bị Matter

Tải tất cả Nhật ký vấn đề xuống

Trong mục QUICK ACCESS (Truy cập nhật ký), hãy nhấp vào Download Log (Tải nhật ký) để mở hộp thoại Download Log (Tải nhật ký xuống), chọn nhật ký sẽ tải xuống rồi nhấn OK.

Tải nhật ký về vấn đề xuống

Chọn thư mục để tải xuống nhật ký và 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, tệp này sẽ hiển thị thông tin thiết bị và tệp nhật ký.

Tệp zip nhật ký vấn đề

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 phản hồi của bạn 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 trong số các tuỳ chọn sau:

  • Trên bảng TRỢ GIÚP VÀ PHẢN HỒI, hãy nhấp vào Đưa ra ý kiến phản hồi để cho chúng tôi biết các đề xuất.
  • Trên 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 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.