Mô hình quan trọng Cloud sang đám mây SDK Local Home 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 cung cấp cho bạn quyền truy cập vào Google Assistant Simulator, Google Cloud Logging, Trình xem biểu đồ trong Home và các công cụ khác để đơn giản hoá quá trình phát triển nhà thông minh và nhà Matt.
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 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 truy vấn, chẳng hạn như "Bật đèn". Bên trong VS Code, 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ụ: "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ử quá trình tích hợp Google Home như một máy tự động, bạn có thể gửi hàng loạt lời nói đế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 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 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 VS Code bằng bộ lọc và lượt 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 (chẳng hạn như Android và phiên bản ứng dụng), đồng thờ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 để cung cấp cho bạn thông tin chi tiết về mức sử dụng Hành động của bạn. Để đơ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ý trên đám mây của Google theo thời gian thực ngay bên cạnh mã của bạn trong khi khắc phục sự cố. Xem bài viết Xem nhật ký trên đám mây để biết thêm 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 bài viết Xem Home Graph 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 từ trong Mã VS:
- Nhấp vào biểu tượng Tiện ích trên Thanh hoạt động.
Tìm kiếm
google home
, sau đó nhấp vào Cài đặt.
Bạn cũng có thể tải Google Home Extension trực tiếp xuống 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 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 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 Mã VS 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 đang 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 sẽ xuất hiện. 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 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 Select a project (Chọn dự án).
Trong cửa sổ thả xuống Search and Select a project (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:
- 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ủa bạn.
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:
- Hầu hết SoC của thiết bị sẽ xuất các cổng nối tiếp như
/dev/ttyUSBx
trên Linux,/dev/tty.SLAB_USBtoUART
hay/dev/tty.usbserial
trên MacOS. LogViewer có thể đọc nhật ký trực tiếp 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á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 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 nơi 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 trong 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 GOOGLE HỖ TRỢ
SIMULATOR trên Thanh bên. Trong hộp Message (Thư), 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 của bạn để Gửi lại nó.
Chạy gói ứng dụng
Di chuột đến thanh trình đơn HAI 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ách 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 giọng 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ách phát âm trong cửa sổ thả xuống.
Mở trực tiếp tệp
*.utterance
rồi nhấp vào .
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ý trên đám mây) để mở trang Cloud Logs (Nhật ký trên đám mây), nơi bạn có thể tìm thấy các 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 có tối đa 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 More (Tuỳ chọn khác) để xem các nhật ký khác.
Xem biểu đồ trang chủ 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 HomeGraph Viewer (Trình xem biểu đồ trang chủ), 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 chương trình 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 với thiết bị của bạn đã chọn và sẵn sàng để thử nghiệm. Nhấp vào Bắt đầu rồi chờ kết quả thử nghiệm.
Bạn có thể kiểm tra chi tiết kiểm thử và xem nhật ký sau khi tất cả các kiểm thử hoàn tất.
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 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ể thấy từng dòng nhật ký. Lưu ý rằng nhật ký được lọc, tức là chỉ các nhật ký liên quan đến GHA và 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ý.
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:
Tiếp theo, chọn Matter Device (Thiết bị quan trọng):
Sau đó, bạn có thể lấy toàn bộ 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ọng và Tìm kiếm để tìm thông tin mà bạn quan tâm.
Tải tất cả nhật ký Matter xuống
Trong phần TRUY CẬP NHANH, hãy nhấp vào Download Logs (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ý để tải xuống rồi nhấn OK.
Chọn thư mục để tải nhật ký xuống rồi 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, thao tác này sẽ hiển thị thông tin thiết bị và 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 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, bạn có thể chọn một trong các phương án sau:
- Trong bảng TRỢ GIÚP VÀ PHẢN HỒI, hãy nhấp vào Gửi ý kiến phản hồi để gửi ý kiến đề 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 phát hiện được với Google Home Extension
- Chúng tôi cũng đã cung cấp biểu tượng phản hồi trên trang Tài nguyên.