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

تتيح لك الإمكانات في 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. إذا استدعى المستخدم واجهة برمجة التطبيقات المضمّنة هذه من خلال سؤال "مساعد Google"، "مرحبًا Google، ابدأ الجري في ExampleApp،" يلبّي "مساعد Google" طلب المستخدِم باستخدام المعلومات المقدَّمة في العنصر intent المتداخل. يحدّد intent في هذا المثال التفاصيل التالية:

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

ربط الاختصارات بإمكانية

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