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

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

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

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

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

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

2. يُرجى تضمين المعلومات المطلوبة التالية في إمكانية العرض:

   • اسم القدرة: الإجراء الذي تريد أن يتيحه تطبيقك. ارجع إلى وثائق المكون للميزة التي تتطلب تعريفات للقدرات. تستخدم الطلبات الصوتية في "إجراءات التطبيقات" سطر Action ID لأسماء الإمكانات، والذي يمكنك العثور عليه في مرجع BII. على سبيل المثال، تُدرِج مبادرة BII GET_THING القيمة 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. إذا استدعى المستخدم هذا التلميح من خلال توجيه طلب إلى "مساعد 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.

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