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, Trình xem Home Graph và các công cụ khác để đơn giản hoá quy trình phát triển nhà thông minh và Mattr.
Tính năng tiện ích 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ủa bạn có hoạt động đúng cách với hệ sinh thái của 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, chẳng hạn như "Bật đèn". Bên trong mã VS, Assistant Simulator sẽ phản hồi bằng tin nhắn văn bản dựa trên lệnh của bạn, chẳng hạn như "OK, 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 chi tiết.
Gói dịch vụ
Để kiểm thử quá trình tích hợp Google Home như máy tự động, bạn có thể gửi hàng loạt cách phát âm đến Trình mô phỏng Trợ lý Google bằng cách chạy một tập lệnh cách phát âm. Hãy xem phần Chạy Utterance (Chạy hàng loạt) để biết thêm chi tiết.
Dụ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 cho Matter, bao gồm cả nhật ký Google Home app (GHA) và nhật ký của Dịch vụ Google Play (GMS Core). Bạn có thể xem nhật ký trên Mã VS bằng bộ lọc và các lượt tìm kiếm theo 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 đề.
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. Để đơn giản hoá quá trình phát triển, Google Home Extension sẽ hiển thị thông báo Ghi nhật ký Google Cloud 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 phần Xem nhật ký trên đám mây để biết thêm chi tiết.
Trình xem biểu đồ trên Home
Trình xem biểu đồ Home 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 biểu đồ trên trang chủ và Chạy kiểm thử để biết thêm thông tin 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:
- Nhấp vào biểu tượng Tiện ích trên Thanh hoạt động.
Tìm
google home, sau đó nhấp vào Cài đặt.
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 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 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 từ Google Home Extension, cho phép VS Code thay mặt bạn giao tiếp với các dịch vụ của Google.
Nhấp vào biểu tượng Google Home trên Thanh hoạt động để mở Google Home Extension.
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.
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.
Trên trang uỷ quyền Đăng nhập bằng Google, hãy nhấp vào Cho phép.
Một thẻ trình duyệt sẽ mở ra và hộp thoại Open Visual Studio Code (Mở mã Visual Studio) sẽ hiển thị. Nhấp vào Open Visual Studio Code (Mở mã Visual Studio) để tiếp tục.
Bạn sẽ được chuyển hướng đến VS Code. Tại đây, 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.
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 Chọn dự án.
Trong cửa sổ thả xuống Tìm kiếm và chọn một dự án vừa 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:
- Cài đặt ADB trên máy tính.
- 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 cho thiết bị theo chuẩn Matter
Cách xem nhật ký gỡ lỗi từ các thiết bị Matter:
- Hầu hết SoC của thiết bị sẽ xuất các cổng nối tiếp như
/dev/ttyUSBxtrên Linux,/dev/tty.SLAB_USBtoUARThoặc/dev/tty.usbserialtrên MacOS. LogViewer có thể đọc trực tiếp nhật ký trên thiết bị. - Một số loại SoC như NXP hoặc Silicon Labs có thể yêu cầu cài đặt công cụ bên ngoài (ví dụ: JLink). Hãy xem phần Các 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 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 để phát triển 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 Thanh bên. Trong hộp Message (Thông báo), hãy nhập truy vấn rồi nhấn vào 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.
Chạy hoạt động theo lô
Di chuột qua thanh trình đơn GOOGLE ASSISTANT SIMULATOR (Hỗ trợ 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 phát âm hiện có.
Nhấp vào để lưu nhật ký vào tập lệnh
*.utterance.
Để bắt đầu gửi cách phát âm hàng loạt, hãy chọn trong số các tuỳ chọn sau đây:
- Nhấp vào để chọn một tập lệnh phát âm trong cửa sổ thả xuống.
Trực tiếp mở tệp
*.utterancerồi nhấp vào .
Xem nhật ký trên đám mây
Trong phần QUICK ACCESS (Quyền truy cập nhanh), hãy nhấp vào Cloud Logs (Nhật ký trên đá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 nhật ký thuộc dự án đã chọn.
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.
Theo mặc định, nhật ký chỉ có tối đa 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 Thêm để xem thêm nhật ký.
Xem biểu đồ trang chủ và chạy kiểm thử
Trong phần QUICK ACCESS (Quyền truy cập nhanh), hãy nhấp vào Home Graph Inspector (Trình xem biểu đồ Home) để mở bảng điều khiển Home Graph Inspector (Trình xem biểu đồ Home). 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 Run Test (Chạy phép kiểm thử) để chạy các lượt kiểm thử cho thiết bị.
Thao tác này sẽ khởi chạy bộ thử nghiệm trong trình duyệt khi bạn chọn thiết bị 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ạn có thể tham khảo thông tin chi tiết về hoạt động kiểm thử và xem nhật ký sau khi hoàn tất mọi lượt kiểm thử.
Sử dụng tiện ích Google Home để gỡ lỗi Matter
Ghi nhật ký Android
Trong phần CÁC CÔNG CỤ ĐĂNG NHẬP TRÊN MATTER, hãy nhấp vào Android Logs (Nhật ký Android) để mở trang Android Logs (Nhật ký Android), chọn điện thoại Android mà bạn muốn kết nối và bắt đầu hiển thị nhật ký.
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, nghĩa là chỉ các nhật ký liên quan đến GHA và mô-đun Matter Google Play services đượ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ý thiết bị theo chuẩn Matter
Trong phần MATTER LOGGING TOOLS (CÁC CÔNG CỤ ĐĂNG NHẬP TRÊN MATTER), hãy nhấp vào Device Logs (Nhật ký thiết bị) để mở trang Resources (Tài nguyên), rồi chọn SoC Type (Loại SoC): trước tiên:
Tiếp theo, chọn Matter Device (Thiết bị Matt):
Sau đó, bạn có thể lấy tất cả nhật ký thiết bị từ thiết bị đó rồi sử dụng các bộ lọc như Mức độ nghiêm trọng và Tìm kiếm để tìm thông tin bạn quan tâm.
Tải mọi 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.
Chọn thư mục để tải nhật ký xuống và nhấp vào Lưu:
Sau đó, nhật ký sẽ được lưu vào thư mục đích:
Giải nén tệp zip đã lưu, tệp này sẽ hiển thị thông tin thiết bị và các tệp nhật ký.
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ửi phản hồi
Để gửi ý kiến hoặc ý kiến 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 bằng Google Home Extension, hãy chọn một trong các tuỳ chọn sau:
- Trên bảng GIÚP VÀ PHẢN HỒI, hãy nhấp vào Gửi ý kiến phản hồi để cung cấp đề xuất cho chúng tôi.
- Trong bảng 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 phát hiện thấy liên quan đến Google Home Extension
- 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.