الأسئلة الشائعة حول حزمة تطوير البرامج (SDK)

نشر الأسئلة الشائعة

مَن يدير مهمة نشر المحتوى؟

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

هل على المطوّر نشر جميع أنواع المجموعات؟

مع أنّ المطوّرين أحرار من الناحية الفنية في نشر مجموعة واحدة فقط، ننصح بشدة بتضمين المزيد. وإلا، سيفوّت المطوّرون فرصة تحقيق تفاعل أفضل مع محتواهم. ننصح بشدة بنشر جميع أنواع المجموعات لكل مجال.

كم مرة يجب أن ينشر شريك المطوّر البيانات باستخدام Work Manager أثناء تشغيل التطبيق؟

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

متى على المطوّر استدعاء واجهات برمجة التطبيقات الخاصة بالحذف؟

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

الأسئلة الشائعة حول Broadcast Intent

لماذا على مطوّري تطبيقات Android التسجيل لاستخدام أغراض البث؟

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

يتعذّر اختبار مكوّن البث

لا يتيح تطبيق التحقّق اختبار نية البث مع إذن. عليك إزالة الأذونات أثناء الاختبار وإعادة إضافتها قبل تبديل حزمة SDK إلى إصدار الإنتاج في الخطوة 6.

غير مسموح بالتنفيذ في الخلفية

أثناء تسجيل نية البث، قد يظهر لك الخطأ التالي:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

يجب تسجيل مستقبلات البث بشكل ديناميكي.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION,
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null));
...

}

الأسئلة الشائعة حول سير العمل

أثناء الدمج مع حزمة SDK، قد تواجه الأخطاء التالية:

أخطاء التحقّق من الصحة على مستوى التطبيق والمجموعة والعنصر

تعرض الملخّصات على مستوى التطبيق والمجموعة والكيان عدد أخطاء التحقّق من الصحة. تتطابق هذه الأخطاء مع الحقول المطلوبة غير المتوفّرة أو القيم غير الصالحة المقدَّمة. تظهر رسائل الخطأ باللون الأحمر أسفل كل حقل ذي صلة. يجب حلّ جميع أخطاء التحقّق والتأكّد من صحة ملف APK قبل مشاركته.

ترتبط الروابط لصفحات معيّنة باسم الحزمة. من الطرق الجيدة لاختبار الروابط لصفحات في التطبيق استخدام أداة adb.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

تُعدّ الروابط لصفحات في التطبيق طريقة رائعة لتتبُّع تحديد المصدر. يمكن تضمين عناوين URL للروابط المؤدية إلى صفحات معيّنة التي تنقل المستخدمين إلى تطبيقك مع مَعلمات تتبُّع إضافية. على سبيل المثال: "http://xx/deeplink?source_tag=engage".

يمكن للمطوّرين إضافة مَعلمات التتبُّع الخاصة بهم وتقديم تحديد المصدر لاحتساب التأثير.

الأسئلة الشائعة حول Engage for TV 2.0

أسئلة عامة

ما هي ميزة "مواصلة المشاهدة 2.0"؟

تأخذ ميزة "مواصلة المشاهدة 2.0" (Video Discovery API) تجربة "مواصلة المشاهدة من حيث توقفت" إلى مستوى جديد. هذه ترقية مهمة تتيح للمشاهدين استئناف المحتوى بسهولة على مجموعة أكبر من الأجهزة. تخيَّل أن تبدأ مشاهدة فيلم على Google TV ثم تواصل مشاهدته بسهولة على هاتفك أثناء تنقّلك. هذه هي الميزة الجديدة "متابعة المشاهدة 2.0".

تم تصميم هذا النظام الجديد لتعزيز تفاعل المشاهدين والاحتفاظ بهم من خلال توفير تجربة سلسة وسهلة الاستخدام في جميع أنحاء منظومة Google المتكاملة.

ما هي مزايا استخدام ميزة "مواصلة المشاهدة 2.0"؟

الإجابة: يسهّل الإصدار 2.0 من ميزة "مواصلة المشاهدة" على المشاهدين استئناف مشاهدة المحتوى من حيث توقّفوا، بغض النظر عن الجهاز الذي يستخدمونه. إليك طريقة عملها:

  • تجربة سلسة على جميع خدمات Google: يمكنك بدء المشاهدة على Google TV ومتابعتها بسلاسة على هاتف Android أو iPhone أو جهاز Android اللوحي. ويمكنك استخدامها حتى على الأجهزة التي لم تثبِّت عليها التطبيق بعد.
  • زيادة التفاعل والاحتفاظ بالمستخدمين: تساعد ميزة "مواصلة المشاهدة 2.0" في إعادة المستخدمين إلى تطبيقك، حتى على الأجهزة الجديدة. من خلال السماح للمستخدمين باستئناف مشاهدة برامجهم المفضّلة، تزيد فرص مواصلتهم المشاهدة.
  • مدى وصول أوسع: بالإضافة إلى Google TV، تعمل ميزة "مواصلة المشاهدة 2.0" على تجارب وسائط Android الأخرى، مثل Play Cubes وتطبيقات وسائط Google الأخرى.
  • متوافق مع الإصدارات السابقة: إذا كنت تستخدم ميزة "المشاهدة تاليًا" القديمة، لا مشكلة في ذلك. يتوافق الإصدار 2.0 من ميزة "مواصلة المشاهدة" مع الإصدارات القديمة، لذا سيستمر عمل عملية الدمج الحالية.

ملاحظة مهمة: يجب أن تستخدم جميع عمليات الدمج الجديدة لميزة &quot;مواصلة المشاهدة&quot; الإصدار 2.0 من هذه الميزة. سيتم إيقاف نظام "تشغيل المحتوى التالي على أجهزة متعددة" القديم نهائيًا.

ما هي المساحات التي تتيح استخدام ميزة "مواصلة المشاهدة 2.0"؟

  1. Google TV
  2. ‫Android TV (على الجهاز فقط، ولكنّه يتوافق مع حزمة تطوير البرامج Engage SDK)
  3. تطبيق Google TV المتوافق مع أجهزة Android الجوّالة
  4. تطبيق Google TV المتوافق مع أجهزة iOS الجوّالة
  5. مكعبات Play
  6. مساحة الترفيه من Google
  7. أجهزة iOS (مع دمج واجهة برمجة تطبيقات REST)

هل حزمة Engage SDK متوافقة مع ميزة "مواصلة المشاهدة 2.0"؟

نعم، حزمة Engage SDK مخصّصة لميزة "مواصلة المشاهدة 2.0". يجب الدمج مع ميزة "مواصلة المشاهدة 2.0".

هل تتوفّر ميزة "مواصلة المشاهدة 2.0" للجميع؟

نعمل على طرح ميزة "مواصلة المشاهدة 2.0" على مراحل.

  • استخدام المنتج قبل إطلاقه: سنمنح في البداية مجموعة محدّدة من الشركاء إمكانية الوصول إلى المنتج من خلال برنامج استخدام المنتج قبل إطلاقه.
  • توسيع نطاق الوصول: نعمل جاهدين على إتاحة الإصدار 2.0 من ميزة "مواصلة المشاهدة" لجميع المطوّرين قريبًا.

لضمان إطلاق سلس وناجح، وضعنا تدابير وقائية لإدارة عملية الطرح. يتضمّن ذلك كلاً من قائمة السماح في الإصدار 2.0 من ميزة "مواصلة المشاهدة" وفحصًا منفصلاً ضمن حزمة تطوير البرامج Engage SDK. إذا كنت شريكًا في برنامج الاستخدام قبل الإطلاق أو تريد الانضمام قريبًا، يُرجى التواصل معنا لنتمكّن من إعداد أذونات الوصول قبل البدء في دمج حزمة تطوير البرامج (SDK) الخاصة بـ Engage.

تم تعديل المتطلبات المتعلّقة بالصور في قسم إنشاء الكيانات.

باستخدام مستندات واجهة برمجة التطبيقات الجديدة هذه، هل سيسترد خادم Google بيانات "مواصلة المشاهدة" من العميل وهل ستظهر على جميع الأجهزة؟

تقدّم واجهة برمجة التطبيقات الجديدة مزايا مهمة لميزة "مواصلة المشاهدة"، بما في ذلك:

  • تجربة سلسة على جميع أجهزة Google TV: يمكن للمستخدمين بدء المشاهدة على أحد أجهزة Google TV واستئنافها على أي جهاز Google TV آخر تم تسجيل الدخول إليه باستخدام الحساب نفسه. تعمل هذه الميزة أيضًا مع إصدارات Android TV القديمة.

  • التكامل مع التطبيق على الأجهزة الجوّالة: تتوفّر ميزة &quot;مواصلة المشاهدة&quot; في تطبيق Google TV للأجهزة الجوّالة على Android وiOS، ما يتيح للمستخدمين التبديل بسلاسة بين التلفزيون وأجهزتهم الجوّالة.

  • زيادة معدّل الاحتفاظ بالمستخدمين: حتى على الأجهزة التي لم يتم تثبيت التطبيق عليها أو التي لم يسجّل المستخدم الدخول إليها، تشجّع ميزة "مواصلة المشاهدة" المستخدمين على إعادة التفاعل مع تطبيقك، ما يؤدي إلى زيادة معدّل الاحتفاظ بالمستخدمين.

  • التوسّع إلى منصات أخرى: يتيح هذا التكامل استخدام ميزة "مواصلة المشاهدة" على منصات وسائط أخرى من Google، مثل أجهزة Android وPlay Cubes والأجهزة اللوحية وتطبيقات ومساحات عرض وسائط Google الأخرى على Android، ما يؤدي إلى زيادة تفاعل المستخدمين على جميع الأجهزة.

ما هو الحدّ الأقصى لعدد الكيانات التي يمكنني نشرها في مجموعة "المتابعة"؟

يقتصر عدد الكيانات المسموح بها لكل شريك مطوّر على 5 كيانات كحد أقصى في مجموعة Continuation. هذا الحدّ مخصّص للتوزيع العادل للمحتوى في صف "مواصلة المشاهدة" على Google TV، وهو مساحة مشتركة لعدة مقدّمي خدمات وسائط.

ماذا يحدث إذا حاولت نشر أكثر من 5 كيانات؟

سترفض EngageSDK طلب النشر إذا تجاوز الحدّ الأقصى البالغ 5 عناصر. عليك تقليل عدد العناصر في طلبك لنشره بنجاح. يجب تضمين الكيانات التي توقّف المستخدمون عن مشاهدتها فقط، لذا في معظم الحالات، لن يكون هناك سوى عدد قليل من هذه الكيانات. عندما يكون هناك أكثر من 5 من هذه الكيانات، يمكنك اختيار الأحدث منها لنشرها.

لماذا هناك حدّ أقصى لعدد الكيانات؟

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

أسئلة حول تطبيق التحقّق

هل من الضروري اختبار تطبيقي باستخدام تطبيق التحقّق قبل إرساله؟

نعم، من الضروري اختبار تطبيقك باستخدام تطبيق التحقّق قبل إرسال حزمة APK.

مع أنّنا ندرك أنّك قد تكون واثقًا من عملية التنفيذ، إلا أنّ عملية دمج ميزة &quot;مواصلة المشاهدة&quot; 2.0 تتضمّن العديد من المكوّنات المعقّدة. يعمل تطبيق التحقّق كشبكة أمان، إذ يرصد المشاكل المحتملة في وقت مبكر ويوفر عليك الوقت والجهد على المدى الطويل.

يمكنك اعتبارها فحصًا سريعًا يساعد في ضمان إطلاق سلس وتجربة رائعة للمستخدمين.

ومن خلال تحديد أي مشاكل ومعالجتها مسبقًا، يمكنك تجنُّب الإحباط الناتج عن عمليات الرفض وإعادة الإرسال.

لإرسال حزمة APK، عليك تضمين لقطة شاشة توضّح أنّ تطبيقك قد اجتاز عملية التحقّق.

ما هي بعض الأخطاء الشائعة التي يجب الانتباه إليها أثناء عملية الدمج؟

تم تصميم تطبيق التحقّق لرصد المشاكل المحتملة في عملية دمج ميزة "مواصلة المشاهدة 2.0". في ما يلي بعض الأخطاء الشائعة التي يواجهها المطوّرون غالبًا:

بالنسبة إلى كل أنواع المحتوى (الأفلام والحلقات التلفزيونية وأحداث البث المباشر ومقاطع الفيديو):

  • الروابط غير المتوفّرة: تأكَّد من توفير معرّفات موارد منتظمة (URI) صالحة خاصة بكل منصة (روابط) للمحتوى. وتخبر هذه الروابط النظام بمكان العثور على المحتوى الخاص بك على كل منصة.
  • العناوين غير المتوفّرة: لا تنسَ تضمين عناوين لجميع المحتوى. يساعد ذلك المستخدمين في تحديد المحتوى الذي كانوا يشاهدونه.
  • نِسب العرض إلى الارتفاع للصور: تأكَّد من أنّ جميع الصور المرتبطة بالمحتوى الخاص بك تتضمّن نسبة عرض إلى ارتفاع قريبة من 16:9. يضمن ذلك عرض صورك بشكل صحيح على الشاشات المختلفة.

بالنسبة إلى الحلقات التلفزيونية:

  • معلومات الحلقة الكاملة: احرص على تضمين عنوان البرنامج ورقم الحلقة ورقم الموسم. يساعد ذلك في تنظيم الحلقات ويتيح للمستخدمين التنقّل داخل مسلسل.
  • موضع التشغيل الدقيق: تأكَّد من أنّ موضع التشغيل الأخير أقل من أو يساوي المدة الإجمالية للحلقة. ويضمن ذلك أن يستأنف المستخدمون من الموضع الصحيح.

بالنسبة إلى الأفلام:

  • موضع التشغيل الدقيق: كما هو الحال مع حلقات البرامج التلفزيونية، تحقَّق من دقة موضع التشغيل الأخير.

بالنسبة إلى فيديوهات البث المباشر:

  • معلومات المذيع: يجب تضمين اسم المذيع في أحداث البث المباشر.

بالنسبة إلى مقاطع الفيديو:

  • معلومات صانع المحتوى: حدِّد صانع مقطع الفيديو.

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

أسئلة حول الحساب والملف الشخصي

يستخدم تطبيقي عمليات تسجيل دخول المستخدمين المجهولة الهوية. هل لا يزال AccountProfile مطلوبًا لاستخدام ميزة "مواصلة المشاهدة 2.0"؟

تم تصميم AccountProfile للتطبيقات التي تستخدم حسابات المستخدمين الفردية. ومع ذلك، نتفهّم أنّ بعض التطبيقات، مثل تطبيقك، قد تعتمد على عمليات تسجيل دخول مجهولة الهوية. في ما يلي توضيح لآلية عمل ميزة &quot;مواصلة المشاهدة 2.0&quot; في هذا السيناريو:

  • يُعدّ AccountProfile مطلوبًا من الناحية الفنية، ولكن يمكنك دمج ميزة &quot;مواصلة المشاهدة&quot; 2.0 حتى إذا كان تطبيقك لا يتضمّن نظام حسابات مستخدمين.
  • مقتصر على الاستخدام على الجهاز: تعتمد إمكانات &quot;مواصلة المشاهدة 2.0&quot; على تحديد هوية المستخدمين على أجهزة مختلفة. وبما أنّ عمليات تسجيل الدخول بدون الكشف عن الهوية لا توفّر ذلك، ستقتصر الميزة على الجهاز الحالي للمستخدم.
  • كيفية ضبط هذا الإعداد: لإعداد هذه الميزة، عليك إيقاف المزامنة على الأجهزة المتعددة. يضمن ذلك ألا تظهر إدخالات "مواصلة المشاهدة" إلا على الجهاز المحدّد الذي بدأ فيه عرض المحتوى.

باختصار، على الرغم من إمكانية دمج ميزة "مواصلة المشاهدة 2.0" مع عمليات تسجيل الدخول بدون الكشف عن الهوية، لن يتمكّن المستخدمون من استئناف المحتوى إلا على الجهاز نفسه.

هل يمكنني استخدام AccountProfile مع accountId فقط وبدون profileId، حتى إذا كان تطبيقي يتيح استخدام كل من accountId وprofileId؟

يتطلّب AccountProfile كلاً من accountId وprofileId ليعمل بشكل صحيح. وفي ما يلي السبب في ذلك:

  • تحديد الهوية بشكل متّسق: يحدّد accountId هوية المستخدم، بينما يميّز profileId بين الملفات الشخصية المختلفة ضمن حساب المستخدم (في حال توفُّرها). يضمن توفير كليهما أن تتتبّع ميزة "مواصلة المشاهدة" المحتوى بدقة وتعرضه لكل ملف شخصي على حدة.
  • تجنُّب الأخطاء: يمكن أن يؤدي استخدام accountId وprofileId بشكل غير متسق في مختلف طلبات البيانات من واجهة برمجة التطبيقات إلى حدوث أخطاء وسلوك غير متوقّع. على سبيل المثال، إذا أدرجت كلا المعرّفَين عند إضافة محتوى إلى قائمة &quot;مواصلة المشاهدة&quot;، ولكنك استخدمت accountId فقط عند حذف المحتوى، قد لا يتمكّن النظام من تحديد العناصر المقصودة وإزالتها بشكل صحيح.

هل يلزم توفير profileId لاستخدام ميزة "مواصلة المشاهدة 2.0"؟

  • يجب إدخال accountId. يحدّد هذا المعرّف هوية المستخدم على جميع الأجهزة.
  • يُعدّ profileId أمرًا بالغ الأهمية لتوفير تجربة مستخدم جيدة. على الرغم من أنّ profileId اختياري من الناحية الفنية، ننصح بشدة باستخدامه إذا كانت خدمتك تتيح استخدام ملفات شخصية متعددة (مثل العديد من خدمات البث). لماذا هو مهم للغاية؟ لأنّه بدون profileId، قد تعرض ميزة "مواصلة المشاهدة" محتوًى من ملفات شخصية أخرى على الحساب نفسه. وقد يؤدي ذلك إلى تقديم تجربة مربكة ومحبطة للمستخدمين.
  • باختصار، يضمن توفير profileId أن تعكس ميزة "مواصلة المشاهدة" سجلّ مشاهدة كل فرد بدقة. يجب توفير هذا المعرّف إلا إذا كان تطبيقك لا يتيح إنشاء ملف شخصي ضمن الحساب.

كيف تستخدم Google رقم تعريف الملف الشخصي من جهتها؟

إذا كانت الخدمة توفّر ملفات شخصية مختلفة لمشاهدة المحتوى، سيتم استخدام accountId وprofileId لربط المحتوى الذي يتمّت مشاهدته على الجهاز بحساب Google الذي تمّ تسجيل الدخول إليه على الجهاز. ستسجّل Google بيانات ContinueWatching مقابل مجموعة accountId-profileId. سيحصل أي جهاز من Google تم تسجيل الدخول إليه باستخدام حساب Google نفسه على أحدث البيانات المعدَّلة من معرّفات الحسابات والمعرّفات الشخصية المرتبطة نفسها، وذلك في صف "متابعة المشاهدة".

هل يجب ربط الحسابات لتفعيل ميزة "مواصلة المشاهدة 2.0"؟

لا يلزم ربط الحساب. تمت إزالة هذه الواجهة من قائمة الأولويات، وستتم تغطية جميع حالات الاستخدام ذات الصلة من خلال واجهة برمجة التطبيقات الجديدة "استحقاقات الجهاز".

أسئلة حول المزامنة على جميع الأجهزة

بموافقة المستخدم على "المزامنة على جميع الأجهزة"، سيتم حفظ المحتوى الذي يشاهده على خوادم Google TV، ما يتيح له مواصلة المشاهدة بسلاسة من حيث توقّف على أي جهاز سجّل الدخول إليه. بدون موافقة، يبقى سجلّ المشاهدة محليًا على الجهاز الحالي.

هل يمكننا ضبط "المزامنة بين الأجهزة" على "خطأ"؟

يتحكّم الخيار UserConsentToSyncAcrossDevices في ما إذا كانت بيانات ContinuationCluster الخاصة بالمستخدم تتم مزامنتها على جميع أجهزته (التلفزيون والهاتف والجهاز اللوحي وما إلى ذلك). وإذا تم ضبط هذا الخيار على "خطأ"، لن يتمكّن المستخدم من مواصلة المشاهدة إلا على الجهاز نفسه.

للاستفادة إلى أقصى حد من ميزة "العمل على أجهزة متعددة"، ننصح بشدة بأن يحصل تطبيقك على موافقة المستخدم وأن يتم ضبط قيمة SyncAcrossDevices على "صحيح".

الأجهزة؟ ما هي نقاط البيانات التي تتم مشاركتها مع خوادم الجهات الخارجية من الأجهزة غير التابعة لنظام التشغيل Android؟

يتم جمع الموافقة على مستوى المستخدم (على مستوى الملف الشخصي أو الحساب). بعد الحصول على الموافقة، يمكن إرسال حمولات &quot;مواصلة المشاهدة&quot; استنادًا إلى التفاعل إلى أي مكان، ما يتيح لـ Google عرض حالة الاستئناف في كل الكيانات التي يتفاعل معها المستخدم بشكل جزئي أو لاحقًا، وذلك على أي جهاز (بدون الحاجة إلى طلب الموافقة مجددًا على كل جهاز أو منصة). سيرسل الشركاء أحدث حالة &quot;متابعة المشاهدة&quot; (وفقًا للمواصفات) المرتبطة بمعرّف الملف الشخصي (الذي تم إيداعه على Android).

أسئلة حول واجهة برمجة التطبيقات REST

هل تتوفّر مستندات حول واجهة REST API؟

من المتوقّع أن تكون واجهة REST API متاحة في مارس 2025، وقد تم توثيق ذلك في مستندات المطوّرين حول ميزة "مواصلة المشاهدة 2.0".

أسئلة حول ميزة "اقتراحات أخرى" القديمة

هل ستحلّ واجهة برمجة التطبيقات Video Discovery API محلّ واجهة Watch Next API؟

ستكون واجهة برمجة التطبيقات Video Discovery API متوافقة مع الإصدارات القديمة على جميع أجهزة Android TV التي تتوافق مع Watch Next API. على جميع المطوّرين استخدام Video Discovery API (ميزة "مواصلة المشاهدة 2.0") للنشر في صف "مواصلة المشاهدة".

أسئلة حول الاختبار والدمج

ما الفرق بين LastPlayBackPositionTimeMillis وduration؟

يجب أن يعكس LastPlayBackPositionTimeMillis مدة التشغيل بالملّي ثانية التي توقّف المستخدم عندها عن المشاهدة (مثلاً، ‫605000 مللي ثانية لمدة 10 دقائق و5 ثوانٍ). يجب ألا تكون هذه القيمة أكبر من إجمالي مدة الكيان.

في المقابل، LastEngagementTime هو الطابع الزمني الذي تفاعل فيه المستخدم مع المحتوى لآخر مرة.

ما هي حالات الاختبار التي يجب تنفيذها؟

في ما يلي حالات اختبار Google TV التي يجريها فريق ضمان الجودة. يمكن إجراء حالات اختبار مشابهة على مساحات عرض أخرى أيضًا.

  1. شاهِد فيديو تزيد مدته عن 20 دقيقة لمدة 5 دقائق تقريبًا. اخرج من التطبيق. من المفترض أن تظهر بطاقة الفيديو في صف "متابعة المشاهدة". ملاحظة: نعرض 5 بطاقات فقط لكل تطبيق تابع لجهة خارجية في "ميزة المحادثة".
  2. يجب أن يؤدي النقر على البطاقة التي ظهرت حديثًا في صف "مواصلة المشاهدة" إلى استئناف تشغيل الفيديو من النقطة الصحيحة. ملاحظة: يجب أن يتم استئناف تشغيل أي محتوى جديد أو قديم من حيث توقّف آخر مرة.
  3. عند تغيير الحسابات على جهاز GTV، يجب أن تتغيّر البطاقات في صف "متابعة المشاهدة". يجب أن تظهر الفيديوهات من الحساب الحالي فقط. مرتَّب حسب الأحدث. سيتم دمج ملفات تعريف تطبيقات الجهات الخارجية مع ملفات تعريف CW. ملاحظة: ستعرض ميزة "المشاهدة المتزامنة" لحساب GoogleAccount2 المحتوى الخاص بالجهات الخارجية الذي تفاعل معه حساب GoogleAccount2.
  4. الخروج من التطبيق باستخدام الزر BACK > التأكّد من ظهور البطاقة في صف "مواصلة المشاهدة"
  5. إخفاء الفيديو في صف "مواصلة المشاهدة"، ويجب ألا يظهر مرة أخرى. اختبِر ما إذا كان المحتوى المخفي يظل مخفيًا لأكثر من 24 ساعة وحتى بعد فتح التطبيق بعد 24 ساعة. تأكَّد من أنّ إخفاء عنصر واحد لا يؤدي إلى إخفاء عناصر متعدّدة.
  6. توفّر المحتوى في قسم "متابعة المشاهدة" مع البيانات الوصفية الكاملة: صورة البطاقة، واسم التطبيق، والعنوان، ورقم حلقة الموسم للمحتوى التلفزيوني
  7. يظهر "التحقّق من مستوى التقدّم" في شريط التقدّم
  8. شاهد المستخدم المحتوى حتى ظهور شارة النهاية، وبالتالي لن يظهر المحتوى في قسم "مواصلة المشاهدة"
  9. التأكّد من عدم ظهور أي محتوى لم تتم مشاهدته في صف "مواصلة المشاهدة"
  10. تأكَّد من ترتيب عناصر "المشاهدة أثناء التنقّل" حسب التسلسل الزمني استنادًا إلى وقت حدوث نشاط المشاهدة وليس وقت فتح التطبيق آخر مرة أو آخر يوم.
  11. تأكَّد من أنّ تفاصيل الحلقة والموسم على بطاقة المحتوى على الويب تتطابق مع المحتوى الذي تمت مشاهدته
  12. التأكّد من أنّ العناصر المكتملة (التي تمّت مشاهدتها بالكامل أو أكثر) لا تظهر في &quot;مواصلة المشاهدة&quot;
  13. أوقِف الجهاز في منتصف مشاهدة الحلقة أو الفيلم أو البرنامج التلفزيوني. "أطفِئ الجهاز في منتصف مشاهدة الحلقة أو الفيلم أو البرنامج. تحقَّق من أنّ البطاقة الصحيحة تظهر على التلفزيون الآخر عند تشغيل الجهاز، وفي الموضع الصحيح مع شريط التقدّم".
  14. إيقاف الجهاز بعد مشاهدة الحلقة الأولى بالكامل، ثم تأكيد ذلك
  15. تظهر الحلقة 1 ثم تختفي من صف "مواصلة المشاهدة" [على الجهاز الثاني وعند تشغيل الجهاز التجريبي]
    1. الحلقة 2 (إذا كانت متاحة)، يجب أن تظهر في صف "مواصلة المشاهدة" [على الجهاز الثاني وعند تشغيل الجهاز التجريبي]
  16. السيناريو الأول: TV1: GoogleAccount: mom, 3p account / profile: account 1 / profile_1. مشاهدة المحتوى والتحقّق من أنّ بيانات CW تعرض المحتوى الذي شاهدته حساب_1/الملف الشخصي_1 التابع لجهة خارجية
  17. TV2: GoogleAccount: mom. تحقَّق من بيانات "الرفاهية الرقمية" من السيناريو الأول. سجِّل الدخول إلى تطبيق الجهة الخارجية باستخدام حساب مختلف. 3p account / profile: account_2 / profile_2. مشاهدة المحتوى والتأكّد من أنّ بيانات CW تعرض المحتوى الذي شاهدته حساب_2/الملف الشخصي_2 التابع لجهة خارجية

  18. ‫GoogleAccount: mom. لم يتم تثبيت جراب الجهاز الجديد أو تطبيق تابع لجهة خارجية. على جهاز جديد(بعد إعادة ضبط الجهاز على الإعدادات الأصلية)، يعرض تطبيق "التحقّق من التوافق مع الأجهزة" البيانات من آخر تطبيق تابع لجهة خارجية تم استخدامه من خلال حساب Google. ملاحظة: يجب ألا يعرض صف "المشاهدة مع الآخرين" محتوى من جهات خارجية إذا لم يكن حساب GAIA مرتبطًا بعد بملف شخصي تابع لجهة خارجية على جهاز آخر.

    1. ‫GoogleAccount: mom. تم تثبيت تطبيق جديد لجراب الجهاز /تطبيق تابع لجهة خارجية، ولكن لم يتم تسجيل الدخول. على جهاز جديد(إعادة ضبط الجهاز على الإعدادات الأصلية)، يعرض Verify CW بيانات من آخر تطبيق تابع لجهة خارجية استخدمه حساب Google.
    1. ملاحظة: يجب ألا يعرض صف "متابعة المشاهدة" محتوى تابعًا لجهات خارجية إذا لم يكن حساب Google مرتبطًا بعد بملف شخصي تابع لجهة خارجية.

لا تظهر قائمة "مواصلة المشاهدة" في تطبيق Google TV على أجهزة iOS. ما السبب؟

عليك إرسال روابط لصفحات في التطبيق على iOS لكي تظهر ميزة "مواصلة المشاهدة" على أجهزة iOS.

ما هو معدّل تكرار تعديل معلومات "مواصلة المشاهدة"؟ هل يجب تعديل معلومات "مواصلة المشاهدة" بشكل متكرّر، مثلاً كل 15 ثانية؟

لا، لا يُنصح بإجراء تعديلات متكرّرة. وفي ما يلي السبب في ذلك:

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

الحالات التي يجب فيها تعديل معلومات "مواصلة المشاهدة":

ركِّز على تسجيل التغييرات المهمة في مستوى تقدّم المستخدم في المشاهدة. في ما يلي السيناريوهات الرئيسية:

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

كيفية التعديل بكفاءة:

بدلاً من التحديثات المحدّدة بوقت، استخدِم الأحداث ضمن مشغّل الفيديو أو دورة حياة التطبيق لتشغيل التحديثات. مثلاً:

  • ‎onPause وonStop: عند إيقاف تشغيل الفيديو مؤقتًا أو إيقافه.
  • onAppClose وonAppBackgrounded: عند إغلاق التطبيق أو نقله إلى الخلفية

من خلال اتّباع هذه الإرشادات، ستضمن الاستخدام الفعّال للموارد مع الاستمرار في تقديم تجربة "متابعة المشاهدة" سلسة للمستخدمين.