إشارات مرجعية

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

ما هي الإشارات المرجعية؟

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

الخيارات المتقدمة لإضافة إشارات مرجعية إلى "إدراج إعلان ديناميكي"

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

طرق التحويل للإنقاذ

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

جارٍ حفظ الإشارات المرجعية

حفظ إشارة مرجعية عند إيقاف تشغيل Activity مؤقتًا.

private double bookmarkTime;
@Override
public void onPause() {
   super.onPause();
   double streamTime = videoPlayer.getCurrentPosition() / 1000.0; // ms to s.
   bookmarkTime = streamManager.getContentTimeForStreamTime(streamTime);
}

جارٍ تحميل الإشارات المرجعية

تحميل الإشارة المرجعية عند إعادة طلب ساحة مشاركات إنه جزء من تنفيذ الواجهة VideoStreamPlayer.

public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
    // Set video player's stream URL and subtitles, and play the stream.
    ...

    // Bookmarking.
    if (bookmarkTime > 0) {
        double streamTime =
                streamManager.getStreamTimeForContentTime(bookmarkTime);
        videoPlayer.seek((long) (streamTime * 1000.0)); // s to ms.
    }
}

نموذج تطبيق

تنزيل نموذج التطبيق لمشاهدة تنفيذ وضع الإشارات المرجعية.