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

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

يدرج "مساعد Google" صورة محدّدة في رسالة عندما يُطلب منه ذلك.
الشكل 1. يشارك "مساعد 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()
}
      
Java
@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".