سجلّ إصدارات حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية من Google

الإصدار تاريخ الإصدار ملاحظات
3.36.0 2024-11-07
  • ظهرت مشكلة معروفة في هذا الإصدار تتعلّق بالتطبيقات الفورية . في حال دمج IMA في التطبيقات الفورية، ننصحك بعدم تحديث تطبيقك إلى الإصدار 3.36.0 من IMA. سيتضمّن الإصدار التالي من حزمة SDK حلّاً لهذه المشكلة.
  • تُضيف طرقًا جديدة لطلبات البث تتضمّن المَعلمة NetworkCode. وهما الأسلوبان الجديدان: ImaSdkFactory.createLiveStreamRequest() و ImaSdkFactory.createVodStreamRequest(). إيقاف واجهات برمجة التطبيقات المشابهة التي لا تتضمّن المَعلمة networkCode نهائيًا
  • لفها تصميمات الإعلانات المصاحبة في تنسيق إطار يتطابق مع حجم الخانة الذي تم تحديده باستخدام CompanionAdSlot.setSize().
3.35.1 2024-09-24
  • إصلاح مشكلة تعذُّر القياس المفتوح عند استخدام واجهة برمجة التطبيقات ImaSdkFactory.initialize()
  • زيادة عدد minSdkVersion التي تتوافق معها IMA إلى 21
  • تُضيف ImaSdkFactory.initialize() لتحميل مواد عرض IMA وإعدادها قبل طلب الإعلان الأول. يؤدي استدعاء initialize() إلى تخصيص الذاكرة المطلوبة لتشغيل الإعلانات في المستقبل ويقلل من وقت الاستجابة لتشغيل الإعلان الأول.
  • حلّ مشكلة عنوان URL غير الصالح للنقر على الإعلان
  • إصلاح عطل ظهر في الإصدار 3.34.0 من IMA ويؤثر في التطبيقات التي لا تستخدم عملية إزالة الترميز البرمجي في Java 8 على الإصدارات 25 من واجهة برمجة تطبيقات Android والإصدارات الأقدم
  • إضافة تحسينات إلى وقت بدء تشغيل IMA على أجهزة التلفزيون المتّصل القديمة
  • تحسين ثبات فتح الروابط على الأجهزة التي لم يتم تثبيت متصفّح عليها
  • سيتم إيقاف الإصدار 3.35.1 من حزمة SDK نهائيًا في 7 تشرين الثاني (نوفمبر) 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.35.0 متوقّف نهائيًا 2024-08-28
  • توجد مشكلة معروفة في هذا الإصدار تؤدي إلى تعذُّر قياس OMID عند استخدام واجهة برمجة التطبيقات ImaSdkFactory.initialize(). استخدِم الإصدار 3.35.1 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية على Android بدلاً من ذلك.
  • بما أنّ الإصدار 3.35.0 متوقف نهائيًا، تم نقل ملاحظات الإصدار إلى قسم الإصدار 3.35.1.
3.34.0 2024-06-13
3.33.0 2024-03-28
3.32.0 متوقّف نهائيًا 2024-01-30
  • يواجه هذا الإصدار مشكلة في الأجهزة التي تعمل بمستويات واجهة برمجة تطبيقات Android الإصدار 25 والإصدارات الأقدم. استخدِم الإصدار 3.33.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية لنظام التشغيل Android بدلاً من ذلك.
  • إتاحة بث الفيديوهات المسجّلة من خلال أداة ربط تابعة لجهة خارجية لعرض مجموعات المحتوى اطّلِع على دليل عرض مجموعات التطبيقات على Android للحصول على مزيد من المعلومات. يتضمّن هذا التغيير إضافة واجهات برمجة التطبيقات التالية:
  • زيادة عدد minSdkVersion التي تتوافق معها IMA إلى 19
  • حلّ مشكلة عدم فتح صفحة جديدة عند النقر على الإعلان باستخدام الزر "مزيد من المعلومات" في الإصدار 30 من Android API والإصدارات الأحدث لا تزال المشكلة قائمة في الإصدارات 3.31.0 إلى 3.29.0 من أداة تطوير البرامج لإعلانات الوسائط التفاعلية، حيث يلزم استخدام حل بديل لكي تعمل النقرات على الإعلانات.
  • إصلاح خطأ يؤدي إلى ظهور استثناء ArrayIndexOutOfBoundsException عند استخدام AdsLoader.addAdsLoadedListener()
  • تُضيف خطأ الإعلان VAST_NO_ADS_AFTER_WRAPPER.
3.31.0 2023-08-31
  • هناك مشكلة في الإصدارات 3.31.0 إلى 3.29.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA) مع الإصدار 30 من واجهة برمجة التطبيقات لنظام التشغيل Android والإصدارات الأحدث، حيث لا تؤدي النقرات على الإعلان باستخدام زر مزيد من المعلومات إلى فتح صفحة جديدة. كحل بديل ل الإصدارات المتأثرة، عليك إضافة بيانات عن الأهداف لفتح روابط الويب في بيان التطبيق على النحو التالي: 
              <?xml version="1.0" encoding="utf-8"?>
          <manifest xmlns:android="http://schemas.android.com/apk/res/android"
              package="com.example.project_name">
              ...
              </application>
              <queries>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="https" />
                  </intent>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="http" />
                  </intent>
              </queries>
          </manifest>
  • تعديل الاعتمادية على حزمة OM SDK في IMA إلى الإصدار 1.4.8، والذي يتضمّن إشارات تلفزيون متّصل جديدة
  • إيقاف واجهات برمجة التطبيقات AdsRequest التالية نهائيًا:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • سيتم إيقاف الإصدار 3.31.0 من حزمة تطوير البرامج (SDK) نهائيًا في 28 آذار (مارس) 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.30.3 2023-08-03
  • تعديلات على مكتبات التطبيق الداخلية التي يعتمد عليها لتحسين وقت الاستجابة في بدء التشغيل
  • سنوقف نهائيًا إصدار حزمة SDK 3.30.3 في 31 آب (أغسطس) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.30.2 2023-07-28
  • إصلاح الأخطاء غير المتوقّعة في NullPointerException التي ظهرت في الإصدار 3.30.1
  • إصلاح مشكلة في أداة Proguard التي أدّت إلى عدم إرسال بعض الأحداث من حزمة تطوير البرامج (SDK) يؤثر تصحيح هذا الخطأ في إضافة ExoPlayer ل حزمة تطوير البرامج (SDK) لعرض الإعلانات الديناميكية أثناء التشغيل في IMA.
  • توفّر التوافق مع الإصدار 8 من Gradle والإصدارات الأحدث. يجب ضبط الإصدارات السابقة من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من IMA على android.enableR8.fullMode=false فيملف gradle.properties. اطّلِع على مقالة الوضع الكامل في R8 للحصول على مزيد من المعلومات.
  • سنوقف نهائيًا استخدام الإصدار 3.30.2 من حزمة تطوير البرامج (SDK) في 3 آب (أغسطس) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.30.1 متوقّف نهائيًا 2023-04-18
  • يتضمّن هذا الإصدار مشكلة تتعلّق بخطأ NullPointerException غير متوقّع. استخدِم الإصدار الأقدم من حزمة IMA SDK لنظام التشغيل Android‏ 3.29.0 إلى أن يتم طرح إصدار أحدث يعمل بشكلٍ جيد.
  • إصلاح مشكلة تعطُّل التطبيقات التي تستخدم الإصدار 3.30.0 على الأجهزة التي لا تعمل بنظام Android TV
الإصدار 3.30.0 متوقّف نهائيًا 2023-03-29
  • يتضمن هذا الإصدار مشكلة تؤدي إلى تعطُّل التطبيقات التي لا تعمل على نظام Android TV الأساسي. استخدِم الإصدار 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android بدلاً من ذلك.
  • إضافة واجهة برمجة التطبيقات ImaSdkFactory.createVideoStitcherVodStreamRequest()
  • إضافة التوافق مع المستودع الإعلاني المختلط على Google TV
  • إزالة إمكانية استخدام واجهة برمجة التطبيقات ImaSdkFactory.createSdkOwnedPlayer() التي تم إيقافها
  • تُضيف رمز الخطأ ADS_PLAYER_NOT_PROVIDED
  • تُنشئ فئة BaseRequest التي تنفِّذها الآن كلّ من AdsRequest وStreamRequest.
  • تُضيف فئة SecureSignals.
  • تُضيف طريقة BaseRequest.setSecureSignals().
  • سنوقف نهائيًا استخدام الإصدار 3.30.0 من حزمة SDK في 18 نيسان (أبريل) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.29.0 2022-10-14
  • تعيد تسمية فئة EspVersion إلى فئة VersionInfo.
  • إعادة تسمية واجهات برمجة التطبيقات Encrypted Signals for Publishers (ESP) إلى واجهات برمجة التطبيقات Secure Signals
  • تضيف واجهات برمجة التطبيقات الخاصة بمفاتيح تبديل أوضاع الميزات. يمكنك استخدام واجهات برمجة التطبيقات لميزة "تسمية الميزة" لتفعيل ميزات معيّنة أو إيقافها في IMA. استخدِم ImaSdkSettings.getFeatureFlags() و ImaSdkSettings.setFeatureFlags() للحصول على علامات الميزات وضبطها.
  • إصلاح مشكلة عدم إرسال بعض أحداث IMA
  • إضافة androidx.webkit:webkit كعنصر تابع لحزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية
  • سنوقف نهائيًا استخدام الإصدار 3.29.0 من حزمة SDK في 29 آذار (مارس) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.28.2 2022-09-14
  • تعديل العناصر الاعتمادية لحزمة تطوير البرامج (SDK) لاستخدام AndroidX
  • سنوقف نهائيًا استخدام الإصدار 3.28.2 من حزمة SDK في 14 تشرين الأول (أكتوبر) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.28.1 متوقّف نهائيًا 2022-08-03
  • يواجه هذا الإصدار مشاكل في الأعطال على الإصدار 27 من Android والإصدارات الأقدم. استخدِم الإصدار 3.28.2 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية على Android بدلاً من ذلك.
  • إضافة واجهة برمجة التطبيقات ImaSdkFactory.createVideoStitcherLiveStreamRequest()
  • سنوقف نهائيًا استخدام الإصدار 3.28.1 من حزمة SDK في 14 أيلول (سبتمبر) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.27.1 2022-05-27
  • إصدار الخدمة، ما مِن ميزات جديدة.
  • سيتم إيقاف الإصدار 3.27.1 من حزمة SDK نهائيًا في 3 آب (أغسطس) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.27.0 2022-03-01
  • إتاحة استخدام مساحات إعلانات الشركاء المتغيرة الحجم من خلال ضبط عرض وارتفاع مساحات إعلانات الشركاء على القيمة الثابتة لـ IMA FLUID_SIZE
  • سنوقف نهائيًا استخدام الإصدار 3.27.0 من حزمة SDK في 27 أيار (مايو) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.26.0 2022-01-12
  • إضافة واجهات برمجة التطبيقات الخاصة بـ "الإشارات المشفّرة للناشرين" (ESP) (تمت إعادة تسميتها إلى الإشارات الآمنة في الإصدار 3.29.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية) يتيح ذلك للناشرين تفعيل عروض أسعار الشبكة وخدمات إدارة الهوية والوصول.
  • سنوقف نهائيًا إصدار حزمة SDK 3.26.0 في 1 آذار (مارس) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.25.1 2021-11-08
  • تُضيف AdsRenderingSettings.setEnableCustomTabs() وAdsRenderingSettings.getEnableCustomTabs() للنقر على الإعلانات داخل التطبيق باستخدام علامات تبويب مخصّصة.
  • اعتبارًا من الإصدار 3.25.1، تتضمّن حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية الإذن com.google.android.gms.permission.AD_ID في بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال أدوات إصدار Android. لمزيد من المعلومات عن بيان الإذن AD_ID ، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة مركز مساعدة Play Console هذه.
  • إتاحة استخدام معرّف مجموعة التطبيقات في حالات الاستخدام، مثل إعداد التقارير ومنع الاحتيال
  • تحسينات على الأداء عند استخدام عدّة مثيلات AdsLoader من خلال إتاحة ميزة التخزين المؤقت للخيوط وإعادة استخدامها
  • سنوقف نهائيًا استخدام الإصدار 3.25.1 من حزمة تطوير البرامج (SDK) في 12‏ كانون الثاني (يناير) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.24.0 2021-06-03
3.23.0 2021-04-07
  • تُضيف هذه السمة الطريقتَين ImaSdkSettings.setSessionId() و ImaSdkSettings.getSessionId() للحصول على رقم تعريف الجلسة وضبطه. هذا معرّف مؤقت وعشوائي يتم استخدامه حصريًا لتحديد عدد مرّات الظهور.
  • إصلاح خطأ NullPointerException في ما يتعلّق بالإعلانات المصاحبة
  • إيقاف JavaScript في الإعلانات المصاحبة التي تستخدم مستوى واجهة برمجة تطبيقات أقل من 21 لمعالجة مشكلة في الثغرات الأمنية
  • سيتم إيقاف الإصدار 3.23.0 من حزمة تطوير البرامج (SDK) نهائيًا في 3 حزيران (يونيو) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.22.3 2021-03-16
  • إصلاح خطأ NullPointerException متعلّق بإصدار الAdsLoader أثناء تحميل إعلان
  • تُضيف خطأ 1206 لحالة UNEXPECTED_ADS_LOADED_EVENT في الحالات التي يتم فيها إرسال حدث "تم تحميل الإعلانات" بشكل غير متوقّع.
  • سنوقف نهائيًا استخدام الإصدار 3.22.3 من حزمة تطوير البرامج (SDK) في 7 نيسان (أبريل) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.22.2 2021-02-26
  • تعتمد حزمة تطوير البرامج لإعلانات الوسائط التفاعلية الآن على المكتبات التالية:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • إصلاح رسالة الخطأ التي تظهر عندما يتلقّى AdsLoader خطأ بدون معرّف جلسة صالح
  • سنوقف نهائيًا استخدام الإصدار 3.22.2 من حزمة تطوير البرامج (SDK) في 16 آذار (مارس) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.22.0 2021-01-11
  • إضافة عرض مجموعات الإعلانات المتسلسلة إلى أحداث البث المباشر المستندة إلى الإعلانات الديناميكية في سير عمل عرض المجموعات الإعلانية، يكون "مدير إعلانات Google" مسؤولاً فقط عن عرض الإعلانات. يتحمّل الناشرون مسؤولية المحتوى وإنشاء البيان الذي سيشير بعد ذلك إلى "مدير إعلانات Google". استخدِم ImaSdkFactory.createPodStreamRequest() لإنشاء طلب بث لعرض مجموعة قنوات. في حال استخدام هذا الإجراء، ستكون مسؤولاً عن تحميل البث على streamInit().
  • إصلاح تسرُّب الذاكرة الناتج عن عدم تنظيف مراقب دورة حياة التطبيق بشكل صحيح
  • سنوقف نهائيًا استخدام الإصدار 3.22.0 من حزمة تطوير البرامج (SDK) في 26 شباط (فبراير) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.4 2020-12-09
  • إزالة رسالة تحذير غير ضارة متعلقة بالاتصال adsLoader.release() بعد إغلاق webview
  • سنوقف نهائيًا استخدام الإصدار 3.21.4 من حزمة تطوير البرامج (SDK) في 8 كانون الثاني (يناير) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.2 2020-11-20
  • إصلاح المشاكل غير المتوقّعة المتعلقة بأمان مؤشرات الترابط والتي تحدث بسبب إرسال تعديلات الرسائل من قائمة انتظار فارغة
  • تعديل المستندات المتعلّقة بتطبيق AdsLoader.release()
  • سيتم إيقاف الإصدار 3.21.2 من حزمة SDK نهائيًا في 9 كانون الأول (ديسمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.1 2020-11-17
  • إصلاح مشكلة كانت تؤدي أحيانًا إلى تعطُّل التطبيق عند بدء الأحداث
  • سيتم إيقاف الإصدار 3.21.1 من حزمة تطوير البرامج (SDK) نهائيًا في 20 تشرين الثاني (نوفمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.0 2020-10-23
  • إتاحة عرض الإعلانات المستندة إلى معرّف شريحة SIM في حزمة تطوير البرامج (SDK) لعرض الإعلانات الديناميكية أثناء التشغيل على Android
  • تضيف الطريقة AdsLoader.release() وتوقِف استخدام BaseDisplayContainer.destroy(). يحلّ هذا التغيير مشكلة تسرُّب الذاكرة التي حدثت عند التخلص من BaseDisplayContainer في منتصف جدول عرض إعلانات VMAP. AdsLoader.release() هي الطريقة الجديدة المقترَحة للتخلص من عناصر حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية، بدلاً من استخدام BaseDisplayContainer.destroy().
  • سيتم إيقاف الإصدار 3.21.0 من حزمة تطوير البرامج (SDK) نهائيًا في 17 تشرين الثاني (نوفمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.20.1 2020-10-12
  • حلّ مشكلة في تطبيقات HTMLResource المصاحبة على الإصدار 29 من واجهة برمجة التطبيقات أو الإصدارات الأحدث من Android لمزيد من التفاصيل، يُرجى الاطّلاع على مستند التغيير في سلوك Android API.
  • سيتم إيقاف الإصدار 3.20.1 من حزمة تطوير البرامج (SDK) نهائيًا في 23 تشرين الأول (أكتوبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.20.0 2020-08-18
  • الإصدار 3.20.0 هو أول إصدار سيتأثّر ب التغييرات في سلوك الإيقاف المؤقت في IMA. إذا كنت تستخدم هذا الإصدار أو أي إصدار مستقبلي من حزمة SDK، ننصحك بقراءة مقالة المدونة وإجراء التغييرات على سلوك الإيقاف المؤقت في تطبيقك. يمكن للناشرين اختبار تنفيذ هذه التغييرات باستخدام علامة الإعلان الاختبارية.
  • تضيف دالتا callback onPause() وonResume() إلى فئة DAI VideoStreamPlayer.
  • تضيف الطريقة adPeriodDuration() إلى فئة AdProgressInfo.
  • إتاحة استخدام صور احتياطية عند النقر على الرموز على أجهزة Android TV
  • تُضيف القيمة ICON_FALLBACK_IMAGE_CLOSED الحدث الذي يتم التعامل معه عند إغلاق الصورة الاحتياطية للرمز على أجهزة Android TV.
  • إزالة طريقة focusSkipButton() التي تم إيقافها نهائيًا من AdsManager واستبدالها بطريقة focus()
  • بالنسبة إلى أجهزة التلفزيون المتّصلة، يتم الآن التركيز على الإعلانات تلقائيًا عند بدء حدث AdEvent.AdEventType STARTED. لإيقاف ميزة التركيز التلقائي على الإعلانات، استخدِم أسلوب adsRenderingSettings.setFocusSkipButtonWhenAvailable(false) ثم استخدِم أسلوب focus() استنادًا إلى المتطلبات المخصّصة.
  • تضيف الطريقة getCurrentTimeMs() و getDurationMs إلى فئة VideoProgressUpdate().
  • إيقاف الطريقتَين getCurrentTime و getDuration نهائيًا واستبدالهما بالطريقتَين الجديدتَين getCurrentTimeMs وgetDurationMs
  • إصلاح مشكلة في أحداث البث المباشر باستخدام DASH حيث لم يكن يتم تسجيل أحداث الإعلانات بشكل صحيح
  • سنوقف نهائيًا استخدام الإصدار 3.20.0 من حزمة تطوير البرامج (SDK) في 12 تشرين الأول (أكتوبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.4 2020-07-08
  • تم إصلاح مشكلة كانت تمنع setLoadVideoTimeout من تعديل مهلة الانتظار بشكل صحيح.
  • سنوقف نهائيًا استخدام الإصدار 3.19.4 من حزمة تطوير البرامج (SDK) في 18 آب (أغسطس) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.3 2020-06-29
  • إصلاح مشكلة في دمج إطار الشفافية والموافقة الصادر عن مكتب IAB في ما يتعلّق بـ "اللائحة العامّة لحماية البيانات" (GDPR) والتي تسبّبت في حدوث أعطال في الأجهزة المشغّلة للّاعبين التي تم دمجها مع حِزم تطوير البرامج (SDK) لمنصّة إدارة الموافقة
  • سنوقف نهائيًا استخدام الإصدار 3.19.3 من حزمة تطوير البرامج (SDK) في 8 تموز (يوليو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.2 2020-06-22
  • إصلاح مشكلة كانت تؤدي إلى تجاهل حزمة تطوير البرامج (SDK) لأحداث VideoAdPlayerCallback.onContentComplete() خارج نطاق تشغيل الإعلان
  • تضيف هذه السمة إمكانية تحديد مجموعات مختلفة من الترجمة والشرح المستندة إلى الذكاء الاصطناعي للغة نفسها باستخدام المَعلمة subtitle_name لملف VideoStreamPlayer.loadUrl().
  • سيتم إيقاف الإصدار 3.19.2 من حزمة SDK نهائيًا في 29 حزيران (يونيو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.0 2020-05-12
3.18.1 2020-03-25
  • تضيف هذه الميزة إمكانية تغيير حجم "الإعلانات المصاحبة" على الأجهزة ذات كثافة البكسل العالية.
  • إتاحة إعلانات معرّفات شرائح SIM من جهة العميل
  • سنوقف نهائيًا استخدام الإصدار 3.18.1 من حزمة تطوير البرامج (SDK) في 12 أيار (مايو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.18.0 2020-03-04
  • تُضيف هذه الوظيفة دالةَي pause() وresume() إلى واجهة VideoStreamPlayer يجب تنفيذ هذه التغييرات في الإصدار 3.18.0 والإصدارات الأحدث.
  • سنوقف نهائيًا استخدام الإصدار 3.18.0 من حزمة تطوير البرامج (SDK) في 25 آذار (مارس) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.17.0 2020-02-07
3.16.5 2020-01-22
  • تتيح ميزة "إعادة العمل" استخدام ‎contentUrl في OMID 1.3 مع AdsRequest.setContentUrl و StreamRequest.setContentUrl .
  • تتيح عمليات إعادة العمل استخدام العوائق المتوافقة مع OMID 1.3 باستخدام FriendlyObstruction .
  • إيقاف الطريقتَين BaseDisplayContainer.registerVideoControlsOverlay وBaseDisplayContainer.unregisterAllVideoControlsOverlay نهائيًا واستبدالهما بالطريقة FriendlyObstruction
  • حلّ مشكلة تتعلّق بخطأ NullPointerException الذي يحدث بعد الاتصال بخطأ clear() على CompanionAdSlots
  • إصلاح مشكلة كانت تؤدي على الأرجح إلى تسرُّب الذاكرة عند استدعاء destroy() أثناء تشغيل الإعلان
  • سيتم إيقاف الإصدار 3.16.5 من حزمة تطوير البرامج (SDK) نهائيًا في 7 شباط (فبراير) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.16.2 2019-12-05
  • إتاحة تضمين مَعلمات الموافقة تلقائيًا من الإصدار 2 من إطار الشفافية والموافقة الصادر عن مكتب IAB وقانون خصوصية المستهلك في كاليفورنيا (CCPA)
  • يتطلب استخدام الإعدادات المفضّلة في Android الآن حزمة androidx.
  • سيتم إيقاف الإصدار 3.16.2 من حزمة تطوير البرامج (SDK) نهائيًا في 22 كانون الثاني (يناير) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.16.1 2019-11-08
3.16.0 2019-10-23
  • تُضيف هذه الطريقة الأسلوب replaceAdTagParameters إلى StreamManager، ما يتيح إمكانية استبدال جميع مَعلمات علامة الإعلان أثناء البث المباشر.
  • إزالة إمكانية استخدام الطرق التالية المتوقّفة نهائيًا:
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()
  • سنوقف نهائيًا استخدام الإصدار 3.16.0 من حزمة SDK في 8 تشرين الثاني (نوفمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.14.0 2019-09-11
  • إصدار الخدمة، ما مِن ميزات جديدة.
  • سيتم إيقاف الإصدار 3.14.0 من حزمة SDK نهائيًا في 23 تشرين الأول (أكتوبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.13.1 2019-09-03
  • تضيف هذه الميزة إمكانية ضبط سياق التشغيل المتواصل لطلب إعلان. لمزيد من التفاصيل، يُرجى الاطّلاع على setContinuousPlayback().
  • تُضيف هذه الطريقة الأسلوب getUniversalAdIds() إلى فئة Ad.
  • إضافة الأنواع التالية: setAuthToken، getAuthToken، setFormat، getFormat وStreamFormat enum
  • إصلاح خطأ في أجهزة Nexus 5 يحدث عند إزالة حاوية قبل تلقّي استجابة إعلان
  • تم حلّ مشكلة عدم ظهور الإعلانات المصاحبة إلا مرّة واحدة.
  • إصلاح مشكلة عدم تعذُّر عرض أنواع الإعلانات غير المتوافقة (الإعلانات غير الخطية وVPAID) بشكلٍ سلس
  • سنوقف نهائيًا استخدام الإصدار 3.13.1 من حزمة SDK في 11 أيلول (سبتمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.11.3 2019-06-11
  • إصلاح خلل في إعداد is_lat على أجهزة AOSP
  • سيتم إيقاف الإصدار 3.11.3 من حزمة SDK نهائيًا في 3 أيلول (سبتمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.11.2 2019-04-16
  • إصلاح العُطل التالي: java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap"
  • سيتم إيقاف الإصدار 3.11.0 من حزمة SDK نهائيًا في 11 حزيران (يونيو) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.11.0 متوقّف نهائيًا 2019-03-22
3.10.9 2019-03-13
  • تم إصلاح خلل في حالة السباق حيث لا يتم أحيانًا عرض واجهة مستخدم الإعلان في الإعلانات اللاحقة بعد تخطّي الإعلان الأول.
  • تم إصلاح عطل حدث عند استدعاء واجهة برمجة التطبيقات getCompanionAds().
  • سنوقف نهائيًا استخدام الإصدار 3.10.7 من حزمة تطوير البرامج (SDK) في 22 آذار (مارس) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.10.7 2019-02-19
  • تُضيف أحداث الإعلانات onAdPeriodStarted() وonAdPeriodEnded(). تتوفّر هذه الأحداث لميزة "الاستهداف الإعلاني أثناء التصفّح" فقط.
  • سنوقف نهائيًا استخدام الإصدار 3.10.6 من حزمة SDK في 13 آذار (مارس) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.10.6 2019-01-23
  • لإضافة طريقة seek() إلى واجهة مشغّل البث
  • إضافة إمكانية استخدام AD_BUFFERING لعمليات استدعاء أحداث الإعلانات
  • يجب عدم تمرير الحاويات في طلب الإعلان بعد الآن. يتطلب سير العمل الجديد تمرير حاوية من خلال AdsLoader منشئ.
  • تُضيف طريقة BaseDisplayContainer.destroy().
  • إصلاح تسرُّب الذاكرة الذي حدث عند اكتمال تشغيل الفيديو
  • إيقاف requestNextAdBreak ستتم إزالة واجهة برمجة التطبيقات هذه في إصدار مستقبلي. بعد ذلك، سيتم جلب الإعلانات تلقائيًا قبل 4 ثوانٍ من وقت بدء الفاصل الإعلاني.
  • سيتم إيقاف الإصدار 3.10.2 من حزمة تطوير البرامج (SDK) نهائيًا في 19 شباط (فبراير) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.10.2 2018-11-13
  • إصلاح حالة تنافُس تؤدي إلى ظهور خطأ VAST 402 في الإعلان الثاني ضمن مجموعة إعلانية
  • تضيف هذه الميزة ميزة تحديد عدد مرّات الظهور والاستبعاد التنافسي إلى حزمة تطوير البرامج (SDK) لعرض الإعلانات الديناميكية أثناء التشغيل على Android.
  • نقل getAdProgressInfo() من StreamManager إلى BaseManager
  • إضافة getVastMediaHeight() وgetVastMediaWidth() وgetVastMediaBitrate() إلى Ad
  • سيتم إيقاف الإصدار 3.9.4 من حزمة SDK نهائيًا في 23‏ كانون الثاني (يناير) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.9.4 2018-08-01
  • تضيف getCompanionAds() إلى Ad. يؤدي ذلك إلى عرض الإعلانات المصاحبة عند استخدام ميزة "العرض الإعلاني أثناء التشغيل" فقط.
  • تُضيف فئة CompanionAd جديدة.
  • تضيف حدث SKIPPABLE_STATE_CHANGED جديدًا إلى AdEvent.
  • إصلاح مشكلة عدم الالتزام بالإعداد التلقائي لـ focusSkipButtonWhenAvailable في بعض الحالات
  • سنوقف نهائيًا استخدام الإصدار 3.9.0 من حزمة SDK في 1 آب (أغسطس) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.9.0 2018-07-09
  • أصبح تطبيق YouTube متوافقًا الآن مع Android TV.
  • تضيف focusSkipButton() إلى AdsManager. لن تعمل هذه الميزة إلا على Android TV.
  • تضيف getFocusSkipButtonWhenAvailable() إلى AdsRenderingSettings، ويكون الإعداد التلقائي هو true. لن تعمل هذه الميزة إلا على Android TV.
  • تضيف setFocusSkipButtonWhenAvailable() إلى AdsRenderingSettings. لن تعمل هذه الميزة إلا على Android TV.
  • VideoAdPlayer يوفّر الآن واجهة VolumeProvider. أصبح تنفيذ هذه الواجهة مطلوبًا الآن لتشغيل الفيديوهات المخصّصة.
  • سنوقف نهائيًا استخدام الإصدار 3.8.7 من حزمة SDK في 9 تموز (يوليو) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.8.7 2018-05-23
  • السماح بعرض الصور المتحركة في الإعلانات المصاحبة التي تستخدم HTML
  • سنوقف نهائيًا استخدام الإصدار 3.8.5 من حزمة تطوير البرامج (SDK) في 23 أيار (مايو) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.8.5 2018-04-09
  • حلّ مشكلة تجاهل ImaSdkSettings
  • إصلاح مشكلة تعارضات الإنشاء مع ملفات إصدار com.android.support
  • تضيف setAdWillPlayMuted إلى AdsRequest.
  • تضيف setLoadVideoTimeout إلى AdsRenderingSettings.
  • سنوقف نهائيًا استخدام الإصدار 3.8.2 من حزمة SDK في 9 نيسان (أبريل) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.8.2 2018-01-24
  • لإضافة setLiveStreamPrefetchSeconds إلى AdsRequest
  • إصلاحات متنوّعة في المستندات
  • سنوقف نهائيًا استخدام الإصدار 3.7.4 من حزمة تطوير البرامج (SDK) في 24 كانون الثاني (يناير) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.7.4 2017-06-29
  • تضيف setVastLoadTimeout إلى AdsRequest.
  • تضيف getSkipTimeOffset إلى Ad.
  • سنوقف نهائيًا استخدام الإصدار 3.7.2 من حزمة SDK في 29 حزيران (يونيو) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.7.2 2017-05-25
  • تضيف setDebugMode إلى ImaSdkSettings.
  • سنوقف نهائيًا استخدام الإصدار 3.7.1 من حزمة تطوير البرامج (SDK) في 25 أيار (مايو) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.7.1 2017-03-24
  • حلّ تعارض مساحة الاسم عند استخدام Proguard
  • تم تقليل حجم حزمة JAR بمقدار 30 كيلوبايت تقريبًا.
  • سيتم إيقاف الإصدار 3.7.0 من حزمة SDK نهائيًا في 24 آذار (مارس) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.7.0 2017-03-13
  • إصلاح مشكلة دمج بعض فئات IMA عن طريق الخطأ في حزمة a.a.a.a في ProGuard
  • سنوقف نهائيًا استخدام الإصدار 3.6.0 من حزمة SDK في 13 آذار (مارس) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.6.0 2017-02-16
  • تُضيف ما يلي إلى Ad:
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • إضافة AdsManager.requestNextAdBreak().
  • تُضيف ما يلي إلى AdsRenderingSettings:
    • setEnablePreloading()
    • getEnablePreloading()
  • تُضيف ما يلي إلى AdsRequest:
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • سنوقف نهائيًا استخدام الإصدار 3.5.2 من حزمة SDK في 16 شباط (فبراير) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.5.2 2016-11-14
  • تضيف هذه الطريقة مشغل فيديو تابعًا لحزمة تطوير البرامج (SDK) يتولى تشغيل الإعلانات اختياريًا.
  • تضيف CompanionAdSlot.ClickListener وطُرقًا لإضافة مستمع وإزالته.
  • إصلاح مشكلة في سجلّات أخطاء getViewability() غير الصالحة
  • إصلاح مشكلة في سلوك النقر على الرموز وعدم عرضها بشكل صحيح
  • سيتم إيقاف الإصدار 3.4.0 من حزمة SDK نهائيًا في 14‏ تشرين الثاني (نوفمبر) 2017. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.4.0 2016-09-12
  • إصلاح خطأ الملفات المكرّرة عند استخدام الإصدار 9.0.0 من "خدمات Google Play" والإصدارات الأحدث
3.3.2 2016-07-11
3.3.0 2016-05-31
3.2.1 2016-04-07
  • إصدار الخدمة، ما مِن ميزات جديدة.
3.1.3 2015-12-16
  • الإصدار العلني
  • تُضيف هذه الإضافة AdsManager.discardAdBreak إلى واجهة برمجة التطبيقات.
3.b13.3 (إصدار تجريبي) 2015-09-10
  • إصدار الخدمة، ما مِن ميزات جديدة.
3.b12.1 (إصدار تجريبي) 2015-07-20
3.b11.4 (إصدار تجريبي) 2015-05-21
  • تضيف الميزة ما يلي إلى واجهة برمجة التطبيقات:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
3.b10.3 (إصدار تجريبي) 2015-03-24
  • تمت إضافة ImaSdkSettings.getMaxRedirects وImaSdkSettings.setMaxRedirects.
  • أصبحت فئات IMA API الآن final.
  • أصبحت أرقام إصدارات حزمة SDK الآن بالتنسيق 3.bX.Y مع b للإشارة إلى حالة الإصدار التجريبي لحزمة SDK.
  • تمت إزالة قيم AdError.AdErrorCode التالية:
    • ‫API_ERROR - استخدِم UNKNOWN_AD_RESPONSE بدلاً منه.
    • ‫PLAYLIST_MALFORMED_RESPONSE - استخدِم UNKNOWN_AD_RESPONSE بدلاً منه.
    • REQUIRED_LISTENERS_NOT_ADDED - لم تكن حزمة SDK تنشئ هذا الخطأ.
    • ‫VAST_INVALID_URL - استخدِم VAST_LOAD_TIMEOUT بدلاً منه.
الإصدار التجريبي 9 2014-10-17
  • تضيف واجهات برمجة التطبيقات لإعلانات Google‏ getTitle وgetDescription وgetContentType.
  • تُضيف هذه السمة معلومات عن موضع مجموعة الإعلانات إلى واجهة مستخدِم الإعلان، على سبيل المثال: "الإعلان 1 من 4: (0:13)".
  • من المفترض ألا تتمكّن بعد الآن من التحكّم مباشرةً في إيقاف الإعلانات مؤقتًا أو تشغيلها أو استئناف عرضها باستخدام مشغّل الفيديو. بدلاً من ذلك، استخدِم AdsManager.pause() وAdsManager.resume().
الإصدار التجريبي 8 2014-06-12
  • إصلاح مشكلة عدم محو واجهة مستخدِم الإعلان للإعلانات القابلة للتخطّي
  • توثيق رمز الخطأ لوقت الاستراحة في تحميل ملفات الوسائط
الإصدار التجريبي 7 2014-05-27
الإصدار التجريبي 6 2014-04-14
  • إتاحة استخدام علامة VAST 3
  • إضافة دعم جزئي لـ VMAP (مساواة مع قواعد الإعلانات الحالية في "مدير إعلانات Google")
  • تضيف الميزة ما يلي إلى واجهة برمجة التطبيقات:
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • إصلاح خلل كان يؤدي إلى تخطّي جميع الإعلانات الأخرى في مجموعة الإعلانات المتسلسلة عند عرض إعلانات أثناء التشغيل في مجموعة إعلانات متسلسلة محسّنة ومزوّدة بغلاف
  • لن يتم تجاهل AdsRenderingSettings التي تم تمريرها إلى AdsManager بعد الآن.
  • تم إصلاح عدة أخطاء لتعزيز ثبات النظام.
الإصدار التجريبي 5 2013-12-12
  • حلّ مشكلة الإعلانات القابلة للتخطّي في قوائم التشغيل
الإصدار التجريبي 4 2013-10-15
  • تمت إضافة إمكانية إعادة ضبط قيم المرتبط من خلال استدعاء contentComplete في AdsLoader.
الإصدار التجريبي 3 2013-09-05
  • إصدار الخدمة، ما مِن ميزات جديدة.
الإصدار التجريبي 2 2013-07-07
  • الإصدار العلني للإصدار التجريبي من حزمة SDK
الإصدار 2 من الإصدار التجريبي المغلق 2013-06-24
  • تمت إضافة واجهة برمجة تطبيقات لضبط لغة واجهة المستخدم في عنصر ImaSdkSettings. يُرجى العِلم أنّ هذا الإعداد يُستخدَم لضبط لغة واجهة المستخدم، وليس لغة الإعلان.
  • تم إصلاح تعارض كان يحدث عندما يتضمّن التطبيق كلّ من مكتبتَي IMA SDK وAdMob SDK.
  • تمت إضافة تسجيل لمقاييس الأداء الداخلية المختلفة.
الإصدار 1 من الإصدار التجريبي المغلق 2013-04-02

  • الإصدار التجريبي الأولي في ما يلي المشاكل المعروفة في الإصدار التجريبي:

    المراجع ذات الصلة بحِزم SDK

    إنّ AdEvents التالية المتوفّرة في حزمة تطوير البرامج لإعلانات الوسائط التفاعلية بتنسيق HTML5 غير متوافقة مع الإصدار 3 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على Android: IMPRESSION، LOG، SKIPPABLE_STATE_CHANGED، STOPPED، VOLUME_CHANGED، VOLUME_MUTED

    أمثلة على المحتوى ذي الصلة بالتطبيق

    1. هناك مشكلة متقطّعة تؤدي إلى عدم استئناف مشغّل الإعلان بشكل صحيح بعد أن ينقر المستخدِم على إعلان. على سبيل المثال، في بعض الأحيان، عند العودة إلى التطبيق بعد النقر على إعلان، يؤدي استئناف تشغيل هذا الإعلان إلى التخطّي إلى النهاية وإكماله، بدلاً من استئناف تشغيله من حيث توقف قبل النقر عليه.
    2. الإعلانات التي تعرضها علامة الإعلان "الإعلانات أثناء عرض الفيديو 2" غير متوافقة مع الإصدار 3 من أداة تطوير البرامج لإعلانات الوسائط التفاعلية على Android.
    3. لا يوقف مشغّل العيّنات إمكانية التقديم أو الإيقاف تلقائيًا أثناء عرض الإعلانات. احرص على إيقاف ميزة تقديم/ترجيع الفيديو في مشغّل الفيديو أثناء عرض الإعلانات.