الإبلاغ عن تشغيل متواصل

اختيار النظام الأساسي: HTML5 Android iOS tvOS

تتيح حزمة IMA SDK لنظام التشغيل Android إمكانية ضبط سياق التشغيل المستمر لطلب إعلان. يُعلم الإجراء setContinuousPlayback() حزمة تطوير البرامج (SDK) ما إذا كان المشغّل يعتزم تشغيل فيديوهات المحتوى بشكل مستمر واحدًا تلو الآخر، على غرار البث التلفزيوني. عند ضبط هذه المَعلمة على true، تكون الإعلانات التي يتم عرضها من الطلب هي تلك التي يحدّدها خادم الإعلانات على أنّها مناسبة للتشغيل المستمر. إذا لم يتم استدعاء هذا الإجراء، سيظل الإعداد غير معروف.

ملاحظة: لن يؤثر تغيير هذا الإعداد في تشغيل الإعلانات.

يوضّح المثال التالي كيفية ضبط التشغيل المستمر في طلب إعلان.

AdsRequest request = mSdkFactory.createAdsRequest();
request.setAdTagUrl(adTagUrl);
request.setContinuousPlayback(true);
adsLoader.requestAds(request);

بالنسبة إلى المستخدمين الذين يستخدِمون إضافة Exoplayer-IMA، الإصدار 2.13 أو إصدارًا أحدث، أو BasicExample الذي يطبّق الإضافة، يوضّح المثال التالي كيفية ضبط التشغيل المستمر.

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);

    playerView = findViewById(R.id.player_view);

    ImaAdsLoader.Builder builder = new ImaAdsLoader.Builder(this).setContinuousPlayback(true);
    adsLoader = builder.build();
}

الفرق بين التشغيل المستمر والتشغيل التلقائي للإعلانات

تتيح حزمة IMA SDK لنظام التشغيل Android أيضًا إمكانية ضبط ما إذا كان المشغّل سيبدأ التشغيل تلقائيًا أو سينتظر إجراءً من المستخدم لبدء التشغيل. يتم ذلك باستخدام الإجراء setAdWillAutoPlay(). عند ضبط هذه المَعلمة على true، تكون الإعلانات التي يتم عرضها هي تلك التي يحدّدها خادم الإعلانات على أنّها مناسبة لبيئة التشغيل التلقائي.

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

محتوى الفيديو	مَعلمة الإجراء setContinuousPlayback()	مَعلمة الإجراء setAdWillAutoPlay()
فيديو محتوى واحد يتم تشغيله عند تفاعل المستخدم	false	false
فيديو محتوى واحد يتم تشغيله تلقائيًا	false	true
قائمة تشغيل فيديو يتم فيها تشغيل الفيديو الأول عند تفاعل المستخدم، ولكن يتم تشغيل الفيديوهات التالية تلقائيًا	true	false
قائمة تشغيل فيديو يتم فيها تشغيل الفيديو الأول تلقائيًا وتشغيل الفيديوهات التالية تلقائيًا	true	true