Google Home Plugin for Android Studio được thiết kế và tạo cho các nhà phát triển Google Home Platform. Trình bổ trợ này cấp cho bạn quyền truy cập vào Google Assistant Simulator, tính năng Ghi nhật ký trên đám mây và các công cụ khác để đơn giản hoá quy trình phát triển nhà thông minh.
Thông báo bảo mật
Để ngăn Android Studio lưu trữ khoá bí mật và mật khẩu, hãy hoàn tất các bước sau:
- Nhấp vào File (Tệp), rồi nhấp vào Settings... (Cài đặt).
- Trong Appearance & Behavior (Giao diện và hành vi), hãy mở rộng System Settings (Cài đặt hệ thống), sau đó nhấp vào Passwords (Mật khẩu).
- Chọn Không lưu, quên mật khẩu sau khi khởi động lại.
Tính năng
Trình mô phỏng Trợ lý
Để 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 Android Studio.
Tương tự như Trình mô phỏng Trợ lý hiện có trong Bảng điều khiển Actions on Google 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, ví dụ: "Bật đèn". Bên trong Android Studio, 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, bật đèn".
Xem ghi nhật ký trên đám mây
Google 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 của mình. Để đơn giản hoá quá trình phát triển, Google Home Plugin sẽ hiển thị các thông báo Cloud Logging 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ố.
Bạn có thể hiển thị nhật ký theo thời gian thực hoặc chọn một phạm vi ngày.
Pin theo lô
Phản hồi của Assistant Simulator cho một cách nói không xác định. Ví dụ: câu trả lời có thể là bất kỳ cụm từ nào sau đây:
- Tôi hiểu rồi. Tôi đang bật 2 đèn.
- Chắc chắn rồi, tôi đang bật 2 đèn.
- Tôi hiểu rồi. Tôi đang bật 2 đèn.
- Được rồi, tôi đang bật 2 đèn.
Để chạy kiểm thử tự động và xác minh cách hoạt động của các công cụ tích hợp của Google với các phản hồi này, bạn có thể gửi các cách phát âm hàng loạt đến Assistant Simulator bằng cách chạy các tập lệnh phát âm. Sau khi lưu tập lệnh, bạn có thể thu thập phản hồi và chạy nhiều thử nghiệm đối với các truy vấn của mình.
Trình xem Home Graph
Home Graph Viewer cho phép bạn hiển thị trạng thái của thiết bị và chạy Bộ kiểm thử Google Home trong trình duyệt của mình.
Trình xem nhật ký cầu gỡ lỗi Android (adb)
Trình xem nhật ký Adb là một công cụ để xem và phân tích các tệp nhật ký, ví dụ: tệp nhật ký thiết bị Matter, nhật ký Google Home và nhật ký Android.
Cài đặt
Để cài đặt Google Home Plugin trong Android Studio, hãy làm theo các bước sau:
- Tải xuống hoặc cập nhật Android Studio. Tải Android Studio xuống
- Chuyển đến Tệp > Cài đặt (Android Studio > Lựa chọn ưu tiên trên MacOS).
- Trong mục Plugins (Trình bổ trợ), hãy chọn Marketplace rồi tìm
google home. - Cài đặt công cụ rồi khởi động lại Android Studio.
Bạn cũng có thể tải trình bổ trợ này trực tiếp từ JetBrains Marketplace.
Thiết lập
Sau khi cài đặt trình bổ trợ, bạn cần hoàn tất các bước sau trước khi có thể sử dụng Assistant Simulator và xem tính năng Ghi nhật ký đám mây:
Đăng nhập bằng Google
Bạn có thể đăng nhập vào tài khoản nhà phát triển của mình trên bảng điều khiển Google Home, uỷ quyền cho Android Studio thay mặt bạn giao tiếp với các dịch vụ của Google.
Nhấp vào thẻ Google Home trong cột thẻ dọc ở bên trái cửa sổ Android Studio.
Đối với Đăng nhập bằng, hãy nhấp vào Google để khởi chạy trình duyệt của bạn.
Chọn tài khoản 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.
Đóng cửa sổ trình duyệt và quay lại Android Studio.
Lúc này, bạn cần đăng nhập và chọn Sign Out (Đăng xuất).
Chọn một dự án trên Google Cloud
Sau khi đăng nhập, hãy chọn một Dự án trong trình đơn thả xuống. Để lọc danh sách dự án, hãy nhập biểu thức Filter (Bộ lọc), ví dụ: matter, sau đó nhấn vào Enter.
Trình đơn thả xuống Project (Dự án) tải 100 dự án đầu tiên dựa trên Filter (Bộ lọc). Các lựa chọn của bạn sẽ được giữ lại khi bạn thoát khỏi Android Studio.
Để được trợ giúp về các bộ lọc dự án, hãy tham khảo phần Tham số truy vấn trong Tài liệu tham khảo của Google Cloud.
Sử dụng Trình mô phỏng Trợ lý
Để mở Assistant Simulator trong Android Studio, hãy nhấp vào Utterances Panel (Bảng điều khiển Google Home Plugin).
Có một số cách để gửi truy vấn đến Assistant Simulator. Tiếp theo, chúng ta sẽ xem xét từng tuỳ chọn.
Nhập truy vấn và thu thập câu trả lời
Để tương tác với Assistant Simulator, hãy nhập truy vấn của bạn rồi nhấn phím Enter.
Bạn có thể gửi lại truy vấn bằng cách nhấp vào biểu tượng gửi lại ở cuối truy vấn.
Sau khi gửi một hoặc nhiều cụm từ tìm kiếm, hãy nhấp vào Phát lại để chạy lại các truy vấn và kiểm tra câu trả lời của bạn. Bảng điều khiển Utterances (Utterances) theo dõi các truy vấn và phản hồi của bạn trong bộ nhớ đệm được lưu trữ. Phát lại chỉ thêm các phản hồi mới vào bộ nhớ đệm nội bộ này và sẽ không sao chép truy vấn của bạn mỗi khi bạn nhấp vào nút.
Nhấp vào Save (Lưu) để lưu các truy vấn và phản hồi mà bạn đã nhập vào bảng điều khiển Utterances (Lựa chọn). Các hoạt động tương tác của bạn được chuyển đổi sang JSON ở định dạng sau:
ask: Truy vấn của bạn.answers: Một loạt các phản hồi Assistant Simulator có thể có.
Bạn có thể chỉnh sửa tệp JSON này trong Android Studio.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Thu thập phản hồi hàng loạt
Trên bảng điều khiển Google Home Plugin, hãy nhấp vào Utterances File (Tệp Utterances) để mở các tệp JSON đã lưu trong thẻ mới. Đối với phương thức Select Path (Chọn đường dẫn), bạn có thể chọn một tệp hoặc một thư mục. Nếu bạn chọn một thư mục, thì chế độ collect (Thu thập) và Test (Kiểm thử) sẽ hoạt động trên tất cả các tệp .json cách phát âm trong thư mục đó.
Bạn có thể mở nhiều thẻ cho cùng một tệp hoặc nhiều tệp, ví dụ: lights, lights(1) và plug.
Thanh trạng thái hiển thị kết quả của lần kiểm thử gần đây nhất (nếu có), một chấm màu vàng hoặc xanh lục để cho biết liệu tệp đã được thu thập hay chưa cũng như đường dẫn tệp .json cách nói. Sau khi bạn nhấp vào Thu thập, Assistant Simulator sẽ chạy các truy vấn của bạn.
Bạn sẽ được thông báo khi một phản hồi mới được thu thập và Thanh trạng thái sẽ hiển thị bộ đếm trong khi các truy vấn của bạn đang được xử lý.
Khi quá trình Thu thập hoàn tất, Thanh trạng thái sẽ cập nhật bằng dấu kiểm màu xanh lục ở phía trước đường dẫn .json, và các tệp lời nói sẽ được điền sẵn các phản hồi có thể có.
{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
Nếu bạn Dừng thu thập sớm, đường dẫn .json sẽ không được đánh dấu là đã thu thập.
Kiểm thử cách phát âm theo lô
Sau khi bạn thu thập phản hồi, hãy nhấp vào Test (Kiểm thử) để phát lại các truy vấn cũng như kiểm tra phản hồi và nhật ký. Khi bạn kiểm thử các cách nói hàng loạt, Assistant Simulator sẽ đợi các phản hồi được lưu vào tệp JSON. Nếu kiểm thử của bạn trả về một phản hồi chưa được thu thập, thì bạn sẽ nhận được một thông báo tương tự như phản hồi sau:
Expected one of: "Got it, turning on
2 lights."
Trường hợp này cho biết quá trình kiểm thử không thành công. Nếu không, Assistant Simulator sẽ chạy từng truy vấn và trả về một phản hồi. Trạng thái kiểm tra sẽ hiển thị trong Thanh trạng thái nếu kiểm thử thành công.
Xem ghi nhật ký trên đám mây
Để mở thẻ dự án trong cửa sổ công cụ Cloud Logs, hãy nhấp vào Cloud Logs (Nhật ký trên đám mây) trên bảng điều khiển Google Home Plugin. Bạn có thể mở các thẻ Nhật ký đám mây riêng biệt cho từng dự án.
Cụm từ tìm kiếm
Đối với dự án đã chọn, bạn cũng có thể lọc nhật ký bằng trường Truy vấn.
Ví dụ: để lọc nhật ký cho từ khoá light:
Chọn Use Q (Sử dụng chất lượng) để sử dụng Logging query language (Ngôn ngữ truy vấn ghi nhật ký).
Dưới đây là một vài ví dụ về các truy vấn Quản lý chất lượng để giúp bạn bắt đầu:
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
Truy vấn ngày và giờ
Bạn cũng không bắt buộc phải truy vấn nhật ký theo ngày và bạn có thể bật bằng cách nhấp vào Sau và Trước. Bạn có thể nhập định dạng ngày và giờ vào trường văn bản được cung cấp, ví dụ: 5/11/22, 12:37 PM hoặc có thể sử dụng bộ chọn ngày để chọn ngày, sau đó nhập giờ vào trường văn bản.
- Để chọn một ngày sau
5/1/22, hãy chọn Sau rồi nhấp vào biểu tượng ngày . - Để chọn một ngày trước
5/1/22, hãy chọn Trước rồi nhấp vào biểu tượng ngày . - Để chọn một ngày trong khoảng thời gian từ
5/1/22đến6/30/22, hãy chọn Trước và Sau, rồi chọn ngày trong biểu tượng ngày .
Chọn Thời gian thực để tìm nạp nhật ký dự án đang hoạt động. Nhấp vào Stop (Dừng) để kết thúc nguồn cấp dữ liệu theo thời gian thực.
Mức độ nghiêm trọng
Bạn cũng có thể chọn Mức độ nghiêm trọng tối thiểu trong trình đơn thả xuống.
Kết quả truy vấn
Nhấp vào Tìm nạp để gửi các tham số truy vấn.
Sau khi tải nhật ký, hãy nhấp vào một bản ghi bất kỳ để mở rộng tải trọng JSON đầy đủ. Nhấp lần nữa để xem toàn bộ thông báo.
Nếu muốn, bạn có thể nhập một từ khoá vào hộp Filter (Bộ lọc) để thu hẹp kết quả
nhật ký của mình. Nhấp vào x để xoá bộ lọc rồi quay lại kết quả tìm nạp ban đầu.
Xem Biểu đồ nhà và chạy kiểm thử
Để liệt kê các thiết bị, hãy chọn Home Graph (Biểu đồ trang chủ) trên bảng điều khiển Google Home Plugin.
Nhấp vào Refresh (Làm mới) để hiển thị Device name (Tên thiết bị), Device ID (Mã thiết bị) và Device type (Loại thiết bị) cho các thiết bị liên kết với dự án đã chọn. Bạn có thể mở nhiều bảng điều khiển Google Home Graph cho các dự án riêng biệt.
Sau khi thiết bị của bạn được tải, hãy nhấp vào bất kỳ bản ghi nào để mở rộng tải trọng JSON đầy đủ.
Bạn cũng có thể sử dụng Mở rộng và Thu gọn để hiển thị và ẩn tải trọng JSON cho thiết bị.
Để chạy Test Suite (Bộ kiểm thử) cho một thiết bị cụ thể, hãy nhấp vào Test (Kiểm thử). Thao tác này sẽ khởi chạy Bộ kiểm thử trong trình duyệt với thiết bị của bạn được chọn và sẵn sàng để kiểm thử. Nhấp vào Start (Bắt đầu) rồi chờ kết quả kiểm thử.
Bạn có thể kiểm tra chi tiết kiểm thử và xem nhật ký sau khi kiểm thử hoàn tất.
Trình xem nhật ký cầu gỡ lỗi Android (adb)
Để mở một thẻ dự án trong cửa sổ công cụ Nhật ký Adb, hãy nhấp vào lệnh Nhật ký Adb trong thanh công cụ của trình bổ trợ Google Home (ở bên trái). Bạn có thể mở các thẻ Nhật ký Adb riêng biệt cho từng tệp nhật ký. Để xoá một thẻ, hãy nhấp vào biểu tượng .
Sử dụng trường Chọn để chọn một thành phần ghi nhật ký cụ thể cần xem và trình đơn thả xuống Mức độ nghiêm trọng để chỉ hiển thị các mục nhập cùng mức độ nghiêm trọng của nhật ký.
Đối với nhật ký adb đã chọn, bạn có thể lọc các mục nhập nhật ký bằng trường Bộ lọc với các đối tượng sửa đổi Phân biệt chữ hoa chữ thường hoặc Biểu thức chính quy không bắt buộc.
Ngoài ra, bạn có thể:
- Tìm các mục cụ thể bằng trường Tìm cũng như lệnh Tìm tiếp theo (biểu tượng ) và lệnh Tìm trước (biểu tượng ).
- Sử dụng đối tượng sửa đổi Phân biệt chữ hoa chữ thường hoặc Regex (Biểu thức chính quy) không bắt buộc.
- Chuyển đến dòng để chuyển đến một dòng được chỉ định (theo số) trong nhật ký.
Chọn Được đánh số để xem những dòng nhật ký đã thêm số dòng. Chọn Raw (Thô) để xem các mục nhập nhật ký thô.
Tài nguyên và ý kiến phản hồi
Nhấp vào Tài nguyên để xem danh sách các công cụ và tài nguyên cho nhà phát triển.
Để 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 Plugin, hãy nhấp vào Phản hồi.
