Matter Cloud-to-cloud Local Home SDK
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 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á Matter và quy trình phát triển 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 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 giúp bạn dễ dàng điều khiển thiết bị bằng cách nhập câu lệnh, ví dụ: "Bật đèn". Trong VS Code, 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, ví dụ: "Được rồi, tôi sẽ 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.
Câu nói theo lô
Để kiểm thử chế độ tích hợp Google Home như một máy tự động, bạn có thể gửi hàng loạt câu nói đến Trình mô phỏng Trợ lý Google bằng cách chạy một tập lệnh câu nói. Hãy xem phần Chạy câu nói theo lô để 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 Matter gỡ lỗi, 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 cách tìm kiếm theo 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 như Android và Phiên bản ứng dụng, rồi gửi cho Google để báo cáo 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 nắm được thông tin chi tiết 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 điệp nhật ký 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 phần Xem Cloud Logging để biết thêm thông tin chi tiết.
Trình xem Home Graph
Trình xem Home Graph 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 Home Graph bên trong VS Code. Hãy xem phần 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 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 Extensions (Tiện ích) trên Activity Bar (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 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 cần đăng nhập và chọn một dự án thì mới có thể sử dụng Assistant Simulator và xem Cloud Logging.
Đă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, nơi 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 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 Chọn một dự án.
Trong cửa sổ thả xuống Tìm và chọn một 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 Tùy 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ị 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/ttyUSBxtrên Linux hoặc/dev/tty.SLAB_USBtoUARThoặc/dev/tty.usbserialtrên MacOS. LogViewer có thể đọc trực tiếp 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 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 cho quá trình phát triển của mình với 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âu hỏi của bạn rồi nhấn phím Enter.
Bạn có thể xem Assistant Simulator câu trả lời và nhấp vào nút sau câu hỏi của bạn để Gửi lại câu hỏi đó.
Chạy câu nói hàng loạt
Di chuột đến thanh trình đơn GOOGLE ASSISTANT SIMULATOR (TRÌNH MÔ PHỎNG TRỢ LÝ GOOGLE) rồi chọn trong số các lựa chọn sau để thiết lập tập lệnh:
Nhấp vào để mở các tập lệnh phát ngôn hiện có.
Nhấp vào để lưu nhật ký vào một tập lệnh
*.utterance.
Để bắt đầu gửi câu nói theo lô, hãy chọn một trong các cách sau:
- Nhấp vào để chọn một kịch bản phát ngôn trong cửa sổ thả xuống.
Mở trực tiếp tệp
*.utterancerồi nhấp vào biểu tượng .
Xem Cloud Logging
Trong phần QUICK ACCESS (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ỉ hiển thị 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 Xem thêm để xem thêm nhật ký.
Xem Home Graph và chạy thử nghiệm
Trong phần QUICK ACCESS (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 đồ nhà). 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 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 đợi kết quả kiểm tra.
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 tất tất cả hoạt động kiểm thử.
Sử dụng tiện ích Google Home để gỡ lỗi Matter
Ghi nhật ký trong Android
Trong phần MATTER LOGGING TOOLS (CÔNG CỤ GHI NHẬT KÝ MATTER), hãy nhấp vào Android Logs (Nhật ký) để mở trang Android Logs (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 sẽ có thể xem từng dòng nhật ký. Xin lưu ý rằng nhật ký được lọc, tức là chỉ có nhật ký liên quan đến GHA và mô-đun Google Play services Matter được 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Ụ GHI NHẬT KÝ 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 bạn quan tâm.
Tải tất cả nhật ký Matter xuống
Trong phần 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 vào 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 về 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 bằng Google Home Extension, hãy chọn trong số 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 để gửi cho chúng tôi ý kiến đề xuất của bạn.
- 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 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.