سجلّ إصدار حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية في Roku

الإصدار تاريخ الإصدار ملاحظات
3.69.0 2025-09-25
  • تضيف هذه السمة Companion.adSlotId وCompanion.companionClickThrough لدعم الإعلانات المصاحبة في بث "عرض الإعلانات المتسلسلة".
  • تم إصلاح مشكلة عدم إرسال إشارات اكتمال العرض لجميع الإعلانات باستثناء الإعلان الأخير في مجموعة إعلانات متسلسلة.
  • تم إصلاح الخطأ الذي كان يتسبّب في تسجيل حدث الإعلان COMPLETE عند تخطّي الإعلان. يتم الآن تسجيل أحداث الإعلانات بدقة أكبر عندما يتخطّى المستخدمون فواصل إعلانية.
  • يزيل هذا الإجراء سلوك IMA المتمثل في تركيز حاوية واجهة المستخدم بعد أن تزيل IMA واجهة مستخدم الإعلان.
3.68.3 2025-07-02
  • تم إصلاح مشكلة يتم فيها إطلاق حدثَي بدء فاصل الإعلان وبدء الإعلان في وقت غير صحيح، مثلاً عند استئناف المحتوى.
  • تم إصلاح مشكلة تتسبّب فيها قيم مدة الإعلان غير الصالحة في حدوث خطأ أثناء التشغيل، 'Dot' Operator attempted with invalid BrightScript Component or interface reference .
3.68.2 2025-05-28
  • تتيح للجميع استخدام الطريقة player.streamInitialized() التي يتم استدعاؤها عند بدء بث.
  • تم تعديل سلوك IMA لكي لا يتم تشغيل الحدث COMPLETED عندما يتخطّى المستخدمون إعلانًا. سيظلّ حزمة تطوير البرامج (SDK) تُطلق الحدث SKIPPED عندما يتخطّى المستخدمون الإعلانات. يتوافق هذا التغيير في سلوك الحدث COMPLETED مع سلوك حِزم تطوير البرامج الأخرى في IMA.
  • يحسّن طريقة التعامل مع الرسائل في بثّات عرض الإعلانات المتسلسلة.
  • تم إصلاح مشكلة تمدُّد واجهة مستخدم الإعلان على عمليات البث بدقة Full HD.
  • تم إصلاح مشكلة تأخُّر أحداث إعلانات ما قبل التشغيل الأولية.
3.68.1 2025-04-21
  • إصلاح خطأ وقت التشغيل في حالة Divide by Zero المتعلقة بأيقونات الإعلانات.
3.67.2 2024-12-19
  • تضيف هذه السمة تحسينات على currentAd.currentTime لمواءمة قيمة currentTime مع الوقت الذي يتم فيه إطلاق حدث الإعلان.
  • تم إصلاح مشكلة عدم إطلاق أحداث إعلانات معيّنة بشكل متقطّع.
3.67.0 2024-11-07
  • تضيف هذه السمة المَعلمة الاختيارية لمعرِّف شبكة "إدارة إعلانات Google" إلى طلبات بث DAI التي تتضمّن خدمة كاملة. يتيح تضمين المَعلمة تغيير سلوك IMA ليتطابق مع إعدادات "مدير إعلانات Google"، مثل إيقاف الإعلانات المحدودة الآلية.
  • تضيف هذه السمة إمكانية بث الفيديو عند الطلب في streamManager.loadThirdPartyStream().
  • تحديثات AdBreakInfo.podIndex لأحداث البث المباشر تعرض هذه القيمة الآن معرّف فاصل الإعلان كفهرس الحزمة لإعلانات ما قبل التشغيل، أو 0 لإعلانات ما قبل التشغيل. لا تتوفّر إعلانات ما بعد التشغيل في أحداث البث المباشر. تكون القيمة التلقائية -2 لأحداث البث المباشر.
  • إضافة دعم لـ StreamManager.getStreamTime() وStreamManager.getContentTime() إلى عمليات الربط في السحابة الإلكترونية وعمليات بث المحتوى من الحزمة.
  • إصلاح مشكلة عدم تضمين قيمتَي معرّف تصميم الإعلان ومعرّف تصميم الإعلان في AdInfo.
  • تم إصلاح مشكلة عدم صحة موضع رمز واجهة مستخدم Roku وزر التخطّي.
3.66.1 2024-07-25
  • تضيف هذه السمة شرطًا لاستخدام المَعلمة networkCode في جميع طلبات البث المباشر والفيديوهات عند الطلب.
  • تضيف هذه السمة creative_id وcreative_ad_id وdeal_id إلى فئة AdInfo.
  • تضيف هذه السمة إمكانية استخدام أحداث تتبُّع VAST مخصّصة، مثل "تم عرض زر التخطّي" و"تخطّي" و"النقر للوصول إلى الموقع".
  • يحلّ هذا الإصدار مشكلة في StreamManager.getCuePoint() لعمليات بث الفيديو عند الطلب في Cloud Video Stitcher.
  • إصلاح خطأ في الكتابة بالأحرف اللاتينية الكبيرة في StreamManager.createVideoStitcherVodStreamRequestWithVodConfig()
3.66.0 2024-06-18
3.65.0 2024-03-29
3.64.0 2024-02-08
  • تضيف هذه السمة المَعلمة الاختيارية settings إلى الدالة ima.initSdk لتفعيل ميزات حزمة تطوير البرامج (SDK) وإيقافها.
3.63.0 2023-09-14
  • تم إصلاح الخلل الذي كان يؤدي إلى تعطُّل التطبيق عند مواجهة adBreakInfo غير صالح.
3.62.0 2023-08-02
  • تضيف هذه الحزمة واجهتَي برمجة التطبيقات StreamRequest.createVideoStitcherLiveStreamRequest() و StreamRequest.createVideoStitcherVodStreamRequest() لإتاحة استخدام Google Cloud Video Stitcher API.
  • تعدّل هذه السمة سلوك IMA ليتوافق مع القيمة المحدّدة للمَعلمة description_url=. في السابق، كانت حزمة تطوير البرامج IMA تتجاهل دائمًا المَعلمة description_url= وتستبدلها بعنوان URL الذي تم رصده على أنّه العنوان الصحيح، وتغيّر المَعلمة url= إلى القيمة التي تم ضبطها سابقًا على أنّها description_url=. سيستمر IMA في ضبط description_url= إذا لم يتم ضبطه في عنوان URL لعلامة الإعلان في البث.
3.61.1 2023-03-22
  • تتيح عرض الإعلانات التقليدية والقابلة للتخطي من TrueView.
  • تضيف هذه السمة أحداث الإعلانات التالية:
3.60.0 2022-09-30
3.59.0 2022-09-23
  • إصدار الخدمة بدون ميزات جديدة
3.58.0 2022-09-15
  • إصدار الخدمة بدون ميزات جديدة
3.57.2 2022-09-12
3.56.0 2022-08-05
  • إصدار الخدمة بدون ميزات جديدة
3.55.0 2022-07-15
  • تضيف هذه السمة واجهات برمجة التطبيقات التالية لطلب أنواع معيّنة من البث: راجِع StreamRequest للحصول على معلومات حول المَعلمات الخاصة بكل واجهة برمجة تطبيقات.
3.54.0 2022-05-19
3.53.0 2022-04-25
  • تنفيذ تحليل مناسب لأحداث ID3 في بث HLS CMAF المباشر يحلّ هذا الإصلاح مشكلة كانت تؤدي إلى إطلاق أحداث الإعلانات في أوقات غير صحيحة لهذه الفيديوهات.
  • تتوقف عن العمل في ‎StreamManager.onTimedMetadata(). لم تعُد هذه الطريقة مضمّنة في المستندات.
3.52.0 2022-03-29
  • إصدار الخدمة بدون ميزات جديدة
3.51.0 2022-03-17
  • إصدار الخدمة بدون ميزات جديدة
3.50.0 2022-03-07
  • تضيف هذه السمة StreamManager.onTimedMetadata().
3.45.1 2021-11-03
  • تضيف هذه السمة إمكانية عرض إعلانات قابلة للتخطّي.
  • تعديل سلوك حزمة SDK لتسجيل أحداث التقدّم بشكل صحيح
3.41.1 2021-04-07
  • تضيف StreamRequest.adUiNode عناصر مثل زرَّي لماذا هذا الإعلان؟ وتخطّي ليتم وضعهما أثناء عرض الإعلانات.
  • يزيل هذا الإجراء إمكانية استخدام StreamManager.enableInteractiveAds(). أصبح هذا الإجراء غير متاح، وبدلاً من ذلك، يمكنك نقل البيانات من الإعلان المرافق إلى RAF مباشرةً.
3.40.1 2020-09-23
  • تضيف هذه الحزمة إمكانية بث أحداث مباشرة باستخدام DASH.
3.39.0 2020-07-06
  • إصدار الخدمة بدون ميزات جديدة
3.36.0 2020-02-28
  • إصدار الخدمة بدون ميزات جديدة
3.35.0 2019-11-11
  • إصدار الخدمة بدون ميزات جديدة
3.34.0 2019-07-18
  • إصدار الخدمة بدون ميزات جديدة
3.33.0 2019-05-14
  • يضيف هذا الإجراء حدثَي AD_PERIOD_STARTED وAD_PERIOD_ENDED إلى ima.AdEvent.
  • يضيف أحداث الإعلان PROGRESS إلى ima.AdEvent.
  • تضيف هذه السمة المَعلمات advertiserName وuniversalAdIDRegistry وuniversalAdIDValue إلى adInfo.
3.28.1 2018-07-10
  • إصدار الخدمة بدون ميزات جديدة