Matter Đám mây với đám mây SDK Nhà cục bộ SDK thiết bị
Google Home Extension for Visual Studio Code được thiết kế và tạo ra 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 biểu đồ nhà và các công cụ khác để đơn giản hoá quá trình phát triển Matter và nhà thông minh.
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 VS Code.
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 VS Code, Assistant Simulator 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, 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.
Loạt câu lệnh
Để kiểm thử tính năng 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 tập lệnh câu lệnh. Hãy xem phần Chạy các câu lệnh hàng loạt để 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 tất cả nhật ký liên quan đến việc gỡ lỗi Matter, bao gồm cả các nhật ký Google Home app (GHA) và nhật ký Dịch vụ Google Play (GMS Core). Bạn có thể xem các 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 các 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 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ề cách sử dụng Hành động. Để đơn giản hoá quá trình phát triển, Google Home Extension 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ố. Hãy xem bài viết Xem tính năng Ghi nhật ký trên đám mây để biết thêm chi tiết.
Trình xem biểu đồ Home
Trình xem biểu đồ nhà hiện có sẵn ngay trong Google Home Extension để bạn có thể xác minh trạng thái của thiết bị trong biểu đồ nhà trong VS Code. Hãy xem phần Xem biểu đồ 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 VS Code
Để cài đặt Google Home Extension, hãy làm theo các bước sau trong VS Code:
- Nhấp vào biểu tượng Phần mở rộng trên Thanh hoạt động.
Tìm
google home, rồi 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 Google Home Extension xuống
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 sẽ 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, uỷ quyền cho 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 Đă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ở Visual Studio Code) sẽ xuất hiện. Nhấp vào Open Visual Studio Code (Mở Visual Studio Code) để tiếp tục.
Bạn sẽ được chuyển hướng đến VS Code. Tại đây, 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.
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 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:
- Cài đặt ADB trên máy tính.
- Bật Tuỳ chọn cho nhà phát triển và tính năng Gỡ lỗi qua USB trên điện thoại Android.
Cài đặt Công cụ SoC cho thiết bị Matter
Cách xem nhật ký gỡ lỗi từ thiết bị Matter:
- Hầu hết SoC thiết bị sẽ xuất cổng nối tiếp như
/dev/ttyUSBxtrên Linux hoặc/dev/tty.SLAB_USBtoUARThoặc/dev/tty.usbserialtrên MacOS. LogViewer có thể trực tiếp đọc nhật ký từ 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 VS Code
Xem Tài nguyên dành cho nhà phát triển
Trong mục 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 bằng 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 ASSISTANT SIMULATOR (Trình mô phỏng Trợ lý Google) trên Side Bar (Thanh bên). Trong hộp Tin nhắn, hãy nhập cụm từ tìm kiếm rồi nhấn Enter.
Bạn có thể xem các câu trả lời Assistant Simulator và nhấp vào nút sau truy vấn để Gửi lại.
Chạy Loạt câu lệnh
Di chuột qua thanh trình đơn GOOGLE ASSISTANT SIMULATOR (Trình mô phỏng Trợ lý 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 lệnh 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ác câu lệnh hàng loạt, 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 phát âm trong cửa sổ thả xuống.
Mở trực tiếp tệp
*.utterancerồi nhấp vào .
Xem Cloud Logging
Trong mục 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ý được giới hạn ở 50 hàng. Nếu người dùng muốn xem thêm nhật ký, hãy cuộn xuống cuối 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 Viewer (Trình xem biểu đồ trang chủ) để mở bảng điều khiển Home Graph 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 kiểm thử) để chạy kiểm thử cho thiết bị.
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ạ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.
Sử dụng tiện ích Google Home để gỡ lỗi Matter
Ghi nhật ký Android
Trong phần CÔNG CỤ GỒNG HỒ SƠ 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 kết nối điện thoại Android, bạn sẽ thấy các nhật ký theo dòng. Xin 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 hiển thị. Bạn cũng có thể đặt Severity (Mức độ nghiêm trọng) để lọc nhật ký hoặc Search (Tìm kiếm) từ khoá trong nhật ký.
Ghi nhật ký thiết bị Matter
Trong phần MATTER LOGGING TOOLS (CÔNG CỤ LƯU LOG MATTER), hãy nhấp vào Device Logs (Nhật ký thiết bị) để mở trang Resources (Tài nguyên), trước tiên hãy chọn SoC Type (Loại SoC):
Tiếp theo, hãy chọn Thiết bị Matter:
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ư Severity (Mức độ nghiêm trọng) và Search (Tìm kiếm) để tìm thông tin mà bạn quan tâm.
Tải tất cả Nhật ký về vấn đề xuống
Trong mục QUICK ACCESS (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ý cần 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, tệp 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 các vấn đề.
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 bằng Google Home Extension, hãy chọn một trong các lựa 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 ý kiến 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 đề bạn gặp phải 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.