Thêm chức năng vào lối tắt

Các tính năng trong shortcuts.xml cho phép bạn khai báo các loại hành động mà người dùng có thể thực hiện thực hiện để khởi chạy ứng dụng và trực tiếp thực hiện một tác vụ cụ thể.

Ví dụ: Hành động trong ứng dụng của Trợ lý Google sử dụng các tính năng để cho phép nhà phát triển mở rộng các tính năng trong ứng dụng sang cả ý định tích hợp (BII) để người dùng có thể kích hoạt và kiểm soát các tính năng đó bằng lệnh thoại. Một chức năng bao gồm tên của hành động và intent nhắm mục tiêu đích đến trong ứng dụng của bạn mà phân giải ý định của người dùng.

Định nghĩa tính năng thực hiện tác vụ trong shortcuts.xml

Bạn định nghĩa các phần tử capability trong tệp tài nguyên shortcuts.xml trong dự án phát triển ứng dụng Android. Để xác định một phần tử capability, hãy làm như sau sau:

  1. Tạo tài nguyên shortcuts.xml bằng cách làm theo hướng dẫn trong phần Tạo lối tắt tĩnh.

  2. Hãy đưa những thông tin bắt buộc sau vào khả năng thực hiện:

    • Tên chức năng: hành động mà bạn muốn ứng dụng của mình hỗ trợ. Tham khảo tài liệu thành phần cho tính năng yêu cầu khả năng định nghĩa. Các lệnh hỗ trợ bằng giọng nói cho Hành động trong ứng dụng sẽ sử dụng BII Action ID để biết tên các chức năng mà bạn có thể tìm thấy trong tài liệu tham khảo về BII. Ví dụ: BII GET_THING liệt kê Action ID của nó là actions.intent.GET_THING.

    • Đích đến trong ứng dụng: đích đến trong ứng dụng mà hành động khởi chạy thực hiện yêu cầu của người dùng. Xác định các đích đến của ứng dụng bằng cách sử dụng phần tử intent được lồng trong capability.

    • Ánh xạ tham số: mỗi intent có thể chứa các tham số cần được truyền dưới dạng dữ liệu extra của ý định. Ví dụ: mỗi BII cho Hành động trong ứng dụng bao gồm các trường đại diện cho thông tin mà người dùng thường cung cấp trong các truy vấn kích hoạt BII.

Ví dụ sau đây minh hoạ định nghĩa về chức năng trong shortcuts.xml cho actions.intent.START_EXERCISE, một BII cho phép người dùng sử dụng tính năng nói dùng Trợ lý để bắt đầu bài tập thể dục trong ứng dụng thể dục:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <capability android:name="actions.intent.START_EXERCISE">
    <intent
      android:action="android.intent.action.VIEW"
      android:targetPackage="com.example.sampleApp"
      android:targetClass="com.example.sampleApp.ExerciseActivity">
      <parameter
        android:name="exercise.name"
        android:key="exerciseType"/>
    </intent>
  </capability>
</shortcuts>

Trong ví dụ trước, thuộc tính <capability> android:name đề cập đến BII START_EXERCISE. Nếu người dùng gọi BII này bằng cách hỏi Trợ lý Google, "Ok Google, bắt đầu bài tập chạy trong ExampleApp", Trợ lý sẽ thực hiện yêu cầu của người dùng bằng cách sử dụng thông tin được cung cấp trong phần tử intent lồng. intent trong mẫu này định nghĩa các thông tin chi tiết sau:

  • android:targetPackage thiết lập gói ứng dụng mục tiêu cho ý định này.
  • Trường android:targetClass chỉ định hoạt động tại đích đến: com.example.sampleApp.ExerciseActivity.
  • Ý định parameter khai báo khả năng hỗ trợ một tham số BII exercise.name và cách chuyển giá trị thông số – đã thu thập được từ người dùng—dưới dạng dữ liệu bổ sung trong intent.

Liên kết lối tắt với một tính năng thực hiện tác vụ

Sau khi xác định chức năng, bạn có thể mở rộng chức năng đó bằng cách liên kết lối tắt tĩnh hoặc động với nó. Cách liên kết các lối tắt với một capability phụ thuộc vào tính năng đang được triển khai và các từ thực tế có trong yêu cầu của người dùng. Ví dụ: khi một người dùng bắt đầu chạy trong quá trình theo dõi hoạt động thể dục của bạn bằng cách hỏi Trợ lý, "Ok Google, hãy bắt đầu chạy bộ trong ExampleApp." Trợ lý Google có thể sử dụng lối tắt để khởi chạy một phiên bản của capability xác định một giá trị hợp lệ thực thể bài tập "chạy" cho tham số exercise.name.

Để biết thêm thông tin về cách liên kết lối tắt với Hành động trong ứng dụng, hãy xem bài viết Ứng dụng Tổng quan về thao tác.