Google IMA tvOS SDK 版本記錄

版本 推出日期 注意事項
4.18.1 2026-10-22
  • 新增 IMASettings.preloadTime 屬性，設定在廣告插播開始時間前，載入片中廣告插播的時間。如未設定，預先載入時間預設為 8 秒。
  • 新增 IMAAdsRenderingSettings.prerollLoadVideoTimeout 屬性，設定等待片頭廣告載入的秒數，超過這個時間就會取消廣告播放，並開始播放內容。
  • 修正問題：啟用 tvOS VoiceOver 時，使用者無法略過廣告。
4.17.0 2026-05-29
  • 新增支援啟用 HLS 插頁式廣告的串流，可放送可略過廣告。
  • 新增編譯時間檢查，驗證應用程式的目標 tvOS 版本是否與 IMA SDK 最低 tvOS 版本相容。
  • 在 IMAAdError 列舉中新增錯誤代碼：
    • 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 屬性存取。
  • 新增支援，可使用 IMA SDK 處理 HLS 插播廣告中繼資料。
4.14.1 2024-12-03
  • 將聯播網代碼新增至所有串流類型的串流請求參數清單。
  • 點選無效的點閱網址時，系統會觸發 LOG 事件，而非默默失敗。
  • 修正 OMID 工作階段不當刪除時，記憶體流失的問題。
  • 新增支援 VOD 廣告連播放送串流中的可略過廣告。
  • 修正影片嵌入可捲動容器時，捲動支援功能發生的錯誤。
  • 新增對非線性廣告 minSuggestedDuration 的支援
  • 修正錯誤：部分 Campaign Manager 追蹤網址編碼不正確。
  • 修正問題：在某些廣告工作階段中，系統不會調度 STARTED 事件。
4.13.0 2024-06-13
  • 在 IMAVideoStitcherVODStreamRequest 中新增 VODConfigID。
  • 修正 IMAAdsRequest 中 adTagURL 為 null 時的 nullpointerexception。
  • 變更素材資源層級備用廣告邏輯，逐一檢查原始 VAST 中的所有廣告，直到 SDK 找到可播放的廣告素材。如果找不到可播放的廣告素材，就不會播放廣告。
  • 修正問題：系統未觸發對 ad.doubleclick.net 的追蹤連線偵測 (ping)。
  • 根據檢視區塊框架 (而非 playerView 的安全區域版面配置指南)，設定 SDK 的廣告大小算繪限制。
4.12.0 2024-04-03
4.11.1 2024-02-22
  • 修正廣告播放期間會聽到內容音訊的問題。
4.10.0 2024-01-24
  • 啟用廣告連播隨選影片串流要求。
  • 更新 AdUI 的限制條件，以遵循安全區域指南。
  • 在 iOS/tvOS 串流管理工具中，新增提示點的 getter
4.9.2 2023-08-15
  • 修正錯誤：部分 DAI 串流的 CPU 使用率過高。
4.9.1 2023-04-20
4.8.2 2022-11-03
  • 在 IMA 串流請求中新增 userContext。
  • 修正錯誤：系統會顯示不必要的「內部訊息無效」警告。
4.7.0 2022-07-20
  • 修正發布商覆寫 IMA SDK 版本資訊的問題。
  • 已新增 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 for iOS 支援 tvOS 10 的最後一個版本。
4.4.1 2021-03-09
  • 新增 IMASettings.sessionID 屬性，讓發布商手動設定工作階段 ID。
  • 新增子母畫面支援。
  • 修正廣告暫停和繼續事件有時會在內容播放期間觸發的問題。
  • 新增 IMAVideoDisplay.nowPlayingSession，在 tvOS 14 以上版本中正確支援播放/暫停事件。
  • 修正錯誤：AdSense 線性廣告會向發布商回報為非線性廣告。
  • 修正 IMAStreamManager.replaceAdTagParameters 不會發出更新的問題。
  • 新增廣告連播放送 API。
  • 強制將 adContainer 附加至視窗。
4.3.2 2020-08-11
4.3.1 2020-08-05
  • 新增 Google 額外同意聲明模式支援。詳情請參閱 Google 的額外同意聲明模式技術規格。
  • 新增串流字幕的「language_name」鍵支援。
  • 修正純音訊廣告逾時的問題。
  • 修正問題：略過片頭廣告中的第一則廣告時，第二則廣告會忽略自己的略過開始計費前的播放時長。
  • 新增 IMAAdDisplayContainer.focusEnvironment，讓發布商在廣告插播期間將焦點轉移至 SDK。只要使用者需要與廣告 UI 互動 (例如可略過廣告、VAST 圖示)，就必須使用這個方法。
  • 新增 viewController 做為 IMAAdDisplayContainer 的新必要初始化引數或屬性。
  • 修正非英文本地化支援。
  • 減少錯誤的 RESUME 事件。
  • 新增系統預設啟用的 IMAAdsRenderingSettings.enablePreloading，以提升廣告顯示成效。
  • 新增可略過廣告 (用戶端和 VOD) 和 VAST 圖示 (用戶端和 DAI) 的支援
  • 新增 ICON_FALLBACK_IMAGE_CLOSED 和 ICON_TAPPED 事件。建議在 ICON_FALLBACK_IMAGE_CLOSED 自動恢復，因為 SDK 會在備用圖片開啟時暫停。
  • 修正問題：只有在 IABTCF_gdprApplies 為字串時，系統才會確認該值。
4.2.3 2020-05-06
  • 修正問題：特定應用程式軟體包 ID 可能導致流量分類錯誤。
4.2.2 2020-03-26
  • 將最低執行階段版本提高至 tvOS 10
  • 修正了部分 UI 更新可能會在背景執行緒上觸發的錯誤
  • 修正問題：嚴格標記會導致 IMACompanionAd 的 init 與 NSObject 的 init 衝突
  • 淘汰 IMAVideoDisplay 通訊協定的 loadURL 方法
4.2.1 2020-02-12
  • 4.2.1 將是支援 tvOS 9.x 的最後一個 IMA SDK 版本
  • 修正點閱在 tvOS 9.x 上會當機的問題
4.2.0 2019-10-30
  • 修正 tvOS 13 間歇性當機的問題。
4.1.0 2019-09-23
  • 新增 tvOS 13 支援。
  • 新增 playerVideoDisplay:didLoadPlayerItem: 做為 DAI。
  • 新增 DAI 廣告的 IMAAd.companionAds 和 IMACompanionAd。
  • 更新 IMAAVPlayerVideoDisplayDelegate 名稱，更符合 Objective-C 樣式。
4.0.5 2019-08-16
  • 修正 Apple TV 遙控器上的播放按鈕無法繼續播放內容的問題。
4.0.2 2019-07-18
  • 修正問題：使用者的「限制廣告追蹤」設定傳輸錯誤。
  • IMAAdEventType.adData已輸入。
  • 已於 IMAStreamRequest新增 authToken API。
4.0.1 已淘汰 2019-07-02
  • 整合用戶端和 DAI tvOS SDK
  • 修正問題：tvOS 無法剖析 AdsList，並擲回 AdsLoader 錯誤。

顯示舊版本

版本 推出日期 注意事項
3.9.1 2019-03-28
  • 將預設串流初始化逾時時間從 5 秒變更為 8 秒。
  • 在 IMAStreamRequest 中新增 initializationTimeout 屬性，以便設定串流初始化逾時。
3.9.0 2019-03-06
  • 在 IMAStreamManagerDelegate 中新增 adPeriodDidStart 和 adPeriodDidEnd 回呼。
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 上，系統不會對含有大括號 (「{」或「}」) 的追蹤網址進行連線偵測 (ping)。
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，讓事件監聽器可以顯示廣告 UI。
  • 新增 IMAAVPlayerVideoDisplayDelegate，讓 IMAAVPlayerVideoDisplay 的使用者可以接收要載入的串流 AVAssetURL。使用者可以透過 AVAssetURL 物件，註冊 FairPlay 內容保護播放功能。
3.6.0 2017-09-19
  • 移除無效的 IMAStreamRequest.attemptPreroll。
  • 新增下列可接受的 IMAStreamRequest.adTagParameters：
    • dai-ah (廣告休播)
    • 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
  • 第 1 版。