Amazon IVS 播放器 SDK - Amazon Interactive Video Service
瀏覽器和平台要求在第三方播放器中降低延遲純音訊播放支援

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon IVS 播放器 SDK

若要使用 Amazon Interactive Video Service (IVS)，您必須使用 Amazon IVS 播放器。該播放器是用於播放 Amazon IVS 串流的跨平台開發套件。它的設計目的是利用 Amazon IVS 架構，並針對 Amazon IVS 播放進行最佳化。

我們能保證其效能的唯一播放器是 Amazon IVS 播放器。為了實現低延遲，需要使用 Amazon IVS 播放器。

Amazon IVS 播放器的主要特點是：

  • U ltra-low-latency 流 — 低延遲是構建良好的互動式用戶體驗的關鍵組成部分，以豐富受眾體驗。延遲會在廣播者和觀眾之間的傳輸路徑中逐漸增加，從而降低回應速度。

    E 延nd-to-end 遲是從攝影機擷取即時串流到觀看者螢幕上顯示的延遲時間。Amazon IVS 旨在提供超低 end-to-end 延遲 (不到五秒鐘，視廣播位置和廣播公司設定而定)。要實現這種低延遲，需要 Amazon IVS 播放器。

  • 跨平台一致性 — 觀眾在各種平台上觀看廣播。從行動裝置到 Web 瀏覽器，Amazon IVS 播放器為所有觀眾提供相似體驗。這種一致性是可能的，因為每個平台都使用相同的播放器函數庫。播放器程式庫是 Amazon IVS 架構的一個主要組成部分。使用一個影片堆疊可確保在所有支援的平台上以一致的方式提供所有影片播放行為 (包括低延遲模式、定時中繼資料、分析、錯誤追蹤、報告和記錄)。

  • 自適應位元速率串流 (ABR) — Amazon IVS 播放器使用針對低延遲環境進行最佳化的 ABR 演算法。播放器實時測量服務品質和頻寬可用性，並調整影片品質和緩衝層級，以提供不間斷的播放。當連線品質受損時，ABR 會切換到較低的位元速率；當連線品質改善時，它會切換到較高的位元速率。

  • 定時中繼資料 — Amazon IVS 播放器支援定時中繼資料，它可以用來建置交互式元素，如輪詢和測驗。中繼資料是一組資料，它們描述並提供有關其他資料的資訊。使用「定時」中繼資料時，時間碼會伴隨有關串流的資料片段。在播放期間，時間碼做為提示點，根據資料觸發動作，例如：

    • 傳送運動串流的球員統計資料

    • 傳送即時購物串流的產品詳細資訊

    • 傳送即時測驗串流的問題

  • 強大的錯誤處理 — 處理好暫時性錯誤可避免檢視體驗中斷。Amazon IVS 播放器的強大錯誤處理能力可偵測許多潛在的串流錯誤，自動切換到替代轉譯。觀眾不受干擾地繼續觀看廣播，而不需要採取任何糾正措施。

  • 易於整合— Amazon IVS 播放器 API 彌補了 Amazon IVS 客戶應用程式和播放器程式庫之間的差距。API 具有所有支援平台的繫結，讓播放器能夠輕鬆地整合到應用程式中，同時使用熟悉的編碼環境和技術。透過完全控制 UI 元素，客戶可以自訂應用程式的品牌和展示方面。

Amazon IVS 播放器不支援使用 Airplay 進行投射。您可以使用預設的 Chromecast 接收器應用程式，在播放器之外使用 Chromecast 進行投射。但是，這些應用程式中的延遲會高於 Amazon IVS 播放程式開發套件中的延遲，因此交換器將無法無縫運作。另請參閱 Amazon IVS 廣播 SDK 相關文件：低延遲串流和即時串流。

瀏覽器和平台要求

如需各種瀏覽器最新發行版本的詳細資訊，請參閱：

雖然 Amazon IVS 可能適用於某些舊版瀏覽器，但我們不會修正與舊版瀏覽器相關的錯誤。

在瀏覽器類型的環境中，不支援 IVS 播放器 Web SDK (包括 Video.js 和播放器 JW 整合)。這包括支持 Web 應用程序的本機 WebViews 和「10 英尺設備」（電視，控制台，機頂盒）。如果您不確定下表以外的特定瀏覽器支援，請聯絡 IVS 支援部門。

桌面瀏覽器

桌面瀏覽器 支援的平台 支援的版本
Chrome Windows、macOS 兩個主要版本 (目前版本和最新的先前版本)
Firefox Windows、macOS 兩個主要版本 (目前版本和最新的先前版本)
Edge Windows 8.1 及更新版本

44.0 版和更新版本

(在 Microsoft Edge Legacy 的自動品質模式下，只支援正常延遲播放，而不支援超低延遲播放。自動品質模式是指是否啟用 ABR。例如，在 Web 播放器上，請參閱setAutoQualityMode。
Safari macOS

兩個主要版本 (目前版本和最新的先前版本)

(在適用於 macOS 14 的 Safari 或以上版本的自動品質模式下，IVS 播放器 1.3.0 或以上版本支援超低延遲播放。對於較早版本的 Safari 和 IVS 播放器，只支援正常延遲播放。請參閱上述「自動品質模式」。)

行動裝置瀏覽器

行動裝置瀏覽器 支援的版本
適用於 iOS 的 Chrome，適用於 iOS 的 Safari

兩個主要版本 (目前版本和最新的先前版本)

(不支援超低延遲播放。支援正常延遲播放。此限制條件適用於 iOS 的所有瀏覽器。)

(播放器 1.3.0 版及更新版本只支援定時中繼資料。)
適用於 iPad 的 Chrome、適用於 iPad 的 Safari

兩個主要版本 (目前版本和最新的先前版本)

(當選擇「請求行動版網站」時：

  • 不支援超低延遲播放。

  • 播放器 1.3.0 版及更新版本只支援定時中繼資料。)
適用於 Android 的 Chrome 兩個主要版本 (目前版本和最新的先前版本)

原生平台

平台 支援的版本 支援的裝置
Android 5.0 (Lollipop) 和更新版本 手機和平板電腦
iOS 12.0 版和更新版本 全部

IVS 至少支援 4 個主要的 iOS 版本和 6 個主要的 Android 版本。我們目前的版本支援可能會超過這些最低限度。客戶至少會提前 3 個月透過 SDK 版本備註收到通知，知悉某個主要版本不再受支援。

在第三方播放器中降低延遲

針對基本和標準頻道類型：為了盡可能降低延遲，您必須使用 Amazon IVS 播放器。在第三方播放器 (包括 iOS Safari) 中，您可以使用以下組態將延遲降低到約 10 秒：

  • 將編碼器 (例如 OBS) 的關鍵影格間隔設定為 2 秒或更低。

  • 將 ?keyframeInterval=2 新增至 RTMP(S) URL。例如：rtmps://a1b2c3d4e5f6.global-contribute.live-video.net:443/app/sk_us-west-2_abcd1234efgh5678ijkl?keyframeInterval=2

注意：指定為 RTMP URL 一部分的關鍵影格間隔必須大於或等於編碼器中設定的值；否則，您可能會遭遇播放問題。您可以將該值設定為 2 到 6 的任意整數，而 2 會啟用最低延遲。

針對進階頻道類型：上述指引不適用。進階頻道類型會自動產生關鍵影格間隔時間以提高編碼效率，不論來源編碼關鍵影格間隔時間設定為何，關鍵影格之間最多為 2 秒。

iOS Safari

在 iOS Safari 中，您可以使用 IVS 播放器並將其設定為使用服務工作者，將延遲減少到大約 6-8 秒。如需實作詳細資訊和參考範例，請參閱《播放器 SDK：Web 指南》中的設定服務工作者。

注意：取得最低延遲時間需要將 IVS 串流的關鍵影格間隔設定為 2 秒。

純音訊播放

所有 IVS 頻道類型都支援純音訊轉譯。這對於移動應用程序尤其有價值。例如，在您的行動應用程式中，當使用者背景應用程式以節省頻寬時，您可以將播放程式切換為純音訊轉譯。

對於高級 SD 和高級 HD 頻道，純音頻節目會自動包含在多變體播放列表中。對於 BASIC 和 STANDARD 頻道，您必須將?allow_audio_only=true查詢參數附加至播放 URL，才能包含純音訊節目。

注意：IVS 網路播放器 SDK 僅支援 1.24.0 及更新版本的純音訊播放。

支援

如果串流發生播放錯誤或其他播放問題，請透過播放器 API 判定唯一的播放工作階段識別符。

對於此 Amazon IVS 播放器： 請使用：
Android

sessionId 函數
iOS

IVSPlayer 的 sessionId 屬性
Web

getSessionId 函數

與 AWS 支援共用此播放工作階段識別符。使用它，他們就可以取得資訊來協助您對問題進行疑難排解。

備註：播放器在不斷改進。請參閱可用版本的 Amazon IVS 版本備註以及已修正的問題。如果適當，請在聯絡支援部門之前，先更新您的播放器版本，並查看是否可以解決您的問題。

版本控制

Amazon IVS 播放器 SDK 使用語意版本控制。

對於此討論，假設：

  • 最新版本為 4.1.3 版。

  • 先前主要版本的最新版本為 3.2.4 版。

  • 版本 1.x 的最新版本為 1.5.6 版。

回溯相容的新功能會新增為最新版本的次要版本。在這種情況下，下一組新功能將被新增為 4.2.0 版。

回溯相容的次要錯誤修正會新增為最新版本的修補程式版本。在這裡，下一組小錯誤修復將被新增為 4.1.4 版。

回溯相容、主要錯誤修正的處理方式不同；它們會新增至多個版本：

  • 最新版本的修補程式版本。在這裡，它為 4.1.4 版。

  • 先前次要版本的修補程式版本。在這裡，它為 3.2.5 版。

  • 最新版 1.x 版本的修補程式版本。在這裡，它為 1.5.7 版。

主要錯誤修正由 Amazon IVS 產品團隊定義。典型範例包括重要的安全更新以及客戶所需的其他精選修正。

備註：在上面的範例中，發布的版本在不跳過任何數字的情況下遞增 (例如，從 4.1.3 到 4.1.4)。實際上，一個或多個修補程式編號可能會保持在內部並且不需要發行，因此發行的版本可能會從 4.1.3 增加到 4.1.6。