Google Home Plugin for Android Studio được thiết kế và tạo cho nhà phát triển Nền tảng Google Home. Trình bổ trợ này cho phép bạn truy cập vào Google Assistant Simulator, Cloud Logging 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ữ 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 chọn Settings... (Cài đặt...)
- Trong phần Appearance & Behavior (Giao diện và hành vi), hãy mở rộng System Settings (Cài đặt hệ thống), rồi nhấp vào Passwords (Mật khẩu).
- Chọn Do not save, forget passwords after restart (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ó 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.
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ụ: "Turn on the light." Trong Android Studio, Assistant Simulator sẽ 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ụ: "Alright, turning on the light."
Xem Cloud Logging
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. Để đơn giản hoá quá trình phát triển, Google Home Plugin sẽ hiển thị các thông báo theo thời gian thực Cloud Logging 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.
Cụm từ theo lô
Assistant Simulator phản hồi đối với một cụm từ không phải là phản hồi xác định. Ví dụ: phản hồi có thể là bất kỳ cụm từ nào sau đây:
- Đã hiểu, đang bật 2 đèn.
- Chắc chắn rồi, đang bật 2 đèn.
- Đã hiểu, đang bật 2 đèn.
- Được rồi, đang bật 2 đèn.
Để chạy kiểm thử tự động và xác minh cách các tính năng tích hợp của Google hoạt động với những phản hồi này, bạn có thể gửi cụm từ theo lô đến Assistant Simulator bằng cách chạy tập lệnh cụm từ. Sau khi lưu tập lệnh, bạn có thể thu thập phản hồi và chạy nhiều kiểm thử đối với các truy vấn của mình.
Trình xem Biểu đồ nhà
Trình xem Biểu đồ nhà cho phép bạn hiển thị trạng thái của thiết bị và khởi chạy Bộ kiểm thử Google Home trong trình duyệt.
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 tệp nhật ký, ví dụ: Matter tệp nhật ký thiết bị, 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 hoặc cập nhật Android Studio. Tải Android Studio xuống
- Chuyển đến File > Settings (Android Studio > Preferences trên MacOS).
- Trong phần Plugins (Trình bổ trợ), hãy chuyển đến Marketplace (Cửa hàng) 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ừ Cửa hàng JetBrains.
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 thì mới có thể sử dụng Assistant Simulator và xem Cloud Logging:
Đă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, cho phép Android Studio giao tiếp với các dịch vụ của Google thay mặt bạn.
Nhấp vào thẻ Google Home trong cột thẻ dọc ở bên trái của cửa sổ Android Studio.
Đối với Sign in with (Đăng nhập bằng), hãy nhấp vào Google để khởi chạy 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 Sign in with Google (Đăng nhập bằng Google), hãy nhấp vào Allow (Cho phép).
Đóng cửa sổ trình duyệt rồi quay lại Android Studio.
Giờ đây, bạn sẽ đăng nhập và có thể chọn Sign Out (Đăng xuất).
Chọn một dự án trên đám mây
Sau khi đăng nhập, hãy chọn một Project (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, rồi nhấn 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ủa bạn. 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ề 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 về 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 trong 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 cách.
Nhập truy vấn và thu thập phản hồi
Để tương tác với Assistant Simulator, hãy nhập truy vấn rồi nhấn 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 truy vấn, hãy nhấp vào Replay để chạy lại các truy vấn và kiểm tra phản hồi. Bảng điều khiển Utterances (Cụm từ) theo dõi các truy vấn và phản hồi của bạn trong bộ nhớ đệm đã lưu trữ. Replay (Phát lại) chỉ thêm phản hồi mới vào bộ nhớ đệm nội bộ này và sẽ không sao chép các truy vấn của bạn mỗi khi bạn nhấp vào nút này.
Nhấp vào Save (Lưu) để lưu các truy vấn và phản hồi mà bạn đã nhập trong bảng điều khiển Utterances (Cụm từ). Các lượt tương tác của bạn được chuyển đổi sang JSON theo định dạng sau:
ask: Truy vấn của bạn.answers: Một mảng các phản hồi có thể có.Assistant Simulator
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 theo lô
Trong bảng điều khiển Google Home Plugin, hãy nhấp vào Utterances File để mở
các tệp JSON đã lưu trong một thẻ mới. Đối với 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ì Collect (Thu thập) và Test (Kiểm thử) sẽ hoạt động trên tất cả các tệp cụm từ .json trong thư mục đó.
Bạn có thể mở nhiều thẻ cho cùng một tệp hoặc các tệp khác nhau, 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 dấu chấm màu vàng hoặc màu xanh lục để cho biết tệp đã được thu thập hay chưa và đường dẫn tệp cụm từ .json. Sau khi bạn nhấp vào
Collect,
trình mô phỏng sẽ chạy các truy vấn của bạn.Assistant Simulator
Bạn sẽ nhận đượ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 Collect (Thu thập) hoàn tất, Thanh trạng thái sẽ cập nhật dấu kiểm màu xanh lục ở trước đường dẫn .json và các tệp cụm từ của bạn sẽ được điề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 Stop (Dừng) quá trình thu thập sớm, đường dẫn .json sẽ không được đánh dấu là đã thu thập.
Kiểm thử cụm từ theo lô
Sau khi thu thập phản hồi, hãy nhấp vào Test để phát lại các truy vấn và kiểm tra phản hồi và nhật ký. Khi bạn kiểm thử cụm từ theo lô, Assistant Simulator sẽ tìm các phản hồi được lưu vào tệp JSON của bạn. Nếu kết quả kiểm thử trả về một phản hồi chưa được thu thập, bạn sẽ nhận được 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 kiểm thử không thành công. Nếu không, Assistant Simulator sẽ chạy từng truy vấn của bạn và trả về một phản hồi. Dấu kiểm sẽ xuất hiện trong Thanh trạng thái nếu kiểm thử thành công.
Xem Cloud Logging
Để mở thẻ dự án trong cửa sổ công cụ Nhật ký trên đám mây, hãy nhấp vào Cloud Logs trong bảng điều khiển Google Home Plugin. Bạn có thể mở các thẻ Nhật ký trên đám mây riêng cho từng dự án.
Cụm từ truy vấn
Đối với dự án đã chọn, bạn cũng có thể lọc nhật ký bằng trường Query (Truy vấn).
Ví dụ: để lọc nhật ký cho từ khoá light:
Chọn Use QL (Sử dụng QL) để sử dụng Ngôn ngữ truy vấn nhật ký.
Dưới đây là một vài ví dụ về truy vấn QL 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 có thể chọn truy vấn nhật ký theo ngày bằng cách nhấp vào After (Sau) và Before (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 PMhoặc bạn có thể sử dụng bộ chọn ngày
để chọn ngày, sau đó nhập thời gian vào trường văn bản.
- Để chọn ngày sau
5/1/22, hãy chọn After (Sau) rồi nhấp vào biểu tượng ngày . - Để chọn ngày trước
5/1/22, hãy chọn Before rồi nhấp vào biểu tượng ngày . - Để chọn ngày trong khoảng từ
5/1/22đến6/30/22, hãy chọn Before (Trước) và After (Sau) rồi chọn ngày trong biểu tượng ngày .
Chọn Real time (Thời gian thực) để tìm nạp nhật ký dự án trực tiếp. 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 Minimal Severity (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 nhật ký được tải, hãy nhấp vào bất kỳ bản ghi nào để mở rộng toàn bộ tải trọng JSON. Nhấp lại vào để hiển thị toàn bộ thông báo.
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ý. Nhấp vào x để xoá bộ lọc và 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 trong bảng điều khiển Google Home Plugin.
Nhấp vào Refresh (Làm mới) đã lưu vào bộ nhớ đệm để 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ị được liên kết với dự án đã chọn. Bạn có thể mở nhiều Google Home Graph bảng điều khiển cho các dự án riêng biệt.
Sau khi các thiết bị được tải, hãy nhấp vào bất kỳ bản ghi nào để mở rộng toàn bộ tải trọng JSON.
Bạn cũng có thể sử dụng Expand (Mở rộng) và Collapse (Thu gọn) để hiển thị và ẩn tải trọng JSON cho các thiết bị.
Để khởi chạy 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 của bạn với thiết bị đã 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 thông tin chi tiết về 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ở thẻ dự án trong cửa sổ công cụ Nhật ký adb, hãy nhấp vào lệnh Adb Log (Nhật ký adb) trong thanh công cụ trình bổ trợ Google Home (ở bên trái). Bạn có thể mở các thẻ Nhật ký adb riêng 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 Select (Chọn) để chọn một thành phần nhật ký cụ thể để xem và trình đơn thả xuống Severity (Mức độ nghiêm trọng) để chỉ hiển thị các mục có mức độ nghiêm trọng của nhật ký phù hợp.
Đối với nhật ký adb đã chọn, bạn có thể lọc các mục nhật ký bằng trường Filter (Bộ lọc) với các công cụ sửa đổi Case-sensitive (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.
Ngoài ra, bạn có thể:
- Tìm các mục cụ thể bằng trường Find và các lệnh Find Next (biểu tượng ) và Find Previous (biểu tượng ).
- Sử dụng các công cụ sửa đổi Case-sensitive (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.
- Jump to line (Chuyển đến dòng) để chuyển đến một dòng được chỉ định (theo số) trong nhật ký.
Chọn Numbered (Đánh số) để xem các dòng nhật ký đã thêm số dòng. Chọn Raw (Thô) để xem các mục nhật ký thô.
Tài nguyên và ý kiến phản hồi
Nhấp vào Resources (Tài nguyên) để xem danh sách các công cụ và tài nguyên dành 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 Feedback (Ý kiến phản hồi).
