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

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

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

تحديد الإمكانات في Short.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، وهي عبارة عن 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>

في المثال السابق، تشير السمة 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.

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