المشاركة مع "مساعد Google"

يمكن لمستخدمي هواتف Android توجيه طلب إلى "مساعد Google" لمشاركة محتوى التطبيق مع مستخدم آخر من خلال طلب صوتي، مثل "Ok Google، أريد إرسال هذا المحتوى إلى هبة". بناءً على خيارات النظام لدى المستخدم الأول، بإمكان "مساعد Google" بعد ذلك دمج نص من الشاشة أو لقطة شاشة للجهاز في المحتوى المشترَك.

غالبًا ما تكون طريقة المشاركة هذه كافية، ولكن قد لا يتمكّن المستخدمون الذين يتلقّون محتوى تمت مشاركته من تطبيقك من إعادة الدخول إلى التطبيق لعرض المحتوى. يمكنك تزويد "مساعد Google" بمعلومات منظَّمة عن المحتوى الحالي الذي يظهر في المقدّمة من خلال تنفيذ طريقة onProvideAssistContent().

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

نفِّذ onProvideAssistContent() لأي قيمة قابلة للمشاركة entity في تطبيقك.

تقديم المحتوى إلى "مساعد Google"

ما عليك سوى تنفيذ onProvideAssistContent() للنشاط النهائي على التطبيق في مسار مهمة المستخدم بعد استدعاء إجراء التطبيق. على سبيل المثال، في مسار CREATE_MONEY_TRANSFER، نفِّذ الطريقة في الشاشة النهائية التي تعرض الإيصال، ولن تحتاج إلى تنفيذها على أي شاشات قيد التقدم أو للمعاينة.

وقدِّم معلومات سياقية على شكل كائن JSON-LD باستخدام مفردات schema.org في الحقل structuredData في AssistContent. يوضح مقتطف الرمز التالي مثالاً لتسجيل المحتوى السياقي:

override fun onProvideAssistContent(outContent: AssistContent) {
    super.onProvideAssistContent(outContent)

    // JSON-LD object based on Schema.org structured data
    outContent.structuredData = JSONObject()
            .put("@type", "MenuItem")
            .put("name", "Blueberry Crisp Iced Signature Latte")
            .put("url", "https://mysite.com/menuitems/12345a")
            .toString()
}
      

@Override
public void onProvideAssistContent(AssistContent outContent) {
  super.onProvideAssistContent(outContent);

  // JSON-LD object based on Schema.org structured data
  outContent.structuredData = new JSONObject()
          .put("@type", "MenuItem")
          .put("name", "Blueberry Crisp Iced Signature Latte")
          .put("url", "https://mysite.com/menuitems/12345a")
          .toString();
}
      

قدِّم أكبر قدر ممكن من البيانات عن كل entity. الحقول التالية مطلوبة:

• @type
• .name
• .url (مطلوبة فقط إذا كان المحتوى قابلاً لعنوان URL)

للحصول على مزيد من المعلومات حول استخدام onProvideAssistContent()، راجِع دليل تحسين المحتوى السياقي في "مساعد Google".