總覽
Cast Web Receiver SDK 支援使用多個網路 串流通訊協定。根據 通訊協定，SDK 會載入播放器來處理內容的播放作業。在 但會載入媒體播放器資料庫 (MPL)。如果選擇 DASH 內容，Shaka Player 是 就會引發這個事件。
往後 Cast SDK 和 Shaka Player 工程團隊 整合許多心力，提高在 Shaka 上播放 HTTP 即時串流內容的次數 玩家。MPL 不會再收到重大更新。建議您啟用 ，以使用 Shaka Player 處理應用程式的 HTTP 即時串流內容。
Shaka Player 福利
在不斷變化的玩家中，應用程式的優點如下：
- 為使用者提供更強大的串流工作階段，並縮短載入時間 例如故障和延遲時間
- 持續採用最新的 HTTP 即時串流功能。
- 針對玩家內容進一步釐清根本原因分析 造成的相容性問題。
- 開放原始碼播放器程式碼集可讓合作夥伴 為 Shaka Player 專案貢獻一己之力。
- 大幅縮短實際工作環境的功能和錯誤修正時間： Shaka Player 的發行版本 行銷系列活動頻繁 以及 Web Receiver SDK 版本獨立運作
- 更精細地控管
shakaVersionAPI。 - 運用工程資源提升 Google 播放支援度 我們著重在 Shaka 播放機上 HLS 播放 道路圖。
時間軸
Web Receiver SDK 將改用 Shaka Player 做為預設播放器 HTTP 即時串流內容播放。我們會分階段進行，逐步引導 合作夥伴才會完成遷移程序
| 階段 | 開始日期 | 總覽 |
|---|---|---|
| 1 | 2022 年 10 月 | Cast Web Receiver SDK 導入 API，即可選擇在 Shaka Player 上播放 HTTP 即時串流內容。 |
| 2 | 2024 年下半年 | Cast Web Receiver SDK 將預設播放器變更為 Shaka Player，即可播放 HTTP 即時串流內容。 |
Web Receiver SDK 工程團隊則採取成效導向的做法 並且僅在 Shaka Player 效能表現時，才會進入下一階段 與 MPL 的基準成效一致。這些變更將於 更新 cast-sdk-announcements google 群組，以及在 本指南。
選擇啟用
從 CAF 版本 3.0.0105 開始，有應用程式層級
即可選擇加入，使用 Shaka Player 進行 HTTP 即時串流播放。這個版本
也導入了一個 API，可從支援的 Shaka Player 版本範圍中選取。
載入。您可以在
CastReceiverOptions 類別中
useShakaForHls和
shakaVersion 屬性，且會在
CastReceiverContext 已開始。選擇針對 HTTP 即時串流啟用 Shaka 的任何應用程式
應設定至少 4.3.4 的 Shaka Player 版本，以便使用
最新的 HTTP 即時串流改善項目。如要選擇啟用，請按照下列程式碼片段操作：
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;
context.start(castReceiverOptions);
驗證內容
合作夥伴應先驗證在 Shaka Player 播放的內容再選擇 在正式版應用程式中使用 Shaka Player。建議您針對 下列內容的變化：
- 串流類型：直播或隨選影片
- 容器格式：TS、MP4 或基本串流
- 內容停滯或內嵌廣告
- 在下列裝置類型上播放：智慧螢幕、Chromecast 連接器、 Android TV 裝置、內建 Chromecast 的電視、智慧音箱
如果您發現任何錯誤或非預期的行為，請回報錯誤。 只要您能確認 將變更推送至正式環境
停用
Web Receiver SDK 將轉換成 Shaka Player HLS 的停用模型
系統也會根據時間表播放內容。屬性
useShakaForHls 會變更預設值
從 false 到 true。屆時，應用程式可選擇使用 MPL 建立 HTTP 即時串流
將此屬性手動設為 false 即可播放。當
已啟動「CastReceiverContext」，Web Receiver SDK 將還原為載入狀態
以 MPL 取代 Shaka Player。請參考以下範例，瞭解如何停用：
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;
context.start(castReceiverOptions);
回報問題
我們建議合作夥伴在播放 HTTP 即時串流時，提出任何問題。 內容。如前所述，MPL 不會再收到重大更新。如果有任何 遇到 MPL 相關問題時，請按照啟用中的步驟操作 一節，確認是否改用 Shaka Player 能否解除封鎖 問題。如果問題仍未解決或您遇到以下狀況，請按照下列步驟操作： 但在切換玩家時遇到的不同問題。
- 請嘗試將
shakaVersion設為 不同的分支版本。舉例來說，如果問題 有在4.3分支版本上發生，請嘗試將其設為以下應用程式的最新版本：4.2.x或3.3.x版本。查看 Shaka Player 版本 記事 最相關的更新版本請注意，shakaVersionAPI 有上下限 支援的版本，詳見參考文件。觀察時 如果出現迴歸問題，請在Shaaka Player 中回報問題 Issue Tracker。 嘗試變更播放器設定參數。Shaka Player 是 也能設定
PlayerConfiguration物件。網路 接收器 SDK 會定義一組預設值，讓應用程式 如要修改這個設定PlaybackConfig中的shakaConfig資源 物件。系統會在載入玩家例項時， 已建立。查看更多此類別的結果：應用程式設定 選項。預設 我們建議使用 Web Receiver SDK 設定的值。
查看問題是否回報於 Shaka Player Issue Tracker 或 Cast Issue Tracker。針對錯誤撰寫評論，並提供任何相關資訊 。
在 Shaka Player 示範網站中測試內容。如果發生以下情況： 找出在示範網站上重現您內容的問題，請提出 錯誤。
在 Cast Issue Tracker 中回報錯誤 發生在投放端點上 Shaka 播放器特有的問題
常見問題
改變玩家可能會讓他們感到很多問題。下列是最熱門的 常見問題，將協助您完成遷移程序。
我該遷移到 Shaka Player 嗎？
我們建議合作夥伴使用 HTTP 即時串流內容，開始遷移程序， 因此，您的應用程式將提供更健全的串流體驗 打造良好的使用者體驗如需更多福利，請參閱 Shaka Player 中 一節。合作夥伴應自行驗證 確認應用程式是否透過 Shaka Player 正常運作 轉換。某些應用程式可能有風險，可能導致 Web Receiver SDK 受到影響 如未驗證，將轉換成選擇不採用模式 確保內容順利在 Shaka Player 上播放
改變玩家的預期力量為何？
合作夥伴必須在測試環境中測試應用程式和內容 確保使用者體驗與 HTTP 即時串流相比 (HLS) 差不多或有所提升。 這時，合作夥伴必須在 並徹底測試其內容是否可以播放 透過 Shaka Player 瀏覽詳情請參閱驗證內容。 你應該著重的內容面向驗證完成後，合作夥伴必須 新增旗標，在正式版應用程式環境中選擇加入，即可開始使用 充分利用 Shaka Player 提供的諸多優勢。整體來說 幾乎沒有軟體開發變更，主要是品質確保要求 才能順利遷移。
我的應用程式很快就會使用 HTTP 即時串流來串流內容，該怎麼辦？
新的整合作業應選擇使用 Shaka Player 播放。您的 提高應用程式的長期支援能力 充分利用新的 HTTP 即時串流功能和效能改善項目。如果是 整合出現問題時，請盡快回報錯誤， 工程團隊有足夠的時間解決問題如果應用程式 期限為限，請在錯誤報告中提供相關資訊和影響 並據此排定優先順序我們的工程團隊會盡力提供解決方案 才能為使用者提供完善的支援服務
我的內容或應用程式無法與 Shaka Player 搭配使用，該怎麼辦？
請透過 Shaka Player 專案或 Cast 專案回報錯誤 (請參閱回報問題)。Cast SDK 工程團隊積極投入 我們會監控這些追蹤器，並與您一起解決所有需要的問題。 越早偵測到這些問題，就需要越多時間 及時修正。
MPL 不會再收到重大更新，這代表什麼意思？
MPL 一直以來都採用新的 HTTP 即時串流功能，並修補了重大錯誤 重大更新MPL 現在不會再收到 MPL 內容，新的 HTTP 即時串流 功能。同理，凡是回報的 HTTP 即時串流問題 無法以 MPL 修正在 MPL 上播放的問題。這些問題應於 切換至 Shaka Player 進行播放。如果問題持續發生，則 bug 應回報 Shaka 遇到的問題 玩家。合作夥伴應停止使用 MPL。
我的內容使用流暢串流通訊協定，這對我的應用程式有何影響？
MPL 二進位檔仍會代管，並可供接收端存取 應用程式。然而，任何流暢串流相關功能要求和錯誤 就不會受到支援 Smooth Streaming 規格尚未在 。我們建議您遷移內容，改用 DASH 或 HTTP 即時串流 串流通訊協定，持續接收效能更新內容與支援服務 內容
我的內容並未使用 HLS 或流暢串流通訊協定，這對我的應用程式有何影響？
如果你的內容資料庫未使用這兩種串流通訊協定， 不會受到遷移的影響您不必在 應用程式。