提供意見
tvOS 的 IMA DAI SDK 版本記錄
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
注意: 由於系統會定期略過發布號碼,因此這個頁面顯示的發布號碼序列可能會有數字間隔,例如 v.3.583.1 之前的 v.3.582.5。
版本
發布日期
附註
4.15.1
2025-05-07
將廣告期間資訊新增至 AD_PERIOD_STARTED
事件,您可以從 IMAAdEvent.adData
屬性存取該事件。
新增支援功能,可使用 IMA SDK 處理 HLS 插頁式廣告中繼資料。
4.14.1
2024-12-03
為所有串流類型,將聯播網代碼
新增至串流要求參數清單。
點選無效的到達網址時,會觸發 LOG 事件,而不是無聲失敗。
修正 OMID 工作階段遭到不當終止時的記憶體流失問題。
新增支援 VOD Pod Serving 串流中的可略過廣告。
修正影片嵌入可捲動容器時,捲動支援功能發生的錯誤。
新增對非線性廣告的 minSuggestedDuration
支援
修正錯誤:部分 Campaign Manager 追蹤網址會遭到錯誤編碼。
修正導致系統無法在部分廣告工作階段中,傳送 STARTED
事件的問題。
4.13.0
2024-06-13
將 VODConfigID
新增至 IMAVideoStitcherVODStreamRequest 。
修正 adTagURL
位於 null
IMAAdsRequest
時發生的空指標例外狀況。
變更
素材資源層級的回退
邏輯,可逐一檢查原始 VAST 中的所有廣告,直到 SDK 找出可播放的廣告素材為止。如果找不到可播放的廣告素材,廣告就不會播放。
修正追蹤 Ping 傳送至 ad.doubleclick.net
時未觸發的問題。
根據檢視區塊影格 (而非 playerView 的安全區域版面配置輔助線),設定 SDK 的廣告大小算繪限制。
4.12.0
2024-04-03
4.11.1
2024-02-22
4.10.0
2024-01-24
啟用 Pod Serving VOD 串流要求。
更新 AdUI 的限制,以遵守安全區域輔助線。
在 iOS/tvOS 串流管理工具中新增提示點的 getter
4.9.2
2023-08-15
修正錯誤:部分動態廣告插播串流的 CPU 使用率過高。
4.9.1
2023-04-20
4.8.2
2022-11-03
已將 userContext
新增至 IMA 串流請求。
修正錯誤:這個錯誤會導致系統發出不必要的「無效的內部訊息」警告。
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 以下版本會顯示警告訊息的問題。
支援 tvOS 10 的最後一個 iOS 專用 IMA SDK 版本。
4.4.1
2021-03-09
新增 IMASettings.sessionID
屬性,讓發布商手動設定 sessionID。
新增子母畫面支援。
修正廣告暫停和繼續事件有時會在內容期間觸發的問題。
新增 IMAVideoDisplay.nowPlayingSession
,以便在 tvOS 14 以上版本中正確支援播放/暫停事件。
修正錯誤:系統會向發布商回報 AdSense 線性廣告為非線性廣告。
修正 IMAStreamManager.replaceAdTagParameters
無法發布更新的問題。
新增 Pod 服務 API。
強制將 adContainer 附加至視窗。
4.3.2
2020-08-11
更新 IMA SDK,支援 tvOS 14:新增對 AppTrackingTransparency
的支援。詳情請參閱「要求應用程式追蹤透明度授權 」。
4.3.1
2020-08-05
新增對 Google 額外同意聲明模式的支援。詳情請參閱 Google 的額外同意聲明模式技術規格 。
新增串流字幕的「language_name」鍵支援。
修正導致純音訊廣告逾時的問題。
修正問題:略過前置廣告中的第一則廣告時,第二則廣告會忽略自己的略過偏移。
新增 IMAAdDisplayContainer.focusEnvironment
,讓發布者在廣告插播期間將焦點轉移至 SDK。只要使用者需要與廣告 UI 互動 (例如可略過的廣告、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
修正特定應用程式套件 ID 可能導致流量分類錯誤的問題。
4.2.2
2020-03-26
將最低執行階段版本提高至 tvOS 10
修正部分 UI 更新可能在背景執行緒上觸發的錯誤
修正問題:嚴格標記會導致 IMACompanionAd 的 init 與 NSObject 的
已淘汰 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
4.1.0
2019-09-23
新增 tvOS 13 支援。
已為 DAI 新增 playerVideoDisplay:didLoadPlayerItem:
。
為動態廣告插播廣告新增 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 無法剖析 AdsLists,並擲回 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
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
中加入以下屬性:
3.3.0
2016-12-05
公開 [IMAAVPlayerVideoDisplay reset]
,在需要以備份 AVPlayerItem
取代內容播放器上的 AVPlayerItem
時呼叫。
3.2.0
2016-08-22
3.1.0
2016-05-09
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-09-26 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","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"]],["上次更新時間:2025-09-26 (世界標準時間)。"],[],["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"]]