IVS 文件歷史記錄 | 即時串流 - Amazon IVS
《即時串流使用者指南》變更《IVS 即時串流 API 參考》變更

IVS 文件歷史記錄 | 即時串流

下表說明了對 Amazon IVS 即時串流功能文件所進行的重要變更。我們會針對新版本和您傳送給我們的意見回饋，經常更新說明文件。

《即時串流使用者指南》變更

變更描述日期

廣播 SDK：Web 1.17.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 10 月 10 日

廣播 SDK：Android 1.23.0、iOS 1.23.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

對於 Android，我們新增了使用包含偵錯符號的 SDK 章節。

2024 年 10 月 10 日

Service Quotas

新增了「參與者發布位元速率」的配額。

2024 年 9 月 25 日

監控 IVS 即時串流

新增了 PublishFramerate CloudWatch 指標。

2024 年 9 月 13 日

廣播 SDK：Android 1.22.0、iOS 1.22.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

我們也更新了廣播 SDK：Android 指南中的「開始使用 > 安裝程式庫」一節。

2024 年 9 月 11 日

廣播 SDK：Web 1.16.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 9 月 11 日

RTMP 擷取

我們新增了 IVS 串流擷取頁面。在此頁面下有兩個頁面，即 RTMP (新) 和 WHIP。

我們在搭配 IVS 即時串流使用 EventBridge 章節中，新增了「IVS 舞台更新」事件，「參與者發布錯誤」。

在 Service Quotas 中，為五個新的 API 操作和 1 個新的 IngestConfiguration 配額 (在「其他配額」中) 新增了 TPS 值。

API 變更的說明位於 API 參考資料表中。

2024 年 9 月 9 日

即時串流最佳化

更新了多處與 Simulcast 相關的內容，並新增了「分層解析度」內容。

2024 年 8 月 22 日

主控台內發布/訂閱

我們在開始使用 IVS 即時串流章節中，新增了主控台內發布和訂閱功能以發布和訂閱影片相關的內容。

2024 年 8 月 19 日

廣播 SDK：Web 1.15.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

我們也在廣播 SDK：Web 指南章節中新增了參與者訂閱組態章節。

我們在串流最佳化章節中新增了變更訂閱用戶抖動緩衝區最低延遲章節。這包括 Web、Android 和 iOS 廣播 SDK 的相關資訊。

2024 年 8 月 15 日

廣播 SDK：Android 1.21.0、iOS 1.21.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

我們也在廣播 SDK：Android 指南和 iOS 指南中新增了「參與者訂閱組態」新章節。

2024 年 8 月 15 日

錄製說明

在個別參與者錄製 (在 1：建立 S3 儲存貯體中) 和複合錄製 (在先決條件中，步驟 3) 章節中新增了有關使用現有 S3 儲存貯體的備註。物件擁有權設定必須是強制執行的儲存貯體擁有者，或是偏好的儲存貯體擁有者。

2024 年 8 月 13 日

廣播 SDK：Web 1.14.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 7 月 18 日

廣播 SDK：Android 1.20.0、iOS 1.20.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 7 月 18 日

開始使用即時串流

在「權杖結構描述：承載」和「使用 IVS 即時串流 API 建立權杖」中，新增了「分發參與者權杖」中屬性的相關資訊。

2024 年 7 月 12 日

Service Quotas

舞台訂閱用戶數上限從 10,000 增加到 25,000。

2024 年 6 月 27 日

使用金鑰對產生參與者權杖

我們在開始使用 IVS 即時串流章節中，更新了分發參與者權杖，以解釋權杖的兩種產生方式 (API 和金鑰對)，並新增了「使用金鑰對建立權杖」章節。

2024 年 6 月 26 日

個別參與者錄製

新增了與錄製相關的文件章節，其中包含個別參與者錄製 (新) 和複合錄製 (既有) 的子文件。我們也在搭配 IVS 使用 EventBridge章節中新增了「參與者錄製狀態變更」事件和範例。

API 變更的說明位於 API 參考資料表中。

2024 年 6 月 20 日

Service Quotas

舞台配額從 100 增加到 1,000。

2024 年 6 月 14 日

廣播 SDK：Android 1.19.0、iOS 1.19.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 6 月 13 日

廣播 SDK：Web 1.13.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

我們在這份指南中，更新了錯誤處理中與新的 ERROR 舞台事件相關的資訊。

2024 年 6 月 13 日

廣播 SDK：Web 1.12.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

我們在這份指南中，更新了處理網路問題中與舞台連線 ERRORED 狀態相關的資訊。

2024 年 5 月 20 日

即時串流最佳化

將預設層、品質和影格速率章節中行動裝置 (低層) 的最大位元速率從 150,000 變更為 100,000 bps。

2024 年 5 月 16 日

廣播 SDK：Android 1.18.0、iOS 1.18.0

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 5 月 16 日

廣播 SDK：Web 1.11.0

更新了 IVS 文件登陸頁面上和即時串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 5 月 6 日

廣播 SDK：Web 1.10.1

更新了 IVS 文件登陸頁面上和即時串流廣播 SDK：Web 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 4 月 30 日

廣播 SDK：Android 1.15.2、iOS 1.15.2

更新了 IVS 文件登陸頁面上和低延遲串流廣播 SDK：Android 指南和 iOS 指南中的版本編號和成品連結。也請參閱版本備註。

2024 年 4 月 30 日

廣播 SDK：iOS 指南

我們更新了發布媒體串流章節中的程式碼範例。

2024 年 4 月 26 日

廣播 SDK：Android 1.17.0、iOS 1.17.0

在 Android 版和 iOS 版即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結。更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。另請參閱此版本的 Amazon IVS 版本備註。

2024 年 4 月 22 日

伺服器端合成

對 SSC 進行了各種變更 (特別是在「版面配置」章節中)，以解釋 PiP 和網格版面配置。

在廣播 SDK：Web 指南中，新增了伺服器端轉譯支援章節。

2024 年 3 月 26 日

OBS 和 WHIP 支援

新增了備註，說明 OBS 中可能發生的與 WHIP 相關的品質問題 (例如間歇性影片凍結)。

2024 年 3 月 22 日

廣播 SDK：Android 1.16.0、iOS 1.16.0、Web 1.10.0

更新了即時串流廣播 SDK：Android 指南、iOS 指南、Web 指南中的版本編號和成品連結。更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。另請參閱此版本的 Amazon IVS 版本備註。

2024 年 3 月 21 日

廣播 SDK：Android 1.15.1、iOS 1.15.1

在 Android 版和 iOS 版即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結。更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。另請參閱此版本的 Amazon IVS 版本備註。

2024 年 3 月 13 日

廣播 SDK：行動音訊模式

在「音訊模式預設」章節中，新增了音量鍵預設類別的相關資訊，以及 iOS 中已知與視訊聊天預設相關的問題。在「進階使用案例」章節中，新增了避免不正確組態的備註，並新增了與「iOS 回音消除」和「iOS 自訂音訊來源」相關的章節。

2024 年 3 月 1 日

廣播 SDK：Android 1.15.0、iOS 1.15.0、Web 1.9.0

更新了即時串流廣播 SDK：Android 指南、iOS 指南、Web 指南中的版本編號和成品連結。更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。另請參閱此版本的 Amazon IVS 版本備註。

2024 年 2 月 22 日

OBS 和 WHIP 支援

新增了一個頁面。本文件說明如何使用 OBS 等 WHIP 相容編碼器，來發布至 IVS 即時串流。WHIP (WebRTC-HTTP 擷取通訊協定) 是為了標準化 WebRTC 擷取而開發的 IETF 草案。

2024 年 2 月 6 日

廣播 SDK：Android 1.14.1、iOS 1.14.1、Web 1.8.0

更新了即時串流廣播 SDK：Android 指南、iOS 指南、Web 指南中的版本編號和成品連結。更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。另請參閱此版本的 Amazon IVS 版本備註。

對於 Android 指南，我們新增了已知問題 (影片大小小於 176x176)。

對於 Web 指南，我們新增了已知問題。因應措施是在叫用 getUserMedia 或 getDisplayMedia 時，將影片解析度限制為 720p。

我們在即時串流最佳化章節中，更新了設定 Simulcast 分層編碼內容 (此功能目前預設為停用)。

2024 年 2 月 1 日

廣播 SDK：Android 1.13.4、iOS 1.13.4、Web 1.7.0

更新了即時串流廣播 SDK：Android 指南、iOS 指南、Web 指南中的版本編號和成品連結。更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。另請參閱此版本的 Amazon IVS 版本備註。

2024 年 1 月 3 日

IVS 詞彙表

擴展了詞彙表，涵蓋 IVS 即時、低延遲和聊天術語。

2023 年 12 月 20 日

階段運作狀態：新的 CloudWatch 指標

將 PacketLoss (Stage) 指標重新命名為 DownloadPacketLoss (Stage)，並發布了 IVS 即時串流的其他 CloudWatch 指標：

  • DownloadPacketLoss (Stage,Participant)

  • DroppedFrames (Stage,Participant)

  • SubscribeBitrate (Stage,Participant,MediaType)

請參閱監控 IVS 即時串流。

2023 年 12 月 7 日

IAM 受管政策

新增兩個受管政策，即 IVSReadOnlyAccess 和 IVSFullAccess。請參閱：

2023 年 12 月 5 日

廣播 SDK：Android 1.13.2 和 iOS 1.13.2

在 Android 版和 iOS 版即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結。

更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。

另請參閱此版本的 Amazon IVS 版本備註。

2023 年 12 月 4 日

廣播 SDK：Android 1.13.1

在 Android 版即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結。

更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。

另請參閱此版本的 Amazon IVS 版本備註。

2023 年 11 月 21 日

Service Quotas

將「參與者發布解析度」從 1080p 變更為 720p。

2023 年 11 月 18 日

廣播 SDK：Android 1.13.0 和 iOS 1.13.0

在 Android 版和 iOS 版即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結。

更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。

另請參閱此版本的 Amazon IVS 版本備註。

我們也對串流優化進行了各種更新。除此之外，「適應性串流：使用 Simulcast 進行分層編碼」功能現在需要明確選擇加入，並且僅受最新版本的 SDK 支援。

2023 年 11 月 17 日

複合錄製

進行下列變更：

2023 年 11 月 16 日

伺服器端合成 (SSC)

透過 IVS 伺服器端合成，用戶端可將 IVS 階段的合成和廣播卸載到由 IVS 管理的服務。SSC 和 RTMP 廣播至頻道會透過階段主區域中的 IVS 控制平面端點調用。請參閱：

另請參閱：

2023 年 11 月 16 日

IVS 廣播 SDK

在廣播 SDK 概觀中，我們更新了「平台需求 > 原生平台」來釐清支援的 SDK 版本，並新增了「行動瀏覽器 (iOS 和 Android)」。

在廣播 Web 指南中，我們新增了「行動 Web 限制」。

2023 年 11 月 9 日

IVS 廣播 SDK

我們新增了第三方攝影機濾鏡頁面。

2023 年 11 月 9 日

開始使用 IVS 即時串流

我們更新了設定 IAM 許可的程序。

2023 年 10 月 20 日

監控即時串流

在 CloudWatch 指標：IVS 即時串流，我們新增了維度的範例值。

2023 年 10 月 17 日

廣播 SDK：網路指南

我們對監控遠端參與者媒體靜音狀態進行了幾項變更。

2023 年 10 月 17 日

廣播 SDK：Web 1.6.0

在下列即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結：Web。

Amazon IVS 文件登陸頁面會指向最新版本的廣播 SDK 參考。

另請參閱此版本的 Amazon IVS 版本備註。

在網路指南的「從裝置擷取 MediaStream」中，我們也刪除了這兩max行；最佳實踐是僅指定。ideal

在「即時串流優化」中，我們新增了一個部分：優化音訊位元速率及立體聲支援。

2023 年 10 月 16 日

階段運作狀態：新的 CloudWatch 指標

推出 IVS 即時串流的 CloudWatch 指標。請參閱監控 IVS 即時串流。

2023 年 10 月 12 日

廣播 SDK：Android 1.12.1

在 Android 版即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結。也新增了使用藍牙麥克風的新章節。

Amazon IVS 文件登陸頁面會指向最新版本的廣播 SDK 參考。

另請參閱此版本的 Amazon IVS 版本備註。

2023 年 10 月 12 日

廣播 SDK：Web 1.5.2

在下列即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結：Web。

Amazon IVS 文件登陸頁面會指向最新版本的廣播 SDK 參考。

另請參閱此版本的 Amazon IVS 版本備註。

2023 年 9 月 14 日

開始使用 IVS 即時串流

在 Android > 安裝廣播 SDK 中新增了資料繫結。

2023 年 9 月 12 日

廣播 SDK 錯誤處理方式

在下列廣播 SDK 指南中，新增了「錯誤處理」一節：Web、Android 和 iOS。

2023 年 9 月 12 日

開始使用 IVS 即時串流

在分發參與者權杖中，加入了有關不根據目前權杖格式來建置功能的重要備註。

2023 年 9 月 1 日

開始使用 IVS 即時串流

在設定 IAM 許可中，更新了許可集。

2023 年 8 月 31 日

廣播 SDK：Web 1.5.1、Android 1.12.0 和 iOS 1.12.0

在下列即時串流廣播 SDK 指南中，更新了新版本的版本編號和成品連結：Web、Android，以及 iOS。

更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。

另請參閱此版本的 Amazon IVS 版本備註。

2023 年 8 月 23 日

推出即時串流

此版本隨附重大文件變更。將之前的文件重新命名為 IVS 低延遲串流，並發布了新的 IVS 即時串流文件。IVS 文件登陸頁面現在包含即時串流和低延遲串流的單獨區段。每個區段都有其自己的使用者指南和 API 參考。

如需其他文件變更，請參閱文件歷史記錄 (低延遲串流)。

2023 年 8 月 7 日

廣播 SDK：Web 1.5.0、Android 1.11.0 和 iOS 1.11.0

在 Web、Android 和 iOS 廣播 SDK 指南中更新了新版本的版本編號和成品連結。

更新 Amazon IVS 文件登陸頁面上的廣播 SDK 參考文件連結以指向新版本。

另請參閱此版本的 Amazon IVS 版本備註。

2023 年 8 月 7 日

《IVS 即時串流 API 參考》變更

API 變更 說明 日期

更新事件和影片物件

我們在「事件」物件中為 errorCode 新增了更多有效值。

我們在「影片」物件中說明了 height 和 width 必須是偶數。

 2024 年 10 月 2 日

RTMP 擷取

我們新增了兩個物件：IngestConfiguration 和 IngestConfigurationSummary。我們新增了五個 IngestConfiguration 端點 (建立、刪除、取得、列出和更新)。

我們更新了 DeleteStage (操作說明) 和 DisconnectParticipant (操作說明和 participantId)。

我們修改了「參與者」物件 (新增了 protocol 欄位)；這會影響 GetParticipant 回應。

我們修改了 StageEndpoints 物件 (新增了 rtmp 和 rtmps 欄位)；這會影響 CreateStage、GetStage 和 UpdateStage 回應。我們也更新了此物件的描述 (新增了快取建議)。

2024 年 9 月 9 日

使用金鑰對產生參與者權杖

我們新增了三個物件 (PublicKey、PublicKeySummary、StageEndpoints) 和四個端點：(DeletePublicKey、GetPublicKey、ImportPublicKey、ListPublicKeys)。我們修改了「舞台」物件 (新增了 endpoints 欄位)；這會影響 CreateStage、GetStage 和 UpdateStage 回應。

 2024 年 6 月 26 日

個別參與者錄製

我們新增了一個物件 (AutoParticipantRecordingConfiguration)，並且修改了三個物件 (Participant、ParticipantSummary、Stage)。這會影響五個端點：CreateStage 請求和回應、GetParticipant 回應、GetStage 回應、ListParticipants 請求和回應，以及 UpdateStage 請求和回應。

 2024 年 6 月 20 日

將 svs 從 ARN 模式中移除

更新了指定 [is]vs 的 ARN 模式以指定 ivs。這會影響所有三個標籤端點和 ChannelDestinationConfiguration$channelArn 欄位。

 2024 年 4 月 25 日

伺服器端合成更新

我們新增了一個物件：PipConfiguration。

我們修改了兩個物件 (LayoutConfiguration、GridConfiguration)。這會影響 GetComposition 的回應，以及 StartComposition 的請求和回應。

 2024 年 3 月 13 日

複合錄製

我們新增了 4 個 StorageConfiguration 端點和 7 個物件 (DestinationDetail、RecordingConfiguration、S3DestinationConfiguration、S3Detail、S3StorageConfiguration、StorageConfiguration、StorageConfigurationSummary)。

我們修改了 3 個物件 (Composition、Destination、DestinationConfiguration)。這會影響 GetComposition 的回應，以及 StartComposition 的請求和回應。

 2023 年 11 月 16 日

伺服器端合成

我們新增了 8 個 Composition 和 EncoderConfiguration 端點以及 11 個物件 (ChannelDestinationConfiguration、Composition、CompositionSummary、Destination、DestinationConfiguration、DestinationSummary、EncoderConfiguration、EncoderConfigurationSummary、GridConfiguration、LayoutConfiguration 和 Video)。

 2023 年 11 月 16 日

階段運作狀態：新參與者資料

已將六個欄位新增至參與者物件：browserName、browserVersion、ispName、osName、osVersion及sdkVersion。這會影響 GetParticipant 回應。

 2023 年 10 月 12 日

參與者權杖

新增了有關不根據目前權杖格式來建置功能的重要備註。

 2023 年 9 月 1 日

推出 IVS 即時串流

此版本隨附重大文件變更。將之前的文件重新命名為 IVS 低延遲串流，並發布了新的 IVS 即時串流文件。IVS 文件登陸頁面現在包含即時串流和低延遲串流的單獨區段。每個區段都有其自己的使用者指南和 API 參考。

IVS 即時串流 API 參考是 IVS 即時串流文件的一部分。之前稱為「IVS 階段 API 參考」。其之前的歷史記錄在文件歷史記錄 (低延遲串流) 中。

 2023 年 8 月 7 日