استدعاء التطبيق في المقدّمة

تتيح خدمة "مهامّ في التطبيقات" للمستخدمين التحدّث إلى "مساعد 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" بعد إنشاء معاينة لتطبيقك.

دعم استدعاء التطبيقات التي تعمل في المقدّمة

تتضمّن إضافة دعم لاستدعاء التطبيقات التي تعمل في المقدّمة إضافة عملية التنفيذ. استنادًا إلى النشاط المطلوب في المقدّمة. عندما يكون هذا النشاط في في المقدّمة ويتم استدعاء إجراء التطبيق، ينفّذ "مساعد Google" هدف الرابط لصفحة في التطبيق. مع إضافة علامة إضافية إلى ذلك النشاط ليتمكّن تطبيقك من تعديل حالته.

ملاحظة: عند استخدام الأجزاء كوجهات في تطبيقك، عليك توضيح الغرض. المعلومات إلى الجزء المعنيّ.

لتنفيذ استدعاء التطبيقات التي تعمل في المقدّمة ضِمن BII، عليك اتّباع الخطوات التالية:

1. في ملف shortcuts.xml، أضِف علامة <intent> إلى العنصر BII. <capability> تريد إتاحة استدعاء التطبيقات التي تعمل في المقدّمة.
2. ضمن العلامة <intent>، أضِف علامة <extra>.
3. في العلامة <extra>، اضبط السمة android:key على "requiredForegroundActivity". واضبط android:value على النشاط الذي تريد أن تكون في المقدّمة. تحديد النشاط بدون أي صف الاختصارات، باستخدام اسم حزمة التطبيق، متبوعة بشرطة مائلة للأمام (/)، متبوعًا باسم النشاط: APP_PACKAGE_NAME/ACTIVITY_NAME
4. في النشاط الذي تعمل في المقدّمة التي حدّدتها لـ ""requiredForegroundActivity""، تنفيذ طريقة onNewIntent() للتعامل مع نية الربط لصفحة في التطبيق باستخدام مجموعة علامات SINGLE_TOP. ينفّذ "مساعد Google" هدف الربط بصفحة معيّنة باستخدام هذه العلامة باعتبارها عملية تنفيذ عندما يكون النشاط المحدّد في المقدّمة.
5. التعامل مع المكالمات الواردة إلى "onNewIntent()" على أنّها تحديثات لنشاطك الذي تعمل في المقدّمة إدارة الحالة في هذا النشاط باستخدام المَعلمات المستخرَجة من الرابط لصفحة في التطبيق.

ملاحظة: تحلّ الأهداف من أعلى إلى أسفل، لذا ضَع الأهداف مع إدراج نشاط في المقدّمة فوق الأهداف الأخرى في <capability> لمنحهم الأولوية.

إذا كان تطبيقك يستخدم نشاطًا خاصًا بجهاز التوجيه للسماح لجميع الروابط الخارجية لصفحات في التطبيق بتشغيل نشاط موجه واحد لحماية البيانات، راجع التعامل مع أنشطة جهاز التوجيه

مثال

يعرض المقتطف التالي من مثال على ملف 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>

أذونات المستخدمين

لكي يعمل استدعاء التطبيقات التي تعمل في المقدّمة لدى المستخدم، يجب أن يكون لدى المستخدم: تم تفعيل إعداد استخدام النص من الشاشة على الجهاز. الموقع الجغرافي والاسم بدقة قد يختلف هذا الإعداد حسب المصنّع الأصلي للجهاز أو الشركة المصنّعة للجهاز. على سبيل المثال، بدلاً من ذلك، قد يُطلق على إعداد الجهاز اسم استخدام سياق الشاشة على حساب الخاص بك.

للوصول إلى إعداد Android هذا على هاتف Pixel، انتقِل أولاً إلى الإعدادات > التطبيقات الإشعارات > التطبيقات التلقائية > تطبيق المساعد. بعد ذلك، من خلال زر المساعدة والصوت إدخال، فعِّل الخيار استخدام النص من الشاشة.

اختبار الاستدعاء

لتجربة استدعاء التطبيق الذي يعمل في المقدّمة، يُرجى اتّباع الخطوات التالية:

1. اتّبِع التعليمات الواردة في قسم أذونات المستخدم لتفعيل إعداد الجهاز استخدام النص من الشاشة
2. افتح تطبيقك للوصول إلى النشاط الذي أدرجته على أنّه النشاط المطلوب في المقدّمة.
3. اضغط على & اضغط مع الاستمرار على زر الشاشة الرئيسية لفتح "مساعد 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 إلى النشاط التجاري. والنشاط المنطقي بدلاً من ذلك.