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

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

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

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

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

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

   • اسم الإمكانية: الإجراء الذي تريد أن يتيحه تطبيقك. راجِع مستندات المكوّن للحصول على الميزة التي تتطلّب تعريفات القدرات.

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

   • عمليات ربط المَعلمات: قد يحتوي كل intent على مَعلمات سيتم تمريرها كبيانات extra للغرض.

يوضّح المثال التالي تعريف إحدى الإمكانات في 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. إذا استدعى المستخدم هذه المعلومات الحساسة المحددة للهوية (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.