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

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

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

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

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

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

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

قدِّم المعلومات السياقية كعنصر 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"