Google Home Plugin for Android Studio được thiết kế và tạo ra cho Google Nhà phát triển Home Platform. Trình bổ trợ này cung 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 giúp đơn giản hoá quá trình quá 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 mục Giao diện và Hành vi, mở rộng mục Cài đặt hệ thống, rồi nhấp vào 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ợ lý hiện có Được cung cấp Trình mô phỏng trong Bảng điều khiển của Actions on Google Console, Assistant Simulator cho phép bạn để dễ dàng điều khiển thiết bị của mình bằng cách nhập truy vấn, ví dụ: "Bật đèn." Bên trong Android Studio, Assistant Simulator trả lời bằng tin nhắn văn bản dựa trên các lệnh, chẳng hạn như "Được rồi, bật đèn".
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 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 phạm vi ngày.
Gói dịch vụ
Assistant Simulator phản hồi cho một cách phát âm không thuật toán tất đị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, đang bật 2 đèn.
- Chắc chắn rồi, tôi đang bật 2 đèn.
- Tôi hiểu, 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 thức các công cụ tích hợp của Google hoạt động với các phản hồi khác nhau này, bạn có thể gửi cách phát âm hàng loạt cho Assistant Simulator bằng cách chạy các tập lệnh phát âm. Sau khi tập lệnh đã lưu, bạn có thể thu thập câu trả lời và chạy nhiều thử nghiệm đối với các truy vấn của mình.
Trình xem biểu đồ Home
Trình xem biểu đồ Home giúp bạn hiển thị trạng thái của thiết bị và khởi chạy Bộ kiểm tra Google Home trong trình duyệt của bạn.
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ụ: Matter tệp nhật ký thiết bị, nhật ký của Google Home và Android nhật ký.
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 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 bạn có thể sử dụng Assistant Simulator và xem nhật ký trên đá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 giao tiếp với Google thay mặt bạn.
Nhấp vào thẻ Google Home trong cột thẻ dọc ở bên trái cạnh cửa sổ Android Studio.
Đối với tuỳ chọn Đăng nhập bằng, hãy nhấp vào Google để mở trình duyệt của bạn.
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.
Đóng cửa sổ trình duyệt và quay lại Android Studio.
Lúc này, bạn đã đăng nhập và có thể Đă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 Dự án trong trình đơn thả xuống. Để lọc
danh sách dự án, nhập biểu thức Filter (Bộ lọc) (ví dụ: matter) rồi nhấn
Enter.
Trình đơn thả xuống Dự án sẽ tải 100 dự án đầu tiên dựa trên 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 Android Studio.
Để được trợ giúp về bộ lọc dự án, hãy tham khảo 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ý
Cách mở Assistant Simulator trong Android Studio: nhấp vào Bảng điều khiển tiện ích từ 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 tùy 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 rồi nhấn Nhập.
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 của bạn.
Sau khi gửi một hoặc nhiều truy vấn, hãy nhấp vào Phát lại để chạy lại các thắc mắc và kiểm tra câu trả lời của bạn. Bảng điều khiển Utterances (Lời nói) theo dõi các truy vấn và câu trả lời của bạn trong bộ nhớ đệm được lưu trữ. Tính năng Phát lại chỉ thêm câu trả lời mới cho bộ nhớ đệm nội bộ này và sẽ không lặp lại truy vấn của bạn mỗi khi bạn nhấp vào .
Nhấp vào biểu tượng Lưu để lưu các cụm từ tìm kiếm và phản hồi mà bạn đã nhập trong bảng điều khiển Cụm từ. Các hoạt động tương tác của bạn sẽ được chuyển đổi sang JSON theo cách sau định dạng:
ask: Truy vấn của bạn.answers: Một loạt 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 câu trả lời hàng loạt
Từ bảng điều khiển Google Home Plugin, hãy nhấp vào Tệp tiện ích để mở
tệp JSON đã lưu của bạn trong thẻ mới. Đối với thao tác Select Path (Chọn đường dẫn), bạn có thể chọn một
hoặc thư mục. Nếu bạn chọn một thư mục, tuỳ chọn Thu thập và Kiểm tra sẽ
làm việc trên tất cả các cách phát âm .json tệp 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 tra gần đây nhất (nếu có),
một chấm màu vàng hoặc xanh lục để cho biết tệp đã được thu thập hay chưa và
cách phát âm .json. 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ẽ nhận được thông báo khi hệ thống thu thập câu trả lời mới và bạn sẽ thấy Thanh trạng thái
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 phát âm của bạn được điền sẵn
các câu trả lờ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 sớm việc thu thập, đường dẫn .json của bạn sẽ không được đánh dấu là
đã thu thập.
Kiểm thử cách phát âm của hàng loạt
Khi bạn đã thu thập xong câu trả lời, hãy nhấp vào Kiểm tra để phát lại truy vấn của bạn cũng như kiểm tra phản hồi và nhật ký của bạn. Khi bạn kiểm thử các câu lệnh hàng loạt, Assistant Simulator sẽ mong đợi các phản hồi được lưu vào tệp JSON. Nếu kết quả kiểm thử 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 thấy kiểm thử không thành công. Nếu không, giá trị Assistant Simulator sẽ chạy từng truy vấn của bạn và trả về một phản hồi. Một 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 nhật ký trên đám mây
Để mở một thẻ dự án trong cửa sổ công cụ Cloud Logs (Nhật ký trên đám mây), hãy nhấp vào Cloud Logs (Nhật ký trên đám mây) khỏi 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 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á là light:
Chọn Dùng Quản lý chất lượng để sử dụng Ngôn ngữ truy vấn ghi nhật ký.
Dưới đây là một số ví dụ về truy vấn 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 có thể truy vấn nhật ký theo ngày (không bắt buộc) và bật tính năng này 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ờ của mình vào văn bản
trường được cung cấp, ví dụ: 5/11/22, 12:37 PM hoặc bạn 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 từ
5/1/22đến6/30/22, hãy chọn Trước và Sau và chọn ngày từ biểu tượng ngày .
Chọn Thời gian thực để tìm nạp nhật ký dự án trực tiếp. Nhấp vào Ngừ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 bản ghi bất kỳ để mở rộng toàn bộ tải trọng JSON. Nhấp lại vào để hiện toàn bộ thông báo.
Nếu muốn, bạn có thể nhập từ khoá vào hộp Bộ lọc để thu hẹp nhật ký của mình
kết quả. Nhấp vào dấu x để xoá bộ lọc và quay lại ảnh gốc
kết quả tìm nạp.
Xem biểu đồ trang chủ và chạy kiểm thử
Để liệt kê các thiết bị của bạn, hãy chọn Home Graph (Biểu đồ nhà) trên Bảng điều khiển Google Home Plugin.
Nhấp chuột Làm mới để hiển thị Tên thiết bị, Mã thiết bị và Loại thiết bị cho các thiết bị của bạn được liên kết với dự án đã chọn. Bạn có thể có nhiều Các bảng điều khiển của Google Home Graph sẽ mở ra 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ản ghi bất kỳ để mở rộng toàn bộ tải trọng JSON.
Bạn cũng có thể sử dụng nút Mở rộng và Thu gọn để hiển thị và ẩn tệp JSON cho thiết bị của bạn.
Cách chạy Bộ thử nghiệm cho một thiết bị cụ thể: nhấp vào Kiểm tra. 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ờ kiểm thử kết quả.
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 Nhật ký Adb trong thanh công cụ plugin Google Home (ở bên trái). Bạn có thể mở Nhật ký Adb riêng cho mỗi tệp nhật ký. Để xóa tab, 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 ghi nhật ký cụ thể cần xem và Trình đơn thả xuống Mức độ nghiêm trọng chỉ cho thấy các mục nhập có mức độ nghiêm trọng trùng khớp 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 cách sử dụng trường Filter (Bộ lọc) với các đối tượng 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 cách sử dụng trường Tìm và các 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 công cụ 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).
- Chuyển đến dòng để chuyển đến một dòng đã chỉ định (theo số) trong nhật ký.
Chọn Được đánh số để xem các dòng nhật ký có số dòng được thêm. 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ông cụ và tài nguyên cho nhà phát triển.
Để gửi ý kiến hoặc phản hồi của bạn về cách chúng tôi có thể cải thiện sự phát triển trải nghiệm với Google Home Plugin, hãy nhấp vào Phản hồi.
