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