إضافة إمكانات إلى الاختصارات

تتيح لك الإمكانات في shortcuts.xml تحديد أنواع الإجراءات التي يمكن للمستخدمين اتّخاذها لتشغيل تطبيقك وتنفيذ مهمة معيّنة مباشرةً.

على سبيل المثال، تستخدم "إجراءات التطبيقات" في "مساعد Google" إمكانات تتيح للمطوّرين توسيع ميزات التطبيق لتشمل الأهداف المضمّنة، ما يتيح للمستخدمين تفعيل هذه الميزات والتحكّم فيها باستخدام الطلبات الصوتية. تتألف إحدى الإمكانات من اسم الإجراء وintent يستهدف الوجهة في تطبيقك التي تحقّق غرض المستخدم.

تحديد الإمكانات في ملف shortcuts.xml

يمكنك تحديد عناصر capability في ملف موارد shortcuts.xml في مشروع تطوير تطبيق Android. لتحديد عنصر capability، اتّبِع الخطوات التالية:

1. أنشئ shortcuts.xml موردًا باتّباع التعليمات الواردة في إنشاء اختصارات ثابتة.

2. يجب تضمين المعلومات المطلوبة التالية في قدرتك:

   • اسم الإمكانية: الإجراء الذي تريد أن يتيحه تطبيقك. راجِع مستندات المكوّن للحصول على الميزة التي تتطلّب تعريفات القدرات. تستخدم الأوامر المفعّلة صوتيًا في "إجراءات التطبيقات" واجهة BII Action ID لأسماء الإمكانات، ويمكنك العثور عليها في مرجع واجهة BII. على سبيل المثال، تدرج GET_THING BII Action ID على النحو actions.intent.GET_THING.

   • وجهة التطبيق: هي الوجهة في تطبيقك التي يتم تشغيل الإجراء فيها لتلبية طلب المستخدم. تحديد وجهات التطبيق باستخدام عناصر intent المضمّنة في capability

   • عمليات ربط المَعلمات: قد يحتوي كل intent على مَعلمات سيتم تمريرها كبيانات extra للغرض. على سبيل المثال، يتضمّن كل معرّف BII خاص بـ "إجراءات التطبيقات" حقولاً تمثّل المعلومات التي يقدّمها المستخدمون غالبًا في طلبات البحث التي تؤدي إلى تشغيل معرّف BII.

يوضّح المثال التالي تعريف إحدى الإمكانات في shortcuts.xml لـ actions.intent.START_EXERCISE، وهي واجهة BII تتيح للمستخدمين استخدام الأوامر الصوتية مع "مساعد Google" لبدء تمرين في تطبيق لياقة بدنية:

<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>

في المثال السابق، تشير السمة <capability> android:name إلى START_EXERCISE BII. إذا استدعى المستخدم هذه المعلومات الحساسة المحددة للهوية الشخصية من خلال سؤال "مساعد Google"، "Ok Google، ابدأ الركض في ExampleApp"، سينفّذ "مساعد Google" طلب المستخدم باستخدام المعلومات المقدَّمة في العنصر المتداخل intent. تحدّد intent في هذا النموذج التفاصيل التالية:

• يحدّد android:targetPackage حزمة التطبيق المستهدَفة لهذا الغرض.
• يحدّد الحقل android:targetClass النشاط الوجهة: com.example.sampleApp.ExerciseActivity.
• يُعلن الغرض parameter عن إتاحة مَعلمة BII exercise.name وكيفية تمرير قيمة المَعلمة التي تم جمعها من المستخدِم كبيانات إضافية في intent.

ربط الاختصارات بإحدى الإمكانات

بعد تحديد إحدى الإمكانات، يمكنك توسيع وظائفها من خلال ربط اختصارات ثابتة أو ديناميكية بها. تعتمد طريقة ربط الاختصارات بـ capability على الميزة التي يتم تنفيذها والكلمات الفعلية المضمّنة في طلب المستخدم. على سبيل المثال، عندما يبدأ مستخدم الركض في تطبيقك لتتبُّع اللياقة البدنية من خلال طلب من "مساعد Google"، "Ok Google، ابدأ الركض في ExampleApp" يمكن أن يستخدم "مساعد Google" اختصارًا لتشغيل مثيل من capability يحدّد كيان تمرين صالحًا من النوع "ركض" للمعلمة exercise.name.

لمزيد من المعلومات حول ربط الاختصارات بـ "مهام في التطبيقات"، يُرجى الاطّلاع على نظرة عامة حول "مهام في التطبيقات".