سجلّ إصدار حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية في Roku
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الإصدار
تاريخ الإصدار
ملاحظات
3.75.1
2026-08-28
إصدار الخدمة بدون ميزات جديدة
3.70.2
2026-06-16
تضيف هذه السمة إمكانية عرض إعلانات TrueView القابلة للتخطّي. لعرض هذه الإعلانات، يجب إعداد عقدة واجهة مستخدم للإعلان باستخدام الحقل StreamRequest.adUiNode.
تضيف هذه السمة الفئة
LogEvent
لإتاحة معلومات الأحداث للأخطاء غير المميتة التي لا تؤثّر في
تشغيل البث، مثل عدم تحميل الإعلانات المصاحبة.
تضيف هذه السمة حدث الإعلان LOG الذي ترسله حزمة تطوير البرامج (SDK) الخاصة بـ IMA عند حدوث أخطاء غير قاتلة في الإعلان.
تضيف هذه السمة أحداث الخطأ التالية:
HTTP_ERROR: عرض الخادم خطأً في بروتوكول نقل الروابط النصية (HTTP).
REQUEST_TIMEOUT: انتهت مهلة الطلب.
VAST_NO_ADS_AFTER_WRAPPER: استجابة VAST بدون إعلانات
بعد استجابة واحدة أو أكثر. رمز الخطأ 303 في نموذج عرض إعلانات فيديو (VAST)
تم إصلاح مشكلة عدم إرسال إشارات اكتمال جميع الإعلانات باستثناء الإعلان الأخير في مجموعة إعلانات متسلسلة.
تم إصلاح الخطأ الذي كان يتسبّب في تسجيل حدث الإعلان COMPLETE عند تخطّي الإعلان. يتم الآن تسجيل أحداث الإعلانات بشكل أكثر دقة عندما يتخطّى المستخدمون فواصل إعلانية.
يزيل سلوك IMA المتمثل في تركيز حاوية واجهة المستخدم بعد أن تزيل IMA واجهة مستخدم الإعلان.
3.68.3
2025-07-02
تم إصلاح مشكلة يتم فيها تنشيط حدثَي بدء فاصل إعلاني وبدء إعلان في وقت غير صحيح، مثلاً عند استئناف المحتوى.
تم إصلاح مشكلة كانت تتسبّب في حدوث خطأ أثناء التشغيل عند استخدام قيم غير صالحة لمدة الإعلان،
'Dot' Operator attempted with invalid BrightScript Component or
interface reference
.
تعديل سلوك IMA لعدم تنشيط الحدث COMPLETED عندما يتخطّى المستخدمون إعلانًا سيظلّ حزمة تطوير البرامج (SDK) تُطلق الحدث SKIPPED
عندما يتخطّى المستخدمون الإعلانات. يتوافق هذا التغيير في سلوك الحدث COMPLETED مع سلوك حِزم تطوير البرامج الأخرى للإعلانات التفاعلية (IMA SDK).
يحسّن هذا الإعداد طريقة التعامل مع الرسائل في بثّات عرض الإعلانات المتسلسلة.
تم إصلاح مشكلة تمدُّد واجهة مستخدم الإعلان على بث بدقة 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
تضيف هذه السمة مَعلمة معرِّف شبكة "إدارة الإعلانات" الاختيارية لطلبات بث إدراج الإعلان الديناميكي الكاملة الخدمة. يتيح تضمين المَعلمة تغيير سلوك IMA
ليتطابق مع إعدادات "مدير إعلانات Google"، مثل إيقاف
"الإعلانات المحدودة الآلية".
تحديثات AdBreakInfo.podIndex
لأحداث البث المباشر تعرض هذه القيمة الآن معرّف الفاصل الإعلاني كفهرس الحزمة
للفواصل الإعلانية أثناء التشغيل، أو 0 للفواصل الإعلانية قبل التشغيل. لا تتوفّر إعلانات ما بعد التشغيل في أحداث البث المباشر. تكون القيمة التلقائية -2 لأحداث البث المباشر.
تعدّل هذه السمة سلوك IMA ليتوافق مع القيمة المضبوطة للمَعلمة description_url=. في السابق، كانت حزمة IMA تتجاهل دائمًا المَعلمة description_url=
وتستبدلها بعنوان URL الذي رصدته على أنّه العنوان الصحيح، وتغيّر المَعلمة url= إلى القيمة التي تم ضبطها سابقًا على أنّها description_url=. سيستمر IMA في ضبط
description_url= إذا لم يتم ضبطه في عنوان URL لعلامة الإعلان الخاصة بالبث.
3.61.1
2023-03-22
تتيح هذه السمة استخدام الإعلانات التقليدية والقابلة للتخطي من TrueView.
تنفيذ تحليل أحداث 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.
تاريخ التعديل الأخير: 2026-11-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-11-05 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The provided document outlines updates to a software development kit (SDK) across multiple versions. Key actions include adding support for new stream types (live, VOD, pod), enhancing ad management features (skippable ads, custom tracking events, aligning ad event timing), and introducing new APIs for functionalities like stream requests, ad events, and ad information retrieval. Several bug fixes and service releases are also detailed, along with deprecating an outdated method.\n"]]
