Lưu ý! Chương trình dùng thử dành cho nhà phát triển mới sắp ra mắt. Hãy đăng ký tại đây và trở thành một trong những người đầu tiên dùng thử các công cụ mới cũng như đưa ra ý kiến phản hồi.

Plugin Google Home cho Android Studio

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 giúp bạ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.

Trình bổ trợ Google Home cho Android Studio

Thông báo bảo mật

Để ngăn Android Studio lưu trữ khóa bí mật và mật khẩu, hãy hoàn tất các bước sau:

  1. Nhấp vào File rồi Settings....
  2. 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).
  3. Chọn Không lưu, quên mật khẩu sau khi khởi động lại.
Trình bổ trợ Google Home cho Android Studio

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 hiện có của Trợ lý được cung cấp trong Actions on Google Console Console, Assistant Simulator cho phép bạn dễ dàng điều khiển các thiết bị bằng cách nhập các truy vấn, chẳng hạn như "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, tôi đang bật đèn".

Thử nghiệm bằng Trình mô phỏng Trợ lý

Xem 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 để 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 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ý thời gian thực hoặc chọn phạm vi ngày.

Chế độ xem ghi nhật ký trên đám mây

Số lượng hàng loạt

Assistant Simulator phản hồi cho một cách phát âm không mang tính quyết định. Ví dụ: phản hồi có thể là bất kỳ cụm từ nào sau đây:

  • Tôi hiểu rồ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, đ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 các công cụ tích hợp của Google hoạt động với nhiều phản hồi, bạn có thể gửi hàng loạt câu lệnh đến Assistant Simulator bằng cách chạy tập lệnh. Sau khi lưu tập lệnh, bạn có thể thu thập các phản hồi và chạy nhiều thử nghiệm với các truy vấn của mình.

Trình xem biểu đồ trang chủ

Trình xem biểu đồ gia đình cho phép bạn hiển thị trạng thái của thiết bị và chạy Bộ thử nghiệm 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ý, chẳng hạn như 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:

  1. Tải xuống hoặc cập nhật Android Studio. Tải Android Studio
  2. Chuyển đến mục Tệp > Cài đặt (Android Studio > Lựa chọn ưu tiên trên MacOS).
  3. Trong phần Plugin, chuyển đến Marketplace và tìm kiếm google home.
  4. Cài đặt công cụ và 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ợ này, bạn cần hoàn tất các bước sau để 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 trong bảng điều khiển của Google Home, ủy quyền cho Android Studio giao tiếp với các dịch vụ của Google thay mặt bạn.

  1. Nhấp vào thẻ Google Home trong cột thẻ dọc ở phía bên trái của cửa sổ Android Studio.

  2. Đối với Đăng nhập bằng, nhấp vào Google để khởi chạy trình duyệt của bạn.

    Đăng nhập vào Google Studio trên Android
  3. 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.

  4. Trên trang ủy quyền Đăng nhập bằng Google, hãy nhấp vào Cho phép.

  5. Đóng cửa sổ trình duyệt và quay lại Android Studio.

Bây giờ, bạn sẽ đăng nhập, với tùy chọn Đă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, hãy nhập biểu thức Filter (Bộ lọc), chẳng hạn như matter, sau đó 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ác lựa chọn của bạn sẽ được giữ lại khi bạn thoát khỏi Android Studio.

Chọn một dự án

Để được trợ giúp về bộ lọc dự án, hãy tham khảo Tham số truy vấn trong Google Cloud Reference.

Sử dụng Trình mô phỏng Trợ lý

Để mở Assistant Simulator trong Android Studio, hãy nhấp vào Utterances Panel từ bảng điều khiển Google Home Plugin.

Mở bảng điều khiển rác

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 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 truy vấn, hãy nhấp vào Phát lại để chạy lại các truy vấn và kiểm tra phản hồi của bạn. Bảng điều khiển Utterance (Thông báo) theo dõi các truy vấn và phản hồi của bạn trong bộ nhớ đệm đã 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 các truy vấn của bạn mỗi khi bạn nhấp vào nút.

Phát lại thông tin trùng lặp qua Trình mô phỏng Trợ lý

Nhấp vào 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 (Utterances). Các 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 dãy các phản hồi Assistant Simulator có thể xảy ra.

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 đợt

Từ bảng điều khiển Google Home Plugin, hãy nhấp vào Utterances File (Tệp rác) để mở các tệp JSON đã lưu trong thẻ mới. Đối với phần Chọn đường dẫn, bạn có thể chọn một tệp hoặc thư mục. Nếu bạn chọn một thư mục, tính năng Thu thậpKiểm thử sẽ hoạt động trên tất cả các tệp .json của câu lệnh 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, chẳng hạn như lights, lights(1)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 màu xanh lục để cho biết tệp đã được thu thập hay chưa và đường dẫn tệp .json của lời 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ẽ nhận được thông báo khi hệ thống thu thập một phản hồi mới và Thanh trạng thái sẽ hiển thị bộ đếm trong khi truy vấn của bạn đang được xử lý.

Thu thập dữ liệu sai lệch bằng Trình mô phỏng Trợ lý

Khi Collect (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 trước đường dẫn .json và các tệp phát âm sẽ được điền sẵn dữ liệu phản hồi.

Thu thập dữ liệu sai lệch bằng Trình mô phỏng Trợ lý
{
  "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 tra cách phát âm theo lô

Sau khi bạn thu thập các phản hồi của mình, hãy nhấp vào Thử nghiệm để phát lại các truy vấn và kiểm tra các phản hồi cũng như nhật ký của bạn. Khi bạn kiểm thử cách phát âm theo lô, Assistant Simulator sẽ yêu cầu phản hồi được lưu vào tệp JSON. Nếu kiểm thử của bạn trả về phản hồi chưa được thu thập, 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."

Chạy Utterances bằng Trình mô phỏng Trợ lý

Kịch bản này cho thấy một lần kiểm tra 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. Bước kiểm tra sẽ hiển thị trong Thanh trạng thái nếu kiểm thử thành công.

Chạy Utterances bằng Trình mô phỏng Trợ lý

Xem nhật ký trên đám mây

Để mở thẻ dự án trong cửa sổ công cụ Cloud Log, hãy nhấp vào Cloud Log (Nhật ký trên đám mây) trong bảng Google Home Plugin. Bạn có thể mở các thẻ riêng của Cloud Log cho từng dự án.

Tab ghi nhật ký trên đám mây

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 Truy vấn. Ví dụ: để lọc nhật ký cho từ khóa light:

Truy vấn ghi nhật ký trên đám mây

Chọn Sử dụng QL để dùng Ngôn ngữ truy vấn ghi nhật ký.

Ngôn ngữ truy vấn ghi nhật ký trên đám mây

Dưới đây là một số 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ể bật tính năng truy vấn nhật ký theo ngày bằng cách nhấp vào After (Trước) 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, 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, rồi 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 Before (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 đến 6/30/22, hãy chọn TrướcSau 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 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 Mức tối thiểu mức độ nghiêm trọng từ menu thả xuống.

Kết quả truy vấn

Nhấp vào Tìm nạp để gửi các thông số truy vấn của bạ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 thị thông báo đầy đủ.

Nếu muốn, bạn có thể nhập một từ khoá trong hộp 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 nhật ký trên đám mây

Xem Biểu đồ Trang chủ và Chạy Kiểm tra

Để liệt kê các thiết bị của bạn, hãy chọn Home Graph (Biểu đồ Home) trong bảng điều khiển Google Home Plugin.

Nhấp vào Làm mới để hiển thị Tên thiết bị, Mã thiết bị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 bảng Google Home Graph cho các dự án riêng.

Sau khi tải xong thiết bị, hãy nhấp vào bản ghi bất kỳ để mở rộng tải trọng JSON đầy đủ.

Trọng tải JSON của Biểu đồ Trang chủ

Bạn cũng có thể sử dụng tính năng Mở rộngThu gọn để hiển thị và ẩn tải trọng JSON cho các thiết bị của mình.

Mở rộng và thu gọn biểu đồ chính JSON

Để chạy Bộ thử nghiệm cho một thiết bị cụ thể, hãy nhấp vào Thử nghiệm. Thao tác này sẽ khởi chạy Bộ thử nghiệm trong trình duyệt với thiết bị được chọn và sẵn sàng để thử nghiệm. Nhấp vào Start (Bắt đầu) và đợi kết quả kiểm thử.

Thử nghiệm chạy biểu đồ chính

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.

Kiểm tra Home Graph đã 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ụ Adb Log, hãy nhấp vào lệnh 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ý của mình. Để 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 có mức độ nghiêm trọng tương ứ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 cách sử dụ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 Regex tùy chọn.

Ngoài ra, bạn có thể:

  • Tìm các mục nhập cụ thể bằng trường Tìm và lệnh Tìm tiếp (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 Regex tùy chọn.
  • Chuyển đến dòng để chuyển đến dòng được chỉ định (theo số) trong nhật ký.

Chọn Đã đánh số để xem các dòng nhật ký đã được thêm số. Chọn Raw (Xem thô) để xem các mục nhật ký thô.

Trình xem nhật ký Adb

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 dành 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 trải nghiệm phát triển với Google Home Plugin, hãy nhấp vào Phản hồi.

Gửi ý kiến phản hồi