

# IVS 廣播 SDK \| 低延遲串流
<a name="broadcast"></a>

Amazon 互動影片服務 (IVS) 低延遲串流 SDK 適用於使用 Amazon IVS 建置應用程式的開發人員。此 SDK 的設計目的是利用 Amazon IVS 架構，並持續使用 Amazon IVS 的改善之處和新功能。作為原生廣播 SDK，其設計目的是將對您的應用程式和使用者存取應用程式的裝置的效能影響降至最低。

您的應用程式可以利用 Amazon IVS 廣播 SDK 的主要功能：
+ **高品質串流** — 廣播 SDK 支援高品質串流。使用攝影機錄影，並以高達 1080p 的畫質進行編碼，實現高品質的觀賞體驗。
+ **自動調整位元速率** — 智慧型手機使用者處於移動狀態，網路狀況可能在整個廣播過程中變更。Amazon IVS 廣播 SDK 會自動調整影片位元速率，以適應不斷變化的網路狀況。
+ **縱向和橫向支援** — 無論使用者如何手持裝置，影像都會在右側向上顯示並正確縮放。廣播 SDK 支援縱向和橫向畫布大小。當使用者的裝置旋轉方向與影片設定的方向不同時，它會自動管理長寬比。
+ **安全串流** — 使用 TLS 加密使用者的廣播，保護串流的安全。
+ **外部音訊裝置** — Amazon IVS 廣播 SDK 支援音訊插孔，USB 和藍牙 SCO 外接麥克風。

## 平台需求：
<a name="broadcast-platform-requirements"></a>

### 原生平台
<a name="broadcast-native-platforms"></a>


| 平台 | 支援的版本 | 
| --- | --- | 
| Android | 6.0 版和更新版本 | 
| iOS | 14\+<br /> 如果廣播對您的應用程式至關重要，請使用 [UIRequiredDeviceCapabilities](https://developer.apple.com/documentation/bundleresources/information_property_list/uirequireddevicecapabilities) 將 Metal 指定為從 Apple App Store 下載應用程式的必要項目。 | 

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

### 桌面瀏覽器
<a name="browser-desktop"></a>


| 瀏覽器 | 支援的平台 | 支援的版本 | 
| --- | --- | --- | 
| Chrome | Windows、macOS | 兩個主要版本 (目前版本和最新的先前版本) | 
| Firefox | Windows、macOS | 兩個主要版本 (目前版本和最新的先前版本) | 
| Edge | Windows 8.1 及更新版本 | 兩個主要版本 (目前版本和最新的先前版本)<br />排除邊緣舊版 | 
| Safari | macOS | 兩個主要版本 (當前版本和最新的先前版本) | 

### 行動裝置瀏覽器
<a name="browser-mobile"></a>


| 瀏覽器 | 支援的版本 | 
| --- | --- | 
| 適用於 iOS 的 Chrome，適用於 iOS 的 Safari | 兩個主要版本 (目前版本和最新的先前版本) | 
| 適用於 iPad 的 Chrome、適用於 iPad 的 Safari | 兩個主要版本 (目前版本和最新的先前版本) | 
| 適用於 Android 的 Chrome | 兩個主要版本 (目前版本和最新的先前版本) | 

## Webview
<a name="broadcast-webviews"></a>

Web 廣播 SDK 不提供對 Webview 或類似 Web 之環境 (電視、主控台等) 的支援。如需行動裝置實作，請參閱適用於 [Android](broadcast-android.md) 和 [iOS](broadcast-ios.md) 的《低延遲串流廣播 SDK 指南》。

## 必要的裝置存取權
<a name="broadcast-device-access"></a>

廣播 SDK 需要存取裝置的攝影機和麥克風，包括裝置內建的攝影機和麥克風，以及透過藍牙、USB 或音訊插孔連接的攝影機和麥克風。

## 支援
<a name="broadcast-support"></a>

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


| 對於此 Amazon IVS 廣播 SDK： | 請使用： | 
| --- | --- | 
| Android | `BroadcastSession` 上的 `getSessionId` 功能 | 
| iOS | `sessionId` 的 屬性`IVSBroadcastSession` | 
| Web | `getSessionId` 函數 | 

將此廣播工作階段識別符提供給 AWS 支援部門。使用它，他們就可以取得資訊來協助您對問題進行疑難排解。

**備註：**廣播 SDK 會持續改善。請參閱可用版本的 [Amazon IVS 版本備註](release-notes.md)以及已修正的問題。如果適當，請在聯絡支援部門之前，先更新您的廣播 SDK 版本，並查看是否可以解決您的問題。

### 版本控制
<a name="broadcast-support-versioning"></a>

Amazon IVS 廣播 SDK 使用[語意版本控制](https://semver.org/)。

對於此討論，假設：
+ 最新版本為 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。