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

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

على سبيل المثال، تستخدِم "إجراءات التطبيقات" في "مساعد Google" إمكانات للسماح للمطوّرين بتوسيع نطاق الميزات داخل التطبيق لتشمل المقصودات المضمّنة (BIIs)، ما يتيح للمستخدمين تفعيل تلك الميزات والتحكّم فيها باستخدام الطلبات الصوتية. تتألف الإمكانية من اسم الإجراء و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، وهو واجهة مستخدم تفاعلية تتيح للمستخدمين استخدام تعليمات ملفتة باستخدام "مساعد 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>

في المثال السابق، تشير السمة android:name <capability> إلى وSTART_EXERCISE BII. إذا استدعى أحد المستخدمين BII من خلال توجيه طلب إلى "مساعد Google" قائلاً "مرحبًا 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 الذي يحدّد قيمة تمرين كيان "run" للمعلمة exercise.name.

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