سابقه انتشار کیت توسعه نرم‌افزار Google IMA tvOS

نسخه تاریخ انتشار یادداشت‌ها
4.18.1 2026-10-22
  • ویژگی IMASettings.preloadTime را اضافه می‌کند تا زمانی را برای شروع بار کردن وقفه‌های آگهی میان‌ویدیویی قبل‌از زمان شروع وقفه آگهی تنظیم کند. اگر تنظیم نشده باشد، زمان پیش‌بارگیری به‌طور پیش‌فرض هشت ثانیه است.
  • ویژگی IMAAdsRenderingSettings.prerollLoadVideoTimeout را اضافه می‌کند تا مدت‌زمان انتظار (به ثانیه) برای بار شدن آگهی‌های پیش‌پخش را قبل‌از لغو بازپخش آگهی و پخش محتوا تنظیم کند.
  • مشکلی را برطرف می‌کند که در آن کاربران نمی‌توانستند آگهی‌ها را درصورت روشن بودن tvOS VoiceOver رد کنند.
4.17.0 2026-05-29
  • پشتیبانی از آگهی‌های قابل‌ردشدن را با جاری‌سازی‌های فعال‌شده بینابینی HLS اضافه می‌کند.
  • بررسی زمان ترجمه را برای تأیید اینکه نسخه tvOS هدف برنامه شما با حداقل نسخه tvOS کیت توسعه نرم‌افزار IMA سازگار است اضافه می‌کند.
  • کدهای خطا را به IMAAdError enum اضافه می‌کند:
    • ‫kIMAError_ASSET_FALLBACK_FAILED:‏ 1021
    • ‫kIMAError_UNSUPPORTED_URL:‏ 1022
    • ‫kIMAError_STREAM_INITIALIZATION_TIMEOUT: 1023
    • ‫kIMAError_STREAM_AUTHORIZATION_FAILED: 1024
  • روش IMASettings.featureFlags() را به‌روز می‌کند تا هر نوع شیء را به‌عنوان مقدار بپذیرد.
4.16.0 2025-10-23
  • حداقل نسخه tvOS را برای کامپایل به tvOS 15 افزایش می‌دهد.
  • پارامتر useHLSInterstitial را برای فعال کردن پشتیبانی از آگهی بینابینی برای میاناهای IMALiveStreamRequest و IMAVODStreamRequest اضافه می‌کند.
4.15.1 2025-05-07
  • اطلاعات دوره آگهی را به رویداد AD_PERIOD_STARTED اضافه می‌کند، که می‌توانید از ویژگی IMAAdEvent.adData به آن دسترسی داشته باشید.
  • پشتیبانی از مدیریت فراداده‌های میان‌آگهی HLS با کیت توسعه نرم‌افزار IMA را اضافه می‌کند.
4.14.1 2024-12-03
  • کد شبکه را به فهرست پارامترهای درخواست جاری‌سازی برای همه انواع جاری‌سازی اضافه می‌کند.
  • وقتی روی نشانی وب کلیک مستقیم نامعتبر کلیک می‌شود، رویداد LOG را فعال می‌کند، به‌جای اینکه بی‌صدا ناموفق شود.
  • نشت حافظه را که هنگام ازبین رفتن نامناسب جلسه‌های OMID رخ می‌داد برطرف می‌کند.
  • پشتیبانی از آگهی‌های ردشدنی را در جاری‌سازی‌های «ارائه پاد ویدیوی درخواستی» اضافه می‌کند.
  • اشکال مربوط به پشتیبانی پیمایش را وقتی ویدیو در محفظه پیمایش‌پذیر جاسازی شده است برطرف می‌کند.
  • پشتیبانی از minSuggestedDuration را به آگهی‌های غیرخطی اضافه می‌کند
  • اشکالی را برطرف می‌کند که باعث می‌شد برخی‌از نشانی‌های وب ردگیری «مدیر پویش» به‌درستی کدبندی نشوند.
  • مشکلی را برطرف می‌کند که باعث می‌شد رویدادهای STARTED در برخی‌از جلسه‌های آگهی ارسال نشود.
4.13.0 2024-06-13
  • VODConfigID را به IMAVideoStitcherVODStreamRequest اضافه می‌کند.
  • ‫nullpointerexception را وقتی adTagURL null در IMAAdsRequest است برطرف می‌کند.
  • منطق جایگزین سطح دارایی را تغییر می‌دهد تا همه آگهی‌ها را در VAST اصلی تکرار کند تا زمانی‌که کیت توسعه نرم‌افزار طرح‌آگهی قابل‌پخشی را شناسایی کند. اگر طرح آگهی قابل‌پخشی پیدا نشود، آگهی پخش نمی‌شود.
  • مشکلی را که در آن پینگ‌های ردیابی به ad.doubleclick.net ارسال نمی‌شد برطرف می‌کند.
  • محدودیت‌های رندر کردن اندازه آگهی SDK را براساس قاب نما به‌جای راهنمای چیدمان منطقه ایمن برای playerView تنظیم می‌کند.
4.12.0 2024-04-03
4.11.1 2024-02-22
  • مشکلی را برطرف می‌کند که باعث می‌شد صدای محتوا درطول بازپخش آگهی شنیده شود.
4.10.0 2024-01-24
  • درخواست‌های جاری‌سازی VOD «ارائه Pod» را فعال می‌کند.
  • محدودیت‌های AdUI را به‌روز می‌کند تا از راهنماهای منطقه امن پیروی کند.
  • افزودن گیرنده برای نقاط نشان به مدیر جاری‌سازی iOS/tvOS
4.9.2 2023-08-15
  • اشکالی که باعث استفاده زیاد از واحد پردازش مرکزی برای برخی‌از جاری‌سازی‌های «درج آگهی پویا» می‌شد برطرف شد.
4.9.1 2023-04-20
4.8.2 2022-11-03
  • ‫userContext به درخواست‌های جاری‌سازی IMA اضافه شد.
  • اشکالی که باعث می‌شد هشدارهای غیرضروری «پیام داخلی نامعتبر» نشان داده شود برطرف شد.
4.7.0 2022-07-20
  • مشکل مربوط به بازنویسی اطلاعات نسخه کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی توسط ناشران برطرف شد.
  • AD_CAN_PLAY رویداد اضافه شد. وقتی آگهی آماده پخش بدون میان‌گیری باشد، فعال می‌شود.
  • حداکثر نرخ بیت پیش‌فرض برای دستگاه‌های غیرهمراه به نامحدود افزایش یافت.
4.6.1 2022-02-23
  • انتشار سرویس؛ بدون تغییرات عمومی.
4.5.0 2021-12-06
  • حداقل نسخه tvOS به tvOS 12 ارتقا یافت.
  • اشکالی که می‌توانست منجر به چند نماد «چرا این آگهی» شود برطرف شد.
  • نیاز به MPNowPlayingSession برداشته شد.
4.4.2 2021-05-03
  • مشکلی که باعث نمایش پیام‌های هشدار در tvOS < 12 می‌شد برطرف شد.
  • آخرین نسخه IMA SDK برای iOS که از tvOS 10 پشتیبانی می‌کند.
4.4.1 2021-03-09
  • ویژگی IMASettings.sessionID اضافه شد تا ناشران بتوانند شناسه جلسه خود را به‌صورت دستی تنظیم کنند.
  • پشتیبانی از «تصویر در تصویر» اضافه شد.
  • مشکلی که باعث می‌شد رویدادهای توقف موقت و ازسرگیری آگهی گاهی درطول محتوا اجرا شوند برطرف شد.
  • IMAVideoDisplay.nowPlayingSession اضافه شد تا از رویدادهای پخش/توقف موقت در tvOS 14+‎ به‌درستی پشتیبانی شود.
  • اشکالی برطرف شد که در آن آگهی‌های خطی AdSense به‌عنوان غیرخطی به ناشر گزارش می‌شد.
  • مشکلی که باعث می‌شد IMAStreamManager.replaceAdTagParameters به‌روزرسانی صادر نکند برطرف شد.
  • میاناهای برنامه‌سازی کاربردی ارائه پاد اضافه شد.
  • پیوست adContainer به پنجره اعمال شد.
4.3.2 2020-08-11
4.3.1 2020-08-05
  • پشتیبانی از حالت «رضایت تکمیلی» Google اضافه شد. برای اطلاعات بیشتر، به مشخصات فنی «حالت رضایت تکمیلی» Google مراجعه کنید.
  • پشتیبانی از کلید «language_name» برای زیرنویس‌های جاری‌سازی اضافه شد.
  • مشکلی که باعث می‌شد آگهی‌های فقط صوتی با اتمام مهلت مواجه شوند برطرف شد.
  • مشکلی که باعث می‌شد رد کردن اولین آگهی در پیش‌پخش باعث شود آگهی دوم از رد کردن خود صرف‌نظر کند برطرف شد.
  • IMAAdDisplayContainer.focusEnvironment اضافه شد که به ناشران اجازه می‌دهد درطول وقفه‌های آگهی، تمرکز را به کیت توسعه نرم‌افزار منتقل کنند. این کار هر زمان که کاربر نیاز به تعامل با واسط کاربر آگهی داشته باشد (مثلاً آگهی‌های قابل‌ردشدن، نمادهای VAST) الزامی است.
  • ‫viewController به‌عنوان ویژگی یا شناسه مقداردهی اولیه الزامی جدید برای IMAAdDisplayContainer اضافه شد.
  • پشتیبانی بومی‌سازی غیرانگلیسی اصلاح شد.
  • رویدادهای اشتباه RESUME کاهش یافت.
  • IMAAdsRenderingSettings.enablePreloading اضافه شد که به‌طور پیش‌فرض فعال است تا عملکرد پردازاندن آگهی را بهبود بخشد.
  • پشتیبانی از آگهی‌های قابل‌ردشدن (سمت کارخواه و ویدیو به‌درخواست) و نمادهای VAST (سمت کارخواه و درج آگهی پویا) اضافه شد
  • رویدادهای ICON_FALLBACK_IMAGE_CLOSED و ICON_TAPPED اضافه شد. توصیه می‌کنیم ازسرگیری خودکار را روی ICON_FALLBACK_IMAGE_CLOSED تنظیم کنید زیرا کیت توسعه نرم‌افزار هنگام باز شدن تصویر جایگزین موقتاً متوقف می‌شود.
  • مشکلی که باعث می‌شد IABTCF_gdprApplies فقط درصورت رشته بودن تأیید شود برطرف شد.
4.2.3 2020-05-06
  • مشکلی که در آن برخی‌از شناسه‌های app bundle می‌توانستند باعث شوند ترافیک به‌اشتباه طبقه‌بندی شود برطرف شد.
4.2.2 2020-03-26
  • حداقل نسخه زمان اجرا به tvOS 10 افزایش یافت
  • اشکالی که باعث می‌شد برخی‌از به‌روزرسانی‌های واسط کاربر در رشته پس‌زمینه راه‌اندازی شود برطرف شد
  • مشکلی که باعث می‌شد پرچم‌های سخت‌گیرانه باعث تداخل init مربوط به IMACompanionAd با NSObject شود برطرف شد.
  • روش loadURL در پروتکل IMAVideoDisplay منسوخ شده است
4.2.1 2020-02-12
  • نسخه ۴.۲.۱ آخرین نسخه 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 منسوخ‌شده 2019-07-02
  • کیت‌های توسعه نرم‌افزار tvOS درج آگهی پویا و سمت کارخواه ترکیبی
  • مشکلی که باعث می‌شد AdsLists تجزیه نشود و خطاهای AdsLoader در tvOS ایجاد شود برطرف شد.

نمایش نسخه‌های قبلی

نسخه تاریخ انتشار یادداشت‌ها
3.9.1 2019-03-28
  • زمان اتمام مقداردهی اولیه پیش‌فرض جاری‌سازی از ۵ ثانیه به ۸ ثانیه تغییر کرد.
  • ویژگی 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
  • اشکالی را برطرف می‌کند که در آن نشانی‌های وب ردیابی حاوی آکولاد («{» یا «}») در 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.
  • اکنون کیت توسعه نرم‌افزار هنگام پیوستن به جاری‌سازی در وسط وقفه آگهی، 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
  • پشتیبانی از بیت‌کد را اصلاح می‌کند.
  • ویژگی‌های زیر را به AdBreakInfo اضافه می‌کند:
    • adBreakIndex
    • timeOffset
3.3.0 2016-12-05
  • ‫[IMAAVPlayerVideoDisplay reset] را آشکار می‌کند تا وقتی لازم است AVPlayerItem را در پخش‌کننده محتوایتان با AVPlayerItem پشتیبان جایگزین کنید، فراخوانی شود.
3.2.0 2016-08-22
  • مشکلی را که هنگام ارسال برنامه‌ای که از چارچوب برای آزمایش استفاده می‌کند رخ می‌دهد برطرف می‌کند.
3.1.0 2016-05-09
  • نسخهٔ پخش اولیه.