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

تتيح لك الإمكانات في 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 للنية. على سبيل المثال، يحتوي كل نموذج معلومات عن المستخدم في "إجراءات التطبيق" على حقول تمثّل المعلومات التي يقدّمها المستخدمون غالبًا في طلبات البحث التي تؤدي إلى تنشيط نموذج معلومات المستخدم.

يوضِّح المثال التالي تعريفًا للقدرة في 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>

في المثال السابق، تشير سمة <capability> android:name إلى رقم تعريف BII الخاص بالجهة START_EXERCISE. إذا طلب المستخدم من "مساعد Google" "‫Hey 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.

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