تتيح خدمة "مهامّ في التطبيقات" للمستخدمين التحدّث إلى "مساعد Google" والانتقال مباشرةً إلى مهام محدّدة وجهات التطبيقات عندما يقولون مثلاً: "Ok Google، أريد طلب رحلة مني مثال للتطبيق" ومن خلال استدعاء التطبيقات التي تعمل في المقدّمة، يمكنك إجراء المزيد من التحسينات على المستخدم عندما يكون المستخدم تطبيقك مفتوحًا بالفعل.
يتيح استدعاء التطبيق الذي يتم تنفيذه في المقدمة مطابقة عناصر intent المضمَّنة (BII) بدون طلب ذكر اسم التطبيق أثناء وجود نشاط معين في مقدّمة الجهاز
فعلى سبيل المثال، يضع أحد المستخدمين تطبيق مشاركة الرحلات في المقدمة ويكتب أو يقول: "أريد طلب رحلة إلى ماونتن فيو" إلى "مساعد Google" يستخدم تطبيقك هذه البيانات. لضبط حقل الوجهة على Mountain View. بعد ذلك، عندما يقول المستخدم أو "طلب سيارة أجرة من مطار القاهرة الدولي"، يمكن لتطبيقك تحديد موقعك الجغرافي مع الحفاظ على حالة تطبيقك.
القيود
لا يتوفّر استدعاء التطبيقات التي تعمل في المقدّمة إلا لمعرّفات BII التالية:
actions.intent.CREATE_MONEY_TRANSFER
actions.intent.CREATE_TAXI_RESERVATION
actions.intent.OPEN_APP_FEATURE
actions.intent.ORDER_MENU_ITEM
actions.intent.PAUSE_EXERCISE
actions.intent.RECORD_EXERCISE
actions.intent.RECORD_FOOD_OBSERVATION
actions.intent.RESUME_EXERCISE
actions.intent.START_EXERCISE
actions.intent.STOP_EXERCISE
للحصول على دعم اللغة وأمثلة على طلبات البحث ذات الصلة باستدعاء التطبيق الذي تعمل في المقدّمة بالنسبة إلى نموذج BII محدّدًا، يمكنك الاطّلاع على مرجع الغرض المضمّن.
دعم استدعاء التطبيقات التي تعمل في المقدّمة
تتضمّن إضافة دعم لاستدعاء التطبيقات التي تعمل في المقدّمة إضافة عملية التنفيذ. استنادًا إلى النشاط المطلوب في المقدّمة. عندما يكون هذا النشاط في في المقدّمة ويتم استدعاء إجراء التطبيق، ينفّذ "مساعد Google" هدف الرابط لصفحة في التطبيق. مع إضافة علامة إضافية إلى ذلك النشاط ليتمكّن تطبيقك من تعديل حالته.
لتنفيذ استدعاء التطبيقات التي تعمل في المقدّمة ضِمن BII، عليك اتّباع الخطوات التالية:
- في ملف
shortcuts.xml
، أضِف علامة<intent>
إلى العنصر BII.<capability>
تريد إتاحة استدعاء التطبيقات التي تعمل في المقدّمة. - ضمن العلامة
<intent>
، أضِف علامة<extra>
. - في العلامة
<extra>
، اضبط السمةandroid:key
على"requiredForegroundActivity"
. واضبطandroid:value
على النشاط الذي تريد أن تكون في المقدّمة. تحديد النشاط بدون أي صف الاختصارات، باستخدام اسم حزمة التطبيق، متبوعة بشرطة مائلة للأمام (/)، متبوعًا باسم النشاط:APP_PACKAGE_NAME/ACTIVITY_NAME
- في النشاط الذي تعمل في المقدّمة التي حدّدتها لـ "
"requiredForegroundActivity"
"، تنفيذ طريقةonNewIntent()
للتعامل مع نية الربط لصفحة في التطبيق باستخدام مجموعة علاماتSINGLE_TOP
. ينفّذ "مساعد Google" هدف الربط بصفحة معيّنة باستخدام هذه العلامة باعتبارها عملية تنفيذ عندما يكون النشاط المحدّد في المقدّمة. - التعامل مع المكالمات الواردة إلى "
onNewIntent()
" على أنّها تحديثات لنشاطك الذي تعمل في المقدّمة إدارة الحالة في هذا النشاط باستخدام المَعلمات المستخرَجة من الرابط لصفحة في التطبيق.
إذا كان تطبيقك يستخدم نشاطًا خاصًا بجهاز التوجيه للسماح لجميع الروابط الخارجية لصفحات في التطبيق بتشغيل نشاط موجه واحد لحماية البيانات، راجع التعامل مع أنشطة جهاز التوجيه
مثال
يعرض المقتطف التالي من مثال على ملف shortcuts.xml
كيفية إضافة السمة
السمة requiredForegroundActivity
:
<capability name="actions.intent.CREATE_TAXI_RESERVATION"> <!-- Trigger with foreground app invocation if MainActivity is in the foreground. --> <intent android:targetClass="com.example.app.MainActivity" android:targetPackage="com.example.app"> <parameter android:name="taxiReservation.dropoffLocation.name" android:key="dropoff" /> <extra android:key="requiredForegroundActivity" android:value="com.example.app/com.example.app.MainActivity" /> </intent> <!-- This won't trigger if MainActivity is in the foreground. --> <intent android:targetClass="com.example.app.MainActivity" android:targetPackage="com.example.app"> <parameter android:name="taxiReservation.dropoffLocation.name" android:key="dropoff" /> </intent> </capability>
أذونات المستخدمين
![في إعدادات الجهاز، على المستخدمين تفعيل خيار "استخدام النص من الشاشة".
لكي يعمل استدعاء التطبيق الذي يعمل في المقدّمة.](https://developer.android.google.cn/static/guide/app-actions/images/device-setting-assist-screen.png?authuser=19&hl=ar)
لكي يعمل استدعاء التطبيقات التي تعمل في المقدّمة لدى المستخدم، يجب أن يكون لدى المستخدم: تم تفعيل إعداد استخدام النص من الشاشة على الجهاز. الموقع الجغرافي والاسم بدقة قد يختلف هذا الإعداد حسب المصنّع الأصلي للجهاز أو الشركة المصنّعة للجهاز. على سبيل المثال، بدلاً من ذلك، قد يُطلق على إعداد الجهاز اسم استخدام سياق الشاشة على حساب الخاص بك.
للوصول إلى إعداد Android هذا على هاتف Pixel، انتقِل أولاً إلى الإعدادات > التطبيقات الإشعارات > التطبيقات التلقائية > تطبيق المساعد. بعد ذلك، من خلال زر المساعدة والصوت إدخال، فعِّل الخيار استخدام النص من الشاشة.
اختبار الاستدعاء
لتجربة استدعاء التطبيق الذي يعمل في المقدّمة، يُرجى اتّباع الخطوات التالية:
- اتّبِع التعليمات الواردة في قسم أذونات المستخدم لتفعيل إعداد الجهاز استخدام النص من الشاشة
- افتح تطبيقك للوصول إلى النشاط الذي أدرجته على أنّه النشاط المطلوب في المقدّمة.
- اضغط على & اضغط مع الاستمرار على زر الشاشة الرئيسية لفتح "مساعد Google" على سطح الصفحة الحالية التطبيق. تقديم استعلام يتوافق مع BII الذي نفذته بدون ذكر اسم التطبيق نفسه عند اكتمال هذه العملية، يتم تحديث تطبيقك. نفسه بناءً على طلب البحث مع الحفاظ على الحالة ودون إعادة التشغيل النشاط.
التعامل مع أنشطة جهاز التوجيه
تتعامل بعض التطبيقات مع جميع الروابط الخارجية لصفحات في التطبيق باستخدام جهاز توجيه واحد لمراقبة البوابة. الأخرى. يبدأ نشاط جهاز التوجيه بعد ذلك منطق الأعمال المناسب النشاط (بعد أي فحوصات وعمليات تحقق) ويعرض منطق الأعمال نشاط في المقدمة.
حيث يمكن أن يؤدي تشغيل رابط لصفحة في التطبيق إلى إضافة نشاط الموجه إلى أعلى حزمة المهام، فوق نشاط المقدمة. للتطبيقات التي تستخدم جهاز توجيه يجب التأكد من أن نشاط الموجه يقدم الهدف المرسل بواسطة "مساعد Google" على مثيل النشاط الحالي في المقدّمة. كيفية تحقيقك يتغير هذا الشرط حسب مكان بدء نشاط جهاز التوجيه.
إذا بدأ جهاز التوجيه في نفس حزمة المهام مثل نشاط منطق أعمالك،
إعادة توجيه الغرض باستخدام أمر OR بالبت لـ SINGLE_TOP
، CLEAR_TOP
،
وNEW_TASK
:
Kotlin
Intent.FLAG_ACTIVITY_SINGLE_TOP or Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_NEW_TASK
Java
Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK
إذا بدأ جهاز التوجيه في حزمة مهام منفصلة عن منطق مؤسستك
النشاط، يُرجى إعادة توجيه النية باستخدام علامة SINGLE_TOP
إلى النشاط التجاري.
والنشاط المنطقي بدلاً من ذلك.