تتيح لك الإمكانات في shortcuts.xml
توضيح أنواع الإجراءات التي يمكن للمستخدمين
اتخاذها لإطلاق تطبيقك وتنفيذ مهمة محدّدة مباشرةً.
على سبيل المثال، تستخدم "المهام في التطبيقات" في "مساعد Google" إمكانيات للسماح للمطوّرين بتوسيع نطاق الميزات داخل التطبيق إلى أهداف مضمَّنة (BII)، ما يتيح للمستخدمين تفعيل هذه الميزات والتحكّم فيها باستخدام الطلبات الصوتية. وتتألف الميزة من اسم الإجراء وintent
يستهدف الوجهة في تطبيقك لحل هدف المستخدم.
تحديد الإمكانات في ملف shortcuts.xml
يمكنك تحديد عناصر capability
في ملف مورد shortcuts.xml
في
مشروع تطوير تطبيق Android الخاص بك. لتحديد عنصر capability
، اتّبِع الخطوات التالية:
- أنشِئ موردًا
shortcuts.xml
باتّباع التعليمات الواردة في إنشاء اختصارات ثابتة. يُرجى تضمين المعلومات المطلوبة التالية في إمكانية العرض:
اسم القدرة: الإجراء الذي تريد أن يتيحه تطبيقك. ارجع إلى وثائق المكون للميزة التي تتطلب تعريفات للقدرات. تستخدم الطلبات الصوتية في "إجراءات التطبيقات" سطر
Action ID
لأسماء الإمكانات، والذي يمكنك العثور عليه في مرجع BII. على سبيل المثال، تُدرِج مبادرة BIIGET_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
إلى إتاحة مَعلمة BIIexercise.name
وكيفية تمرير قيمة المَعلمة، التي يتم جمعها من المستخدم، كبيانات إضافية فيintent
.
ربط الاختصارات بإحدى الإمكانيات
بمجرد تعريف إحدى الميزات، يمكنك توسيع وظائفها عن طريق ربط الاختصارات
الثابتة أو الديناميكية بها. إنّ طريقة ربط الاختصارات بـ capability
تعتمد على الميزة التي يتم تنفيذها والكلمات الفعلية المضمّنة في طلب المستخدم. على سبيل المثال، عندما يبدأ المستخدم الجري في تطبيق تتبُّع اللياقة البدنية
من خلال توجيه الطلب إلى "مساعد Google": "Ok Google، أريد بدء عملية في ExampleApp". يمكن أن يستخدم "مساعد Google" اختصارًا لتشغيل مثيل capability
يحدّد كيانًا صالحًا للتمرين "تشغيل" للمعلَمة exercise.name
.
لمزيد من المعلومات عن ربط الاختصارات بـ "إجراءات التطبيقات"، يُرجى الاطّلاع على نظرة عامة على إجراءات التطبيقات.