Roku 的 IMA DAI SDK 版本記錄

注意：由於系統會定期略過發布號碼，因此這個頁面顯示的發布號碼序列可能會有數字間隔，例如 v.3.583.1 之前的 v.3.582.5。

版本	發布日期	附註
3.69.0	2025-09-25	新增 Companion.adSlotId 和 Companion.companionClickThrough 屬性，支援連播放送串流的隨播廣告。 修正問題：廣告連播中，除了最後一個廣告以外，所有廣告的完成信號都無法傳送。 修正錯誤：廣告遭到略過時，系統會回報 COMPLETE 廣告事件。使用者在廣告插播期間搜尋時，系統現在會更準確地回報廣告事件。 移除 IMA 行為，在 IMA 移除廣告 UI 後，將焦點放在 UI 容器上。
3.68.3	2025-07-02	修正廣告插播開始和廣告開始事件在錯誤時間觸發的問題，例如在內容恢復播放時。 修正廣告時間長度值無效，導致執行階段錯誤 'Dot' Operator attempted with invalid BrightScript Component or interface reference 的問題。
3.68.2	2025-05-28	公開 player.streamInitialized() 方法，在初始化串流時呼叫。 更新 IMA 行為，讓使用者略過廣告時，不會觸發 COMPLETED 事件。使用者略過廣告時，SDK 仍會觸發 SKIPPED 事件。這項變更後，COMPLETED 事件的行為將與其他 IMA SDK 的行為一致。 改善 Pod 放送串流的訊息處理方式。 修正廣告使用者介面在 Full HD 串流中延展的問題。 修正初始片頭廣告事件延遲的問題。
3.68.1	2025-04-21	修正與廣告圖示相關的 Divide by Zero 邊緣案例執行階段錯誤。
3.67.2	2024-12-19	改善 currentAd.currentTime，使 currentTime 值與廣告事件觸發時間一致。 修正特定廣告事件偶爾不會觸發的問題。
3.67.0	2024-11-07	為全方位服務 DAI 串流請求新增選用的 Ad Manager 聯播網代碼參數。加入這個參數後，IMA 的行為就會變更，以符合 Ad Manager 設定，例如停用程式輔助受限制的廣告。 新增對 streamManager.loadThirdPartyStream() 的 VOD 串流支援。 直播更新 AdBreakInfo.podIndex 。這個值現在會傳回中斷 ID，做為片中廣告的廣告插播索引，或是片頭廣告的 0。直播影片不會顯示片尾廣告。直播的預設值為 -2。 新增對 StreamManager.getStreamTime() 和 StreamManager.getContentTime() 的支援，適用於雲端縫合和 Pod 服務串流。 修正廣告素材廣告 ID 和廣告素材 ID 值未納入 AdInfo 的問題。 修正 Roku 使用者介面圖示和略過按鈕位置不正確的問題。
3.66.1	2024-07-25	針對所有直播和 VOD 串流請求，新增 networkCode 參數的必要條件。 將 creative_id、creative_ad_id 和 deal_id 新增至 AdInfo 類別。 新增自訂 VAST 追蹤事件的支援，例如顯示略過、略過和點擊後瀏覽。 修正 Cloud Video Stitcher VOD 串流的問題。StreamManager.getCuePoint() 修正 StreamManager.createVideoStitcherVodStreamRequestWithVodConfig() 中的大寫問題。
3.66.0	2024-06-18	新增 ima.StreamRequest.createVideoStitcherVodStreamRequestWithVodConfig()。 新增 ima.AdEvent.ICON_FALLBACK_IMAGE_SHOWN 和 ima.AdEvent.ICON_FALLBACK_IMAGE_CLOSED，用於顯示及關閉備用圖片對話方塊。 新增 ima.AdInfo.skipOffset，代表廣告可略過前所需秒數。 新增 ima.StreamRequest.videoStitcherSessionOptions。 修正廣告期間事件未針對節目表呼叫的問題。
3.65.0	2024-03-29	新增 DAI Pod Serving VOD 的 createPodVodStreamRequest 和 StreamManager.loadThirdPartyStream 函式。
3.64.0	2024-02-08	在 ima.initSdk 函式中新增選用的 settings 參數，可啟用及停用 SDK 功能。
3.63.0	2023 年 9 月 14 日	修正應用程式在遇到無效 adBreakInfo 時可能當機的錯誤。
3.62.0	2023-08-02	新增 StreamRequest.createVideoStitcherLiveStreamRequest() 和 StreamRequest.createVideoStitcherVodStreamRequest() API，支援 Google Cloud Video Stitcher API。 更新 IMA 行為，以遵循為 description_url= 參數設定的值。先前，IMA 一律會以偵測到的正確網址覆寫 description_url= 參數，並將 url= 參數變更為先前設定的 description_url=。如果串流的廣告代碼網址中未設定 description_url=，IMA 仍會設定該參數。
3.61.1	2023-03-22	支援傳統和 TrueView 可略過廣告。 新增下列廣告事件： SKIPPABLE_STATE_CHANGED SKIPPED
3.60.0	2022-09-30	推出 Roku 浮水印，支援所有追蹤 Ping。
3.59.0	2022-09-23	服務版本，沒有新功能。
3.58.0	2022-09-15	服務版本，沒有新功能。
3.57.2	2022-09-12	新增 StreamFormat 類別，用於設定 StreamInfo.format。
3.56.0	2022-08-05	服務版本，沒有新功能。
3.55.0	2022-07-15	新增下列 API，用於要求特定串流類型： CreateLiveStreamRequest() 建立直播要求。 CreatePodLiveStreamRequest() ，用於建立即時 Pod 串流要求。 CreateVodStreamRequest() ，用於建立 VOD 串流要求。 如要瞭解各個 API 的參數，請參閱 StreamRequest 。
3.54.0	2022-05-19	新增 StreamRequest.customAssetKey() 和 StreamRequest.networkCode() ，支援 Pod 服務。
3.53.0	2022-04-25	針對即時 HLS CMAF 串流，實作適當的 ID3 事件剖析。修正問題：系統會針對這些串流在錯誤時間觸發廣告事件。 淘汰 StreamManager.onTimedMetadata()。這個方法已不再記錄。
3.52.0	2022-03-29	服務版本，沒有新功能。
3.51.0	2022-03-17	服務版本，沒有新功能。
3.50.0	2022-03-07	加入 StreamManager.onTimedMetadata()。
3.45.1	2021-11-03	新增可略過廣告支援。 更新 SDK 行為，現在可正確 Ping 進度事件。
3.41.1	2021-04-07	新增 StreamRequest.adUiNode ，以便在廣告期間放置「為什麼會顯示這則廣告？」和「略過」按鈕等元素。 移除 StreamManager.enableInteractiveAds() 的支援。這項作業現在是空值。請改為直接將隨播廣告的資料傳遞至 RAF。
3.40.1	2020-09-23	新增對 DASH 直播串流的支援。
3.39.0	2020-07-06	服務版本，沒有新功能。
3.36.0	2020-02-28	服務版本，沒有新功能。
3.35.0	2019-11-11	服務版本，沒有新功能。
3.34.0	2019-07-18	服務版本，沒有新功能。
3.33.0	2019-05-14	將 AD_PERIOD_STARTED 和 AD_PERIOD_ENDED 事件新增至 ima.AdEvent。 將廣告 PROGRESS 事件新增至 ima.AdEvent。 將 advertiserName、universalAdIDRegistry 和 universalAdIDValue 參數新增至 adInfo。
3.28.1	2018-07-10	服務版本，沒有新功能。