سجلّ إصدار حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية لنظام التشغيل tvOS
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الإصدار
تاريخ الإصدار
ملاحظات
4.17.0
2026-05-29
تضيف هذه السمة إمكانية عرض إعلانات قابلة للتخطّي مع تفعيل الإعلانات البينية بتنسيق HLS في
قنوات البث.
تضيف هذه السمة عملية تحقّق في وقت الترجمة البرمجية للتأكّد من أنّ إصدار tvOS المستهدَف في تطبيقك متوافق مع الحد الأدنى لإصدار tvOS في "حزمة تطوير البرامج للإعلانات التفاعلية".
إصلاح الخطأ nullpointerexception عندما تكون قيمة adTagURL هي
null في
IMAAdsRequest
تغييرات على منطق الخيار الاحتياطي على مستوى مواد العرض لتكرار جميع الإعلانات في VAST الأصلي إلى أن تحدّد حزمة تطوير البرامج (SDK) تصميم إعلان يمكن تشغيله إذا لم يتم العثور على تصميم إعلان قابل للتشغيل، لن يتم تشغيل الإعلان.
تم إصلاح المشكلة المتمثّلة في عدم إرسال طلبات ping للتتبُّع إلى ad.doubleclick.net.
تضبط هذه السمة قيود عرض حجم الإعلان في حزمة SDK استنادًا إلى إطار العرض
بدلاً من دليل تصميم المنطقة الآمنة في playerView.
تم إصلاح الخطأ الذي كان يؤدي إلى إبلاغ الناشر بأنّ الإعلانات الخطية في AdSense غير خطية.
تم إصلاح مشكلة عدم إصدار IMAStreamManager.replaceAdTagParameters لتحديث.
تمت إضافة واجهات برمجة التطبيقات لعرض الإعلانات الصوتية.
فرض ربط adContainer بالنافذة
4.3.2
2020-08-11
تم تعديل "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" لتتوافق مع الإصدار 14 من نظام التشغيل tvOS: تمت إضافة دعم
AppTrackingTransparency. يمكنك الاطّلاع على
طلب
تفويض ميزة "شفافية تتبُّع التطبيقات"
للحصول على مزيد من المعلومات.
تمت إضافة إمكانية استخدام المفتاح "language_name" لترجمة وشرح بث الفيديو.
تم إصلاح مشكلة كانت تؤدي إلى انتهاء مهلة الإعلانات الصوتية فقط.
تم إصلاح مشكلة كانت تؤدي إلى تجاهل الإعلان الثاني لإزاحة التخطّي الخاصة به عند تخطّي الإعلان الأول في إعلان ما قبل التشغيل.
تمت إضافة IMAAdDisplayContainer.focusEnvironment، ما يتيح للناشرين نقل التركيز إلى حزمة SDK أثناء فواصل الإعلانات. ويكون ذلك مطلوبًا
عندما يحتاج المستخدم إلى التفاعل مع واجهة مستخدم الإعلان
(مثل الإعلانات القابلة للتخطّي ورموز VAST).
تمت إضافة viewController كسمة أو وسيطة تهيئة مطلوبة جديدة لـ IMAAdDisplayContainer.
تم إصلاح مشكلة عدم توفّر ميزة الترجمة إلى لغات غير الإنجليزية.
تقليل أحداث RESUME الخاطئة
تمت إضافة IMAAdsRenderingSettings.enablePreloading، وهي مفعّلة تلقائيًا، لتحسين أداء عرض الإعلانات.
تمت إضافة دعم للإعلانات القابلة للتخطّي (من جهة العميل وعند الطلب) ورموز VAST
(من جهة العميل وDAI)
تمت إضافة الحدثَين ICON_FALLBACK_IMAGE_CLOSED وICON_TAPPED. ننصحك باستئناف التشغيل تلقائيًا على
ICON_FALLBACK_IMAGE_CLOSED لأنّ حزمة SDK توقِف التشغيل عند فتح
الصورة الاحتياطية.
تم إصلاح مشكلة عدم إمكانية التعرّف على IABTCF_gdprApplies إلا إذا كان سلسلة.
4.2.3
2020-05-06
تم إصلاح مشكلة كانت تؤدي إلى تصنيف بعض معرّفات حِزم التطبيقات بشكل خاطئ.
4.2.2
2020-03-26
تمت زيادة الحد الأدنى لإصدار وقت التشغيل إلى tvOS 10
تم إصلاح الخطأ الذي كان يؤدي إلى تشغيل بعض تحديثات واجهة المستخدم في سلسلة محادثات في الخلفية
تم إصلاح مشكلة كانت تتسبّب في تعارض عملية تهيئة IMACompanionAd مع عملية تهيئة NSObject عند استخدام العلامات الصارمة.
تم إيقاف استخدام الطريقة loadURL في بروتوكول IMAVideoDisplay
4.2.1
2020-02-12
سيكون الإصدار 4.2.1 هو الإصدار الأخير من حزمة IMA SDK المتوافق مع tvOS 9.x
تم إصلاح مشكلة تعطُّل عمليات النقر على tvOS 9.x
4.2.0
2019-10-30
تم إصلاح مشكلة تعطُّل متقطّع على tvOS 13.
4.1.0
2019-09-23
تمت إضافة دعم tvOS 13.
تمت إضافة playerVideoDisplay:didLoadPlayerItem: إلى DAI.
تمت إضافة IMAAd.companionAds وIMACompanionAd
لإعلانات "إدراج الإعلان الديناميكي".
تم تعديل أسماء IMAAVPlayerVideoDisplayDelegate لتتلاءم بشكل أفضل مع نمط Objective-C.
4.0.5
2019-08-16
تم إصلاح مشكلة عدم استئناف المحتوى عند النقر على زر التشغيل في جهاز التحكّم عن بُعد الخاص بتلفزيون Apple TV.
4.0.2
2019-07-18
تم إصلاح مشكلة نقل إعداد "الحدّ من تتبُّع الإعلانات" الخاص بالمستخدم بشكل غير صحيح.
تمت كتابة IMAAdEventType.adData الآن.
تمت إضافة authToken API في IMAStreamRequest.
4.0.1 Deprecated
2019-07-02
حِزم تطوير البرامج (SDK) المدمجة على tvOS من جهة العميل وDAI
تم إصلاح مشكلة عدم تحليل AdsLists وعرض أخطاء AdsLoader على tvOS.
عرض الإصدارات السابقة
الإصدار
تاريخ الإصدار
ملاحظات
3.9.1
2019-03-28
تم تغيير المهلة التلقائية لتهيئة البث من 5 ثوانٍ إلى 8 ثوانٍ.
تمت إضافة السمة initializationTimeout إلى IMAStreamRequest لتفعيل إعداد مهلة إعداد مصدر البيانات.
3.9.0
2019-03-06
تمّت إضافة دوالّ ردّ الاتصال adPeriodDidStart وadPeriodDidEnd إلى IMAStreamManagerDelegate.
3.8.1
2018-12-06
لمنع تسجيل مقاييس مكرّرة، لن يتم بعد الآن تنشيط أحداث الإعلانات، مثل AD_BREAK_STARTED/AD_BREAK_ENDED، عند إعادة مشاهدة إعلان أو البحث فيه.
3.8.0
2018-05-21
إضافة دعم لمَعلمة علامة الإعلان npa
3.7.1
2018-02-26
تم إصلاح الخطأ الذي كان يتسبّب في عدم إرسال إشعارات إلى عناوين URL للتتبّع التي تحتوي على أقواس معقوفة ("{" أو "}") على نظام التشغيل tvOS 11.2.6.
3.7.0
2018-01-24
تضيف هذه السمة القيم التالية كقيم مقبولة لمفاتيح IMAStreamRequest.adTagParameters:
نطاق الصوت (dai-aor)
استبعاد (dai-excl)
بدء الطلب (dai-os)
نطاق الفيديو (dai-sr)
تضيف هذه السمة ما يلي إلى IMAAd: advertiserName وcreativeID وcreativeAdID وdealID وuniversalAdIDRegistry وuniversalAdIDValue وwrapperAdIDs وwrapperAdSystems وwrapperCreativeIDs وwrapperDealIDs.
تُطلق حزمة SDK الآن الحدث AD_BREAK_STARTED عند الانضمام إلى بث في منتصف فاصل إعلاني، ما يتيح للمستمعين عرض واجهة مستخدم الإعلان.
تضيف هذه السمة IMAAVPlayerVideoDisplayDelegate لكي يتمكّن مستخدمو IMAAVPlayerVideoDisplay من تلقّي AVAssetURL البث الذي سيتم تحميله. باستخدام العنصر AVAssetURL، يمكن للمستخدمين التسجيل لتشغيل المحتوى المحمي باستخدام FairPlay.
3.6.0
2017-09-19
يزيل IMAStreamRequest.attemptPreroll غير الوظيفي.
تضيف هذه السمة ما يلي كقيمة مقبولة IMAStreamRequest.adTagParameters:
dai-ah (Ad Holiday)
dai-dlid (موقع التسليم)
تضيف هذه السمة IMAStreamRequest.streamActivityMonitorID.
تم إصلاح المشكلة المتمثّلة في عدم استدعاء [IMAStreamManagerDelegate streamManager:didReceiveError:] لعمليات البث التي لم يتم تشغيلها أو تحميلها.
3.5.0
2017-04-24
تضيف هذه السمة IMAAd.companions.
يضيف الصف IMACompanion.
3.4.1
2017-03-31
إصدار الخدمة بدون ميزات جديدة
3.4.0
2017-03-13
إصلاحات متعلّقة بتوافق bitcode
تضيف هذه السمة الخصائص التالية إلى AdBreakInfo:
adBreakIndex
timeOffset
3.3.0
2016-12-05
تعرض [IMAAVPlayerVideoDisplay reset]، ويجب استدعاؤها عندما تحتاج إلى استبدال AVPlayerItem في مشغّل المحتوى بنسخة احتياطية من AVPlayerItem.
3.2.0
2016-08-22
تم إصلاح مشكلة عند إرسال تطبيق يستخدم إطار العمل للاختبار.
تاريخ التعديل الأخير: 2026-05-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-05-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The updates address bug fixes and feature enhancements across various versions. Key actions include adding support for skippable ads, VOD Pod Serving, and Google Video Stitcher APIs. Memory leaks and null pointer exceptions were fixed, and tracking logic for ad interactions was improved. The SDK now respects safe area guides, enforces ad container attachment, and supports privacy features. New events like `AD_CAN_PLAY` and properties for session management were introduced, alongside updates for compatibility with new tvOS versions and Google's ad consent modes.\n"]]
