# 開始使用 IVS 低延遲串流
本文件將引導您完成設定第一個 Amazon Interactive Video Service (IVS) 即時串流的步驟。
**Topics**
+ [步驟 1：建立 AWS 帳戶](getting-started-create-account.md)
+ [步驟 2：設定根使用者和管理使用者](getting-started-setup-users.md)
+ [步驟 3：設定 IAM 許可](getting-started-iam-permissions.md)
+ [步驟 4：建立帶有選用錄製的頻道](getting-started-create-channel.md)
+ [步驟 5：設定串流軟體](getting-started-set-up-streaming.md)
+ [步驟 6：檢視您的即時串流](getting-started-view-stream.md)
+ [步驟 7：檢查服務配額限制 (選用)](getting-started-check-service-quota.md)
+ [步驟 8：防止不需要的內容與觀眾 (建議)](getting-started-prevent-undesired-content.md)
# 步驟 1：建立 AWS 帳戶
若要使用 Amazon IVS，您需要一個 AWS 帳戶。如果您還沒有帳戶，系統會在您註冊時提示您建立帳戶。建立 AWS 帳戶：
1. 開啟 [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)。
1. 請遵循線上指示進行。
部分註冊程序需接收來電或簡訊，並需輸入驗證碼。此外，雖然基本服務層是免費的，但您必須提供帳單資訊。您不需為您註冊的任何 AWS 服務付費，除非您使用這些服務。
1. 建立帳戶後，您將收到一封包含**登入 URL** 和**使用者名稱**的電子郵件，以及包含密碼的另一封電子郵件 (來自您的 AWS 帳戶管理員)。您必須在第一次登入時變更密碼。
若您希望使用現有的 AWS 帳戶，請確認其使用 Amazon IVS 支援的 AWS 區域：
1. 導覽至 [Amazon IVS 主控台](https://console.aws.amazon.com/ivs)。如果您看到常見的 IVS 主控台頁面 (顯示 "Global Solution, regional content" (全球解決方案、區域內容))，則沒有問題；請跳至[步驟 2：設定根使用者和管理使用者](getting-started-setup-users.md)。如果系統將您重新導向至 AWS "unsupported region" (不支援的區域) 頁面，則需要選取新區域。
1. 選取相應的索引標籤 (若為 IVS，請選取**即時串流**；若為 IVS Chat，則選擇**串流聊天**)，然後選取其中一個列出的地區。*請記下您選擇的區域；稍後您將用到此資料*。
若要檢視 AWS 帳戶活動並管理帳戶，您可以隨時前往 [https://aws.amazon.com/](https://aws.amazon.com/) 並選擇 **My Account** (我的帳戶)。
# 步驟 2：設定根使用者和管理使用者
註冊 AWS 帳戶時，會建立 AWS 帳戶根使用者。根使用者有權存取該帳戶中的所有 AWS 服務和資源。作為安全最佳實務，[將管理存取權指派給管理使用者](https://docs.aws.amazon.com/singlesignon/latest/userguide/useraccess.html)，並且僅使用根使用者來執行[需要根使用者存取權的任務](https://docs.aws.amazon.com/IAM/latest/UserGuide/root-user-tasks.html)。
## 保護您的 AWS 帳戶根使用者
1. 若要以管理使用者身分登入 IAM Identity Center，請使用建立 IAM Identity Center 使用者時傳送至您電子郵件地址的登入 URL。如需使用 IAM Identity Center 使用者登入的說明，請參閱《*AWS 登入使用者指南*》中的[登入 AWS 存取入口網站](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)。
如需使用根使用者登入的說明，請參閱《*AWS 登入使用者指南*》中的[以根使用者身分登入](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)。
1. 若要在您的根使用者帳戶上啟用多重要素驗證 (MFA)。
如需指示，請參閱《IAM 使用者指南》**中的[為 AWS 帳戶根使用者啟用虛擬 MFA 裝置 (主控台)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html#enable-virt-mfa-for-root)。
## 建立管理使用者
您應建立管理使用者，讓您可以不使用根使用者處理日常作業。
+ 對於您的日常管理工作，請將管理存取權指派給 AWS IAM Identity Center (AWS Single Sign-On 的後續產品) 中的管理使用者。如需指示，請參閱《*AWS IAM Identity Center (AWS Single Sign-On 的後續產品) 使用者指南*》中的[入門](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)。
+ 若要以管理使用者身分登入 IAM Identity Center，請使用建立 IAM Identity Center 使用者時傳送至您電子郵件地址的登入 URL。如需使用 IAM Identity Center 使用者登入的說明，請參閱《*AWS 登入使用者指南*》中的[登入 AWS 存取入口網站](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)。
# 步驟 3：設定 IAM 許可
接下來，您必須建立 AWS Identity and Access Management (IAM) 政策，為使用者提供一組基本許可 (例如，用於建立 Amazon IVS 頻道、取得串流資訊以及自動錄製到 S3 的許可)，並將該政策指派給使用者。您可以在建立[新使用者](#iam-permissions-new-user)時指派許可，也可以為[現有的使用者](#iam-permissions-existing-user)新增許可。兩種程序如下所示。
如需詳細資訊 (例如，若要了解 IAM 使用者和政策、如何將政策附加到使用者、以及如何限制使用者可以使用 Amazon IVS 執行的動作)，請參閱：
+ 《IAM 使用者指南》**中的[建立 IAM 使用者](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#Using_CreateUser_console)
+ [Amazon IVS 安全性](security.md) 中有關 IAM 和「IVS 的受管政策」的資訊。
+ 對於錄製到 S3 功能：[使用服務連結角色](security-service-linked-roles.md)和《Amazon IVS 使用者指南》**中的 [自動錄製至 Amazon S3](record-to-s3.md)
您可以對 Amazon IVS 使用現有的 AWS 受管政策，也可以建立新政策來自訂要授予一組使用者、群組或角色的許可。兩種方法皆在下面有所描述。
## 對 IVS 許可使用現有的政策
在大多數情況下，您會想要對 Amazon IVS 使用 AWS 受管政策。*IVS 安全性*的 [IVS 的受管政策](security-iam-awsmanpol.md)章節對它們進行了完整描述。
+ 使用 `IVSReadOnlyAccess` AWS 受管政策可讓應用程式開發人員存取所有 IVS Get 和 List API 操作 (同時適用於低延遲和即時串流)。
+ 使用 `IVSFullAccess` AWS 受管政策可讓應用程式開發人員存取所有 IVS API 操作 (同時適用於低延遲和即時串流)。
## 選用：為 Amazon IVS 許可建立自訂政策
請遵循下列步驟：
1. 登入 AWS 管理主控台，然後前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。
1. 在導覽窗格中，選擇**政策**，然後選擇**建立政策**。**Specify permissions** (指定許可) 視窗隨即開啟。
1. 在**指定許可**視窗中，選擇 **JSON** 標籤，將以下 IVS 政策複製並貼上至**政策編輯器**文字區域。(此政策不包括所有 Amazon IVS 動作。您可以視需要新增/刪除 (允許/拒絕) 操作存取許可。如需有關 IVS 操作的詳細資訊，請參閱《[IVS 低延遲串流 API 參考](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/Welcome.html)》。)
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ivs:CreateChannel",
"ivs:CreateRecordingConfiguration",
"ivs:GetChannel",
"ivs:GetRecordingConfiguration",
"ivs:GetStream",
"ivs:GetStreamKey",
"ivs:GetStreamSession",
"ivs:ListChannels",
"ivs:ListRecordingConfigurations",
"ivs:ListStreamKeys",
"ivs:ListStreams",
"ivs:ListStreamSessions"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudwatch:DescribeAlarms",
"cloudwatch:GetMetricData",
"s3:CreateBucket",
"s3:GetBucketLocation",
"s3:ListAllMyBuckets",
"servicequotas:ListAWSDefaultServiceQuotas",
"servicequotas:ListRequestedServiceQuotaChangeHistoryByQuota",
"servicequotas:ListServiceQuotas",
"servicequotas:ListServices",
"servicequotas:ListTagsForResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"iam:AttachRolePolicy",
"iam:CreateServiceLinkedRole",
"iam:PutRolePolicy"
],
"Resource":
"arn:aws:iam::*:role/aws-service-role/ivs.amazonaws.com/AWSServiceRoleForIVSRecordToS3*"
}
]
}
```
------
1. 仍在**指定許可**視窗中，選擇**下一步** (捲動至視窗底部即可看到此選項)。**Review and create** (審查並建立) 視窗隨即開啟。
1. 在**審查並建立**視窗中，輸入**政策名稱**，並選擇性地新增**描述**。請記下政策名稱，因為您在建立使用者時要用到此資料 (如下)。選擇 **Create policy** (建立政策) (位於視窗底部)。
1. 您會返回 IAM 主控台視窗，在其中看到一個橫幅，確認您的新政策已建立。
## 建立新使用者並新增許可
### IAM 使用者存取金鑰
IAM 存取金鑰由存取金鑰 ID 和私密存取金鑰組成。這些金鑰用於簽署您對 AWS 提出的程式設計請求。如果您沒有存取金鑰，可以使用 AWS 管理主控台來建立。根據最佳實務，請勿建立根使用者存取金鑰。
*您只能在建立存取金鑰時，檢視或下載私密存取金鑰。稍後您便無法復原。*不過，您可以隨時建立新的存取金鑰；您必須具有執行必要 IAM 動作的許可。
請務必安全地儲存存取金鑰。切勿與第三方分享 (即使查詢似乎來自 Amazon)。如需詳細資訊，請參閱《IAM 使用者指南》**中的[管理 IAM 使用者的存取金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)。
### 程序
請遵循下列步驟：
1. 在導覽窗格中，選擇 **Users** (使用者)，然後選擇 **Create user** (建立使用者)。**Specify user details** (指定使用者詳細資訊) 視窗隨即開啟。
1. 在**指定使用者詳細資訊**視窗：
1. 在 **User details** (使用者詳細資訊)，輸入要建立的新 **User name** (使用者名稱)。
1. 勾選**提供使用者對 AWS 管理主控台的存取權**。
1. 出現提示時，選取**我要建立 IAM 使用者**。
1. 在**主控台密碼**下選取**自動產生的密碼**。
1. 選取**使用者必須在下次登入時建立新密碼**。
1. 選擇**下一步**。**Set permissions** (設定許可) 視窗隨即開啟。
1. 在**設定許可**下，選取**直接連接政策**。**Permissions policies** (許可策略) 視窗隨即開啟。
1. 在搜尋方塊中，輸入 IVS 政策名稱 (AWS 受管政策或之前建立的自訂政策)。找到後，勾選方塊以選取政策。
1. 選擇 **Next** (下一步) (位於視窗底部)。**Review and create** (審查並建立) 視窗隨即開啟。
1. 在 **Review and create** (審查並建立) 視窗中，確認所有使用者詳細資訊都正確無誤，然後選擇 **Create user** (建立使用者) (位於視窗底部)。
1. **Retrieve password** (擷取密碼) 視窗隨即開啟，其中包含您的**主控台登入詳細資訊**。*安全地儲存此資訊以供日後參考*。當您完成時，請選擇 **Return to users list** (返回使用者清單)。
## 為現有的使用者新增許可
請遵循下列步驟：
1. 登入 AWS 管理主控台，然後前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。
1. 在導覽窗格中，選擇**使用者**，然後選擇要更新的現有使用者名稱。(按一下名稱來選擇名稱；請勿勾選選取方塊。)
1. 在 **Summary** (摘要) 頁面的 **Permissions** (許可) 索引標籤中，選擇 **Add permissions** (新增許可)。**Add permissions** (新增許可) 視窗隨即開啟。
1. 選取**直接連接現有政策**。**Permissions policies** (許可策略) 視窗隨即開啟。
1. 在搜尋方塊中，輸入 IVS 政策名稱 (AWS 受管政策或之前建立的自訂政策)。找到政策後，勾選方塊以選取政策。
1. 選擇 **Next** (下一步) (位於視窗底部)。**Review** (審查) 視窗隨即開啟。
1. 在**檢閱**視窗上，選取**新增許可** (位於視窗底部)。
1. 在**摘要**頁面上，確認已新增 IVS 政策。
# 步驟 4：建立帶有選用錄製的頻道
Amazon IVS 頻道會儲存與即時串流相關的設定資訊。您可以先建立頻道，然後使用頻道的串流金鑰來啟動即時串流，從而為頻道貢獻影片。
在頻道建立過程中，會指定下列項目：
+ *擷取伺服器* 會識別接收串流的特定 Amazon IVS 元件，以及擷取通訊協定 (RTMPS 或 RTMP)。
+ Amazon IVS 會在您建立頻道時指派一個*串流金鑰*並使用它授權串流。***將串流金鑰視為密碼，因為它允許任何人串流至頻道***。
+ *播放 URL* 會識別端點以便開始特定頻道的播放。可以全域使用此端點。它會自動從 Amazon IVS 全球內容交付網路中選擇最佳位置，供觀眾串流影片。(請注意，Amazon IVS 不支援用於播放的自訂網域。*請勿使用您自己的網域代理播放 URL；這樣做不起作用，並會導致問題。*)
您可以透過 Amazon IVS 主控台或 AWS CLI 建立頻道，包含錄製或不錄製。頻道建立和錄製將在下面討論。
# 自動錄製至 Amazon S3
您可以選擇啟用頻道的錄製功能。如果啟用了自動錄製到 S3 功能，則頻道上的所有串流都會錄製並儲存到您擁有的 Amazon S3 儲存貯體中。隨後，錄製內容可用於隨需播放。
*設定它是一個進階選項。*依預設，會在建立頻道時停用錄製。
在設定頻道以進行錄製之前，您必須先建立 *recording-configuration*。這項資源指定了用於為頻道儲存錄製串流的 Amazon S3 位置。您可以使用主控台或 CLI 建立和管理錄製組態;兩種程序如下所示。建立錄製組態之後，您可以在建立頻道時 (如下所述) 或稍後透過更新現有頻道，將其與頻道建立關聯 (請參閱 API 中的 [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) 和 [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html))。您可以將多個頻道與相同的錄製組態建立關聯。您可以刪除不再與任何頻道相關聯的錄製組態。
請謹記以下幾點限制：
+ 您必須擁有 S3 儲存貯體。也就是說，設定要錄製的頻道的帳戶必須擁有可供儲存錄製內容的 S3 儲存貯體。
+ 頻道、錄製組態和 S3 位置三者所在的 AWS 區域必須相同。如果您在其他區域建立頻道並想錄製，則必須在這些區域設定錄製組態和 S3 儲存貯體。
必須使用您的 AWS 登入資料進行授權，才能錄製到 S3 儲存貯體。為了提供 IVS 必要的存取權限，建立錄製組態時會自動建立 AWS IAM [服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR)：SLR 僅限於在特定儲存貯體上提供 IVS 寫入許可。
請注意，串流位置與 AWS 之間或 AWS 內部的網路問題可能會導致在錄製串流時遺失某些資料。在這些情況下，Amazon IVS 會將即時串流優先於錄製。如需備援，請透過串流工具在本機進行錄製。
如需詳細資訊 (包括如何在錄製的檔案上設定後製處理或 VOD 播放)，請參閱[IVS 自動錄製至 Amazon S3 \$1 低延遲串流](record-to-s3.md)。
## 如何停用錄製
若要在現有頻道上停用 Amazon S3 錄製：
+ 主控台 — 在相關頻道的詳細資訊頁面上，在**錄製和儲存**串流部分中,選擇**已停用**，然後選擇**儲存頻道**。這會移除錄製組態與頻道的關聯；將不再錄製該頻道上的串流。
+ CLI — 執行 `update-channel` 命令並將錄製組態 ARN 作為空字串傳入：
```
aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn ""
```
這將傳回一個 `recordingConfigurationArn` 為空字串的頻道物件，表示錄製已停用。
# 建立 IVS 頻道的主控台說明
這些步驟分為三個舞台：初始頻道設定、設定以自動錄製到 Amazon S3 (選用) 以及最終頻道建立。
## 初始頻道設定
1. 開啟 [Amazon IVS 主控台](https://console.aws.amazon.com/ivs)。
(您也可以透過 [AWS 管理主控台](https://console.aws.amazon.com/)來存取 Amazon IVS 主控台。)
1. 從導覽列中，使用 **Select a Region** (選擇區域) 下拉式清單選擇區域。將會在此區域中建立您的新頻道。
1. 在 **Get started** (開始使用) 方塊 (右上角) 中，選擇 **Create Channel** (建立頻道)。
1. 在 **Channel configuration** (頻道組態) 中，接受 **Default configuration** (預設組態)。或者，指定 **Channel name** (頻道名稱)。頻道名稱不是唯一的，但它們可讓您區分頻道 ARN (Amazon 資源名稱) 以外的頻道。
注意：**自訂組態** 可用於指定特定非預設值，例如頻道類型或 RTMP (而非 RTMPS) 擷取。此處未記錄自訂規格。
![\[使用 IVS 主控台建立頻道：在「建立頻道」視窗中指定頻道組態。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/LowLatencyUserGuide/images/Accept_Default_Configuration.png)
1. 如果您想要自動錄製到 Amazon S3，請繼續下面的[進行設定以自動錄製到 Amazon S3 (選用)](#getting-started-create-channel-console-record-s3)。否則，請跳過該操作並直接進入[最終頻道建立](#getting-started-create-channel-console-final-creation)。
## 進行設定以自動錄製到 Amazon S3 (選用)
建立新頻道時，請依照下列步驟啟用錄製功能：
1. 在**建立頻道**頁面的**錄製和存放串流**下，開啟**啟用自動錄製**。顯示其他欄位，以選擇現有**錄製組態**或建立新的錄製組態。
![\[使用 IVS 主控台建立頻道：選擇自動錄製到 Amazon S3。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/LowLatencyUserGuide/images/Select_Auto_Record.png)
1. 選擇 **Create recording configuration** (建立錄製組態)。新的視窗將開啟，其中包含用於建立 Amazon S3 儲存貯體並將其附加到新錄製組態的選項。
![\[使用 IVS 主控台建立頻道：指定錄製組態的儲存選項。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/LowLatencyUserGuide/images/Click_Create_Recording_Config.png)
1. 填寫以下欄位：
1. 在選填欄位中輸入**錄製組態名稱**。
1. 在**錄製組態**下，接受**預設組態**。注意：**自訂組態**可用於指定某些非預設值，例如錄製的轉譯或合併分段的串流。此處未記錄自訂規格。
1. 輸入 **Bucket name (儲存貯體名稱)**。
1. 選擇**建立錄製組態**以建立具有專屬 ARN 的新錄製組態資源。通常，建立錄製組態需要幾秒鐘，但最多可能需要 20 秒鐘。建立錄製組態時，您會返回到**建立頻道**視窗。其中，**錄製和存放串流**區域會顯示您的新**錄製組態**，其**狀態**為**作用中**，以及您建立的 S3 儲存貯體 (**儲存**)。
![\[使用 IVS 主控台建立頻道：新錄製組態建立完成。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/LowLatencyUserGuide/images/Create_Recording_Config.png)
## 最終頻道建立
1. 在**建立頻道**視窗底部，選擇**建立頻道**，即可使用專屬 ARN 建立新頻道。若要查看頻道詳細資訊，請展開**詳細資訊**。(注意：如果您沒有啟用錄製功能，**自動錄製到 S3** 設定為**已停用**，並且螢幕中沒有**錄製組態**部分)。
![\[使用 IVS 主控台建立頻道：在 Channel Details (頻道詳細資訊) 視窗中檢視頻道串流、播放和錄製組態以及串流工作階段。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/LowLatencyUserGuide/images/Final_Channel_Creation.png)
1. **重要**：
+ 在**串流組態**區域中，請注意**擷取伺服器**和**串流金鑰**。您將在下一個步驟中使用它們來設定串流。
+ 在**播放組態**區域中，請注意**播放 URL**。您稍後會使用它來播放您的串流。
**注意**：若要查看 SRT 值 (端點和密碼短語)，請在**串流組態**區域中展開**其他擷取選項**。
# 建立 IVS 頻道的 CLI 說明
使用 AWS CLI 建立頻道是進階選項，需要您先在機器上下載並設定 CLI。如需詳細資訊，請參閱 [AWS 命令列界面使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)。
根據您要建立具備錄製功能或不具備錄製功能的頻道，請執行下列兩項程序之一。
## 建立沒有錄製功能的頻道
1. 執行 `create-channel` 命令並傳入選用名稱：
```
aws ivs create-channel --name test-channel
```
1. 這將返回一個新的頻道：
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "none",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **重要**：請注意 `ingestEndpoint`、`streamKey value` 和 `playbackUrl`。您將使用它們來設定串流和播放。
## 建立具有錄製功能的頻道
**必要條件：**開始此程序之前，請建立 Amazon S3 儲存貯體並注意其 ARN。請參閱 [Amazon S3 入門](https://docs.aws.amazon.com//AmazonS3/latest/userguide/GetStartedWithS3.html)。S3 儲存貯體必須位於您要建立錄製組態的相同區域；請參閱下面步驟 1 中的已知問題。
然後依照以下步驟來建立頻道：
1. 執行 `create-recording-configuration` 命令並傳入現有 Amazon S3 儲存貯體的 ARN：
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket}
```
除此之外，您亦可傳遞 `thumbnail-configuration` 參數，手動設定縮圖錄製模式和縮圖間隔：
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60
```
可選擇傳送 `recording-reconnect-window-seconds` 參數以啟用分段串流的合併功能：
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60
```
**已知問題：**在 us-east-1 區域中，如果您使用 AWS CLI 建立錄製組態，即使 S3 儲存貯體位於其他區域，也會傳回成功。在此情況下，錄製組態的 `state` 為 `CREATE_FAILED` (而非 `ACTIVE`)。(在其他區域中，如果儲存貯體位於不同區域，CLI 會正確傳回失敗。)
**解決方法：**確定您的 S3 儲存貯體與錄製組態位於相同的區域。如果您在不同區域建立錄製組態作為您的 S3 儲存貯體，請刪除該錄製組態，並從正確區域使用 S3 儲存貯體建立新的錄製組態。
1. 這會傳回具有唯一 ARN 的新錄製組態。錄製組態的狀態為 `CREATING`，表示正在建立過程中。
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "CREATING",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. 通常，建立錄製組態需要幾秒鐘，但最多可能需要 20 秒鐘。若要檢查錄製組態是否已建立，請執行 `get-recording-configuration` 命令：
```
aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. 這將傳回一個回應，指示已建立錄製組態 (`state` 為 `ACTIVE`)：
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "ACTIVE",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. 若要建立頻道並啟用錄製功能，請執行 `create-channel` 命令並傳入錄製組態 ARN：
```
aws ivs create-channel --name channel-live --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
或者，若要在現有頻道上啟用錄製功能，請執行 `update-channel` 命令並傳入錄製組態 ARN：
```
aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. 這會傳回一個頻道物件，`recordingConfigurationArn` 的值為非 none 值，表示錄製已啟用。(下面的回應來自`create-channel`。所以此`update-channel`回應不包含`streamKey`物件)。
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **重要**：請注意 `ingestEndpoint`、`streamKey value` 和 `playbackUrl`。您將使用它們來設定串流和播放。
# 步驟 5：設定串流軟體
您可以使用以下方式串流 (低延遲) 到 Amazon IVS：
+ 支援 RTMPS 的原生 [IVS 廣播 SDK](#broadcast-sdk)。建議採用此方式，尤其在生產情境下。
+ [Amazon IVS 主控台](#ivs-console)：適用於測試串流。
+ 其他串流軟體和硬體編碼器：您可以使用任何支援 RTMP、RTMPS 或 SRT 通訊協定的串流編碼器。以下介紹幾個範例，說明如何運用 Open Broadcast Software (OBS) 與 FFmpeg，結合 RTMPS 和 SRT 進行串流。RTMPS 透過使用加密的 TLS 串流來實現高安全性。
主要編碼器設定為關鍵影格間隔 (2 秒) 和解析度/位元速率/影格播放速率 (相互關聯)。如需有關編碼器設定的詳細資訊，請參閱：
+ [串流組態](streaming-config.md) (位於 *Amazon IVS 使用者指南*)
+ 這篇落格文章：[使用 Amazon Interactive Video Service 設定串流](https://aws.amazon.com/blogs/media/setting-up-for-streaming-with-amazon-ivs/)
**備註：**
+ Amazon IVS 串流的最長持續時間為 48 小時。之後，串流終止並且串流工作階段中斷連線。成功的重新連線 (自動或手動) 會啟動新的串流。
+ 如果編碼器停止傳送資料 (例如，因為暫時性的網路問題而停止傳送)，Amazon IVS 會等待 30 秒。如果在此期間沒有收到任何廣播器資料，Amazon IVS 就會中斷連線。
## 使用 Amazon IVS 廣播開發套件進行串流
若要從您的 iOS 或 Android 應用程式廣播，您可以使用 Amazon IVS 廣播開發套件。廣播開發套件利用了 Amazon IVS 架構，並且會持續使用 Amazon IVS 的改善項目和新功能。作為原生行動廣播開發套件，其設計目的是針對您的應用程式和使用者存取應用程式的裝置，將效能影響降至最低。
| 若要從...廣播 | 您可以使用... | 備註 |
| --- | --- | --- |
| Android 或 iOS 應用程式 | Amazon IVS Android 或 iOS 廣播開發套件 | 作為原生行動廣播開發套件，其設計目的是針對您的應用程式和使用者存取應用程式的裝置，將效能影響降至最低。 |
| Web 環境 | Amazon IVS Web 廣播開發套件 | 作為 Web 廣播開發套件，Amazon IVS Web 廣播開發套件可讓您使用 WebRTC 從 Web 環境進行廣播。其擁有跨瀏覽器和跨平台的支援。 |
如需詳細資訊，請參閱 [IVS 廣播 SDK \$1 低延遲串流](broadcast.md)。
## 使用 Amazon IVS 主控台進行串流
1. 開啟 [Amazon IVS 主控台](https://console.aws.amazon.com/ivs)。
(您也可以透過 [AWS 管理主控台](https://console.aws.amazon.com/)來存取 Amazon IVS 主控台。)
1. 在導覽窗格中選擇**頻道**。(如果導覽窗格已收起，選取漢堡圖示即可展開。)
1. 選擇要廣播的頻道，前往其詳細資訊頁面。
1. 選取**廣播**索引標籤。(索引標籤位於**一般組態**區段下方)。
1. 系統會提示您授予 IVS 主控台存取攝影機和麥克風的權限；請**允許**這些權限。
1. 在**廣播**索引標籤的底部，使用下拉式方塊選擇麥克風和攝影機的輸入裝置。
1. 若要開始串流，請選取**開始廣播**。
1. 若要檢視即時串流，請前往**播放**索引標籤。
**注意**：開始串流後，預期會有短暫的延遲 (通常在 30 秒內)，才能在播放索引標籤中檢視。
您可以使用此功能同時廣播到多個頻道。
**請注意**：從主控台進行串流會耗用資源，而且會產生即時影片輸入費用。如要深入了解，請參閱 IVS 定價頁面上的[即時影片輸入費用](https://aws.amazon.com/ivs/pricing/#Low-Latency_Streaming)。
## 透過 RTMPS 使用 OBS Studio 串流
([OBS Studio](https://obsproject.com/)) 是一個免費的開放原始碼軟體套件，用於錄製和即時串流。OBS 提供即時來源和裝置擷取、場景合成、編碼、錄製和串流。
請依照以下步驟，使用 OBS Studio v30.2 以上版本快速開始並執行：
1. 下載並安裝軟體：[https://obsproject.com/download](https://obsproject.com/download)。
1. 執行 OBS Studio **自動組態精靈**，它在您第一次載入 OBS Studio 時出現。請依照步驟執行並接受預設值。
1. 在**串流資訊**中，從**服務**下拉式清單中選擇 **Amazon IVS**，然後輸入**串流金鑰**。
如果您是使用 Amazon IVS 主控台建立頻道，則您在 OBS 中輸入的**串流金鑰**就是主控台的**串流金鑰**：`sk_us-west-2_abcd1234efgh5678ijkl`
如果您是使用 AWS CLI 建立頻道，則您在 OBS 中輸入的**串流金鑰**是來自 CLI 回應的 **streamKey 值** `sk_us-west-2_abcd1234efgh5678ijkl`
如果您的 IVS 頻道設定為多軌視訊輸入，請選取**啟用多軌視訊**。或者，您也可以自行設定**視訊軌數上限**和**串流頻寬上限**，這樣就能限制系統自動幫您設定的串流參數。
1. 對於 **Video Output Resolution** (影片輸出解析度) 和 **Bitrate** (位元速率)，請參閱 *Amazon IVS 串流組態*中的[頻道類型](streaming-config.md#streaming-config-settings-channel-types)。如果 OBS 精靈選擇的任一值超過了 Amazon IVS 允許的值，您應該手動調整值以避免與 Amazon IVS 的連線失敗。精靈完成後：
1. 若要調整影片解析度，請使用 **Settings > Video > Output (Scaled) Resolution** (設定 > 影片 > 輸出 (縮放) 解析度)。
1. 若要調整影片位元速率，請使用 **Settings > Output > Streaming > Video Bitrate** (設定 > 輸出 > 串流 > 影片位元速率)。
**注意：**如果您先前已勾選**啟用多軌視訊**，這不會影響即時串流。
1. 建議使用 2 秒的**關鍵影格間隔**來提高串流穩定性，並避免在觀眾播放時緩衝。精靈完成後，進入**設定 > 輸出 > 輸出模式**，選取**進階**，並確保**串流**索引標籤中的**關鍵影格間隔**為 2。
**注意：**如果您先前已勾選**啟用多軌視訊**，系統會自動設定關鍵影格間隔。
1. 在 OBS Studio 主視窗中，選擇**開始串流**。
有關使用 OBS Studio 進行串流的更多資訊，請參閱 [OBS Studio 快速入門](https://obsproject.com/wiki/OBS-Studio-Quickstart)。
您可以稍後手動修改您的 OBS 設定：
1. 選擇 **Settings > Stream** (設定 > 串流)。
1. 從下拉式清單中選擇 **Amazon IVS**。
1. 貼上**串流金鑰**。
您可以隨時再次執行精靈：選擇 **Tools > Auto-Configuration Wizard** (工具 > 自動組態精靈)。
或者，在**設定 > 一般**中，請啟用本機錄製功能，以儲存您的即時串流供日後使用。如前所述，廣播和 AWS 之間或 AWS 內部的網路問題可能會導致在錄製串流時遺失某些資料。在這些情況下，Amazon IVS 會將即時串流優先於錄製。透過串流工具進行本機錄製，可提供備援。
建議您定期檢查 OBS Studio 更新並更新至最新版本。(例如，如果您收到「無法連接至伺服器」錯誤，則可能正在使用不支援 RTMPS 的舊版本的 OBS Studio。)
## 透過 SRT 使用 OBS Studio 串流
請依照下列步驟，使用安全可靠的傳輸通訊協定快速開始並執行：
1. 下載並安裝軟體：[https://obsproject.com/download](https://obsproject.com/download)。
1. 執行 OBS Studio **自動組態精靈**，它在您第一次載入 OBS Studio 時出現。請依照步驟執行並接受預設值。
1. 在 **Stream Information** (串流資訊) 中，從 **Service** (服務) 下拉式選單中選擇 **Custom...** (自訂...) 並輸入 **Server (Ingest server)** (伺服器 (擷取伺服器)) 和 **Stream Key** (串流金鑰)。
如果您使用 AWS CLI 建立頻道：
+ 您在 OBS 中輸入的**伺服器**是五項組合：
+ 擷取通訊協定：`srt://`
+ CLI 回應中 `srt` 結構的**端點**：
`a1b2c3d4e5f6.srt.live-video.net`
+ 連接埠：`9000`
+ 串流 ID，這是來自 CLI 回應的 **streamKey 值**：
`sk_us-west-2_abcd1234efgh5678ijkl`
+ 用於加密內容的密碼短語。只有在未啟用**不安全的擷取**時，才能使用此功能。
`ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ`
完整項目為：
`srt://a1b2c3d4e5f6.srt.live-video.net:9000?streamid=sk_us-west-2_abcd1234efgh5678ijkl&passphrase=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ`
+ 使用 SRT 通訊協定時，OBS 中輸入的**串流金鑰**會保持空白。
1. 對於 **Video Output Resolution** (影片輸出解析度) 和 **Bitrate** (位元速率)，請參閱 *Amazon IVS 串流組態*中的[頻道類型](streaming-config.md#streaming-config-settings-channel-types)。如果 OBS 精靈選擇的任一值超過了 Amazon IVS 允許的值，您應該手動調整值以避免與 Amazon IVS 的連線失敗。精靈完成後：
1. 若要調整影片解析度，請使用 **Settings > Video > Output (Scaled) Resolution** (設定 > 影片 > 輸出 (縮放) 解析度)。
1. 若要調整影片位元速率，請使用 **Settings > Output > Streaming > Video Bitrate** (設定 > 輸出 > 串流 > 影片位元速率)。
1. 建議使用 2 秒的**關鍵影格間隔**來提高串流穩定性，並避免在觀眾播放時緩衝。精靈完成後，進入**設定 > 輸出 > 輸出模式**，選取**進階**，並確保**串流**索引標籤中的**關鍵影格間隔**為 2。
1. 在 OBS Studio 主視窗中，選擇**開始串流**。
您可以稍後手動修改您的 OBS 設定：
1. 選擇 **Settings > Stream** (設定 > 串流)。
1. 從下拉式清單中選擇 **Custom** (自訂)。
1. 在 **Server** (伺服器) 和/或 **Stream Key** (串流金鑰) 中貼上。
您可以隨時再次執行精靈：選擇 **Tools > Auto-Configuration Wizard** (工具 > 自動組態精靈)。
或者，在**設定 > 一般**中，請啟用本機錄製功能，以儲存您的即時串流供日後使用。如前所述，廣播和 AWS 之間或 AWS 內部的網路問題可能會導致在錄製串流時遺失某些資料。在這些情況下，Amazon IVS 會將即時串流優先於錄製。透過串流工具進行本機錄製，可提供備援。
建議您定期檢查 OBS Studio 更新並更新至最新版本。(例如，如果您收到「無法連線至伺服器」錯誤，則可能正在使用不支援 RTMPS 的舊版 OBS Studio。)
## 使用 FFmpeg 軟體透過 RTMPS 串流錄製的視訊
請遵循下列步驟：
1. 下載並安裝 FFmpeg：[https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html)。
1. 將 `$VIDEO_FILEPATH` 設定為要串流 MP4 影片的位置：
```
VIDEO_FILEPATH=/home/test/my_video.mp4
```
1. 將 `STREAM_KEY` 設定為您的 StreamKey **值**：
```
STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl
```
1. 將 `INGEST_ENDPOINT` 設定為 **ingestEndpoint** (從 AWS CLI 進行)：
```
INGEST_ENDPOINT=a1b2c3d4e5f6.global-contribute.live-video.net
```
1. 開始使用以下終端命令進行串流 (這是全部一行)：
```
ffmpeg -re -stream_loop -1 -i $VIDEO_FILEPATH -r 30 -c:v libx264 -pix_fmt yuv420p -profile:v main -preset veryfast -x264opts "nal-hrd=cbr:no-scenecut" -minrate 3000 -maxrate 3000 -g 60 -c:a aac -b:a 160k -ac 2 -ar 44100 -f flv rtmps://$INGEST_ENDPOINT:443/app/$STREAM_KEY
```
*請注意，上述命令是一個範例。對於生產串流，請根據您的需要調整參數。*
## 使用 FFmpeg 軟體透過 SRT 串流錄製的視訊
1. 下載並安裝 FFmpeg：[https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html)。如果您是使用舊/編譯版本的 FFmpeg，請使用 `--enable-libsrt` 標記建置新版本。
1. 確認 FFmpeg 是否支援 SRT：執行下列命令，並檢查輸出結果中是否包含 `libsrt`。如未顯示 `libsrt`，請重建或取得支援 SRT 的較新版 FFmpeg。
```
ffmpeg -version | grep enable-libsrt
```
1. 將 `$VIDEO_FILEPATH` 設定為要串流 MP4 影片的位置：
```
VIDEO_FILEPATH=/home/test/my_video.mp4
```
1. 將 `STREAM_KEY` 設定為您的 StreamKey **值**：
```
STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl
```
1. 將 `INGEST_ENDPOINT` 設定為您的**端點** (從 `srt` 物件下的 AWS CLI 取得)：
```
INGEST_ENDPOINT=a1b2c3d4e5f6.srt.live-video.net
```
1. 將 `PASSPHRASE` 設定為您的**密碼短語** (從 `srt` 物件下的 AWS CLI 取得)。只有在頻道未啟用不安全的擷取時，才使用密碼短語。
```
PASSPHRASE=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ
```
1. 開始使用以下終端命令進行串流 (這是全部一行)：
```
ffmpeg -re -i $VIDEO_FILEPATH -c copy -f mpegts "srt://$INGEST_ENDPOINT:9000?streamid=$STREAM_KEY&passphrase=$PASSPHRASE”
```
# 步驟 6：檢視您的即時串流
您可以使用下列工具檢視即時串流：
+ 原生 [IVS 播放器 SDK](#view-stream-player-sdks)。
+ [Amazon IVS 主控台](#view-stream-console)。
## 使用 Amazon IVS 播放器 SDK 檢視
1. 設定 IVS 播放器。您可以從 [IVS 播放器 SDK 概觀](player.md)開始，然後閱讀適用的特定平台播放器指南。
1. 從 [Amazon IVS 主控台](https://console.aws.amazon.com/ivs)取得建立頻道時產生的**播放 URL**。(請參閱本*入門*指南中前面關於[最終頻道建立](create-channel-console.md#getting-started-create-channel-console-final-creation)一節。)
1. 使用播放 URL 呼叫 `player.load()`。
## 使用 Amazon IVS 主控台檢視
1. 開啟 [Amazon IVS 主控台](https://console.aws.amazon.com/ivs)。
(您也可以透過 [AWS 管理主控台](https://console.aws.amazon.com/)來存取 Amazon IVS 主控台。)
1. 在導覽窗格中，選擇**直播頻道**。(如果導航窗格已折疊，請先選擇漢堡圖示將其展開。)
1. 選擇您要檢視其串流的頻道，前往該頻道的詳細資訊頁面。
正在頁面的**即時串流**部分中播放即時串流。
**請注意**：從主控台進行播放會耗用資源，而且會產生即時影片輸出費用。如要深入了解，請參閱 IVS 定價頁面上的[即時影片輸出費用](https://aws.amazon.com/ivs/pricing/#Live_Video_Output_Costs)。
**備註：**開始串流後，會有短暫的延遲 (最多 30 秒，通常較少)，然後才能在主控台中檢視串流。
# 步驟 7：檢查服務配額限制 (選用)
所有帳戶均有並行觀眾和並行廣播數目限制。*確保您的限制足夠，並在需要時請求增加，特別是當您正在規劃大型串流事件時*。請參閱 [IVS Service Quotas](service-quotas.md)。
# 步驟 8：防止不需要的內容與觀眾 (建議)
惡意使用者可能會試圖在您的平台上重新串流不需要的內容 (例如：職業體育運動)，或是在未經授權的情況下，將您的平台串流嵌入其他網站。這種串流會大幅增加應用程式所提供的即時串流影片數量以及與之相關的成本，而不會為您的業務增加價值。除了為您提供停止使用中串流的控制項之外，Amazon IVS 還提供資源，協助您從一開始就偵測和防止此類行為；請參閱 [IVS 中不需要的內容與觀眾](undesired-content.md)。
若要限制視訊只能在特定來源和/或國家/地區播放，請使用播放限制政策。請注意，這些政策只能與公有頻道搭配使用。[IVS 中不受歡迎的內容和檢視器](undesired-content.md)也會討論使用私有頻道來控制不受歡迎的內容。
請注意，播放限制原則 (例如地理封鎖) 無法與播放授權併用。如果為頻道啟用播放授權，則會忽略任何已設定的播放限制原則。若要對私有頻道強制執行地理限制，請在發出播放符記之前驗證使用者在符記生成邏輯中的位置。