Xây dựng hành động trong ứng dụng (không dùng nữa)

Hành động trong ứng dụng cho phép người dùng ứng dụng của bạn kích hoạt chức năng hiện có trong ứng dụng Android bằng cách gửi các truy vấn đến Trợ lý Google. Có 5 bước chính để mở rộng ứng dụng Android của bạn bằng Hành động trong ứng dụng:

  1. Xác định chức năng trong ứng dụng để kích hoạt.
  2. Tìm một ý định tích hợp (BII) phù hợp với chức năng trong ứng dụng.
  3. Cung cấp thông tin quá trình thực hiện chi tiết cho ý định tích hợp.
  4. Xem trước Hành động trong ứng dụng trên thiết bị thử nghiệm.
  5. Yêu cầu xem xét và triển khai Hành động trong ứng dụng.

Để thử tạo một Hành động trong ứng dụng bằng ứng dụng mẫu, vui lòng tham gia lớp học lập trình Mở rộng ứng dụng Android sang Trợ lý Google thông qua Hành động trong ứng dụng.

Yêu cầu

Trước khi bạn bắt đầu phát triển Hành động trong ứng dụng, vui lòng đáp ứng các yêu cầu sau:

  • Sở hữu một Tài khoản Google có quyền truy cập vào Google Play Console.
  • Hành động trong ứng dụng chỉ có sẵn cho những ứng dụng được xuất bản trên Cửa hàng Google Play. Ngoài ra, hãy đảm bảo ứng dụng của bạn không nhằm mục đích sử dụng trong hồ sơ công việc, vì Managed Google Play không hỗ trợ Hành động trong ứng dụng.
  • Sở hữu thiết bị Android thực để thử nghiệm tính năng Hành động trong ứng dụng. Phiên bản hệ điều hành được đề xuất là Android 8 (API cấp 26) trở lên, mặc dù Hành động có thể chạy trên thiết bị từ Android 5 (API cấp 21).
  • Cài đặt phiên bản Android Studio mới nhất.
  • Sử dụng cùng một tài khoản Google để đăng nhập vào Android Studio, ứng dụng Google trên thiết bị thử nghiệm và Google Play Console.
  • Thiết lập và kiểm tra để Trợ lý hoạt động trên thiết bị thử nghiệm bằng cách nhấn và giữ nút Màn hình chính.

Xác định chức năng của ứng dụng

Hãy bắt đầu bằng cách chọn Hoạt động trong ứng dụng Android để truy cập thông qua Hành động trong ứng dụng. Những hoạt động này phải được thiết lập bằng các URL liên kết sâu trong Android và có bộ lọc ý định tương ứng trong tệp kê khai ứng dụng Android. Hành động trong ứng dụng sử dụng URL liên kết sâu do Trợ lý tạo ra để đưa người dùng đến ngay nội dung cụ thể trong ứng dụng của bạn.

Để kiểm tra xem các hoạt động của bạn có thể truy cập được và có kích hoạt được bằng Hành động trong ứng dụng hay không, hãy chạy lệnh adb sau:

adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

Ví dụ:

adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

Nếu hoạt động của bạn không khởi chạy chính xác bằng lệnh adb, hãy kiểm tra các mục sau:

  • Trong tệp kê khai ứng dụng của bạn, hoạt động có android:exported=true để có thể khởi chạy nó bằng cách sử dụng ý định từ Trợ lý Google.
  • Nếu bạn sử dụng URL liên kết ứng dụng, hãy làm theo từng bước trong bài viết Xử lý đường liên kết trong ứng dụng Android.

Tìm ý định tích hợp phù hợp với chức năng của ứng dụng

Vui lòng xem lại tệp tham chiếu về ý định tích hợp sẵn để tìm các BII phù hợp cho trường hợp sử dụng của bạn. Ý định tích hợp mô hình hoá các truy vấn của người dùng cho tác vụ mà họ muốn thực hiện trong ứng dụng. Vì vậy, hãy tìm BII phù hợp với chức năng chính và luồng người dùng trong ứng dụng của bạn. Ví dụ: một ứng dụng đặt đồ ăn sẽ có nhiều khả năng sử dụng ý định tích hợp actions.intent.ORDER_MENU_ITEM hơn là một ứng dụng quản lý tài chính. Những ứng dụng triển khai BII không theo chủ đề hoặc không liên quan đến chức năng ứng dụng có thể gây ra trải nghiệm khó hiểu cho người dùng và do đó có thể không đánh giá được Hành động trong ứng dụng.

Cung cấp thông tin chi tiết về việc thực hiện đơn hàng cho ý định tích hợp

Hầu hết việc tạo Hành động trong ứng dụng là tạo tệp actions.xml cho ứng dụng của bạn. Tại đây, bạn chỉ định các ý định tích hợp đã chọn và phương thức thực hiện tương ứng cho các ý định đó. Khi BII mô phỏng truy vấn của người dùng cho một tác vụ, quá trình thực hiện sẽ cung cấp cho Trợ lý thông tin về cách thực hiện tác vụ.

Trong tệp actions.xml, ý định tích hợp được biểu thị dưới dạng phần tử <action> và mỗi ý định thực hiện được biểu thị dưới dạng phần tử <fulfillment>:

<actions>
    <action intentName="actions.intent.ORDER_MENU_ITEM">
        <fulfillment urlTemplate="exampleapp://browse{?food}">
            <parameter-mapping intentParameter="menuItem.name" urlParameter="food" />
        </fulfillment>
    </action>

    <action intentName="actions.intent.GET_THING">
        <fulfillment urlTemplate="exampleapp://search{?query}">
            <parameter-mapping intentParameter="thing.name" urlParameter="query"/>
        </fulfillment>
    </action>
</actions>

Đối với hầu hết các ý định tích hợp, bạn trích xuất tham số ý định từ truy vấn của người dùng dựa trên các thực thể schema.org. Sau đó, ứng dụng của bạn sẽ sử dụng các tham số ý định này để hướng người dùng đến chức năng mong muốn. Ví dụ: mã ở trên sẽ ánh xạ tham số ý định "thing.name" tới tham số URL "query" trong mẫu URL liên kết sâu.

Để biết các thông tin quan trọng về cách tạo tệp actions.xml, vui lòng tham khảo Tạo Actions.xml. Trang giản đồ cũng mô tả cách chỉ định giá trị tham số mà ứng dụng của bạn mong đợi (được gọi là khoảng không quảng cáo) và cách cập nhật tệp AndroidManifest.xml để tham chiếu tài nguyên actions.xml.

Xem trước Hành động trong ứng dụng

Bạn có thể sử dụng phiên bản nháp của ứng dụng để thử nghiệm. Để biết thêm thông tin, vui lòng xem bài viết Chuẩn bị và ra mắt bản phát hành. Bạn nên thử nghiệm ứng dụng của mình ở chế độ nháp trước khi gửi ứng dụng để xem xét đánh giá.

Trong quá trình phát triển và thử nghiệm, bạn phải sử dụng Công cụ kiểm tra Hành động trong ứng dụng để kiểm thử xem liệu nó có hoạt động được trong ứng dụng của bạn hay không. Công cụ kiểm tra Hành động trong ứng dụng là một trình bổ trợ của Android Studio giúp bạn xem trước Hành động trong ứng dụng của Trợ lý (dành cho Tài khoản Google của bạn). Sử dụng công cụ thử nghiệm, bạn có thể kiểm tra các lần thực hiện trên thiết bị thử nghiệm bằng cách cung cấp BII với tham số đầu vào mà bạn muốn nhận được từ người dùng.

Trong lúc xem trước Hành động trong ứng dụng, bạn cũng có thể kích hoạt các truy vấn bằng giọng nói trên chính thiết bị đó. Chức năng này chỉ áp dụng đối với những truy vấn được liệt kê trong tệp tham chiếu ý định tích hợp sẵn cho Hành động trong ứng dụng. Bạn chỉ nên sử dụng tính năng kích hoạt bằng giọng nói cho mục đích minh hoạ thay vì để thử nghiệm thông thường.

Yêu cầu xem xét và triển khai Hành động trong ứng dụng.

Người dùng chỉ có thể xem Hành động trong ứng dụng sau khi được xem xét và phê duyệt. Bài đánh giá Hành động trong ứng dụng không ảnh hưởng đến trạng thái xem xét và triển khai ứng dụng Android của bạn trong Google Play. Ngay cả khi ứng dụng bạn gửi được phê duyệt, actions.xml của bạn có thể vẫn đang được Google xem xét.

Sau khi bạn triển khai ứng dụng, Hành động trong ứng dụng sẽ vẫn được kích hoạt. Tuy nhiên, các phiên bản triển khai lại sẽ được Google xem xét. Nếu phiên bản mới không hoạt động đúng cách hoặc chứa các lỗi vi phạm chính sách, Google có quyền huỷ kích hoạt tính năng Hành động trong ứng dụng cho ứng dụng của bạn.

Để gửi tính năng Hành động trong ứng dụng cho việc xem xét, hãy làm như sau:

  1. Đáp ứng các yêu cầu về việc triển khai Hành động trong ứng dụng. Những yêu cầu này giúp tối ưu hoá ứng dụng của bạn cho Trợ lý và đảm bảo người dùng tận hưởng trải nghiệm liền mạch khi sử dụng Hành động trong ứng dụng.
  2. Chấp nhận Điều khoản dịch vụ của chương trình Actions on Google trong Google Play Console (Giá cả và phân phối > Sự đồng ý):

    Điều khoản dịch vụ của Actions on Google trong Google Play console.

  3. Tải ứng dụng của bạn (chứa actions.xml) lên Google Play Console như bình thường để phát hành.

  4. Sau khi bạn tải ứng dụng lên Play Console, chúng tôi sẽ liên hệ với bạn theo email trong Play Console để cung cấp thêm thông tin về trạng thái xem xét Hành động trong ứng dụng của bạn.