# ステップ 2: ステージを作成する
ステージは、参加者がリアルタイムでビデオを送受信できる仮想スペースです。リアルタイムストリーミング API の基盤となるリソースです。コンソールまたは CreateStage オペレーションのいずれかを使用し、ステージを作成できます。
可能な限り、再利用のために古いステージを保持するのではなく、論理セッ ションごとに新しいステージを作成し、終了したら削除することをお勧めします。古くなったリソース (再利用されない古いステージ) がクリーンアップされなければ、ステージの最大数の制限に早く到達する可能性が高くなります。
Amazon IVS コンソールまたは AWS CLI を介して、個々の参加者による記録の有無を問わずにステージを作成できます。ステージの作成および記録については、以下で説明します。
## 個々の参加者の録画
ステージの個々の参加者による記録を有効にするオプションがあります。個々の参加者の記録における S3 機能が有効になっている場合、ステージへの個々の参加者によるブロードキャストはすべて記録され、ユーザーが所有する Amazon S3 ストレージバケットに保存されます。その後、この録画はオンデマンド再生が可能です。
*このセットアップは拡張オプションです。*デフォルトでは、ステージの作成時に記録は無効になっています。
記録用にステージを設定する前に、*保存設定*を作成する必要があります。ステージの記録されたストリームが保存される Amazon S3 ロケーションを指定するリソースです。コンソールまたは CLI を使用して保存設定を作成および管理することができます。両方の手順を以下に示されます。保存設定を作成したら、ステージ作成時 (以下で説明) または既存のステージを更新することで後で作成する際、保存設定をステージに関連付けします。(API で「[CreateStage](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStage.html)」および「[UpdateStage](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_UpdateStage.html)」を参照してください) 複数のステージを同じ保存設定に関連付けることができます。すべてのステージに関連付けされなくなった保存設定を削除できます。
次の制約に注意が必要です。
+ S3 バケットを所有している必要があります。つまり、記録されるステージを設定するアカウントは、記録を保存する S3 バケットを所有している必要があります。
+ ステージ、保存設定、S3 ロケーションは同じ AWS リージョンにある必要があります。他のリージョンでステージを作成して記録する場合、それらのリージョンで保存設定および S3 バケットも設定する必要があります。
S3 バケットに録画するには、AWS 認証情報を使用した認可が必要です。IVS に必要なアクセス権を付与するため、録画設定が作成される際に AWS IAM [サービスにリンクされたロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR) が自動的に作成されます。SLR は、特定のバケットのみに IVS 書き込み許可を付与するように制限されます。
ストリーミングロケーションおよび AWS 間、あるいは AWS 内のネットワーク問題により、ストリームの記録中に一部データが失われる可能性があることに注意してください。このような場合、Amazon IVS は録画よりもライブストリームを優先します。冗長性のために、ストリーミングツールでローカルに録画してください。
記録したファイルのポスト処理や VOD 再生の設定方法などの詳細については「[個々の参加者の録画](rt-individual-participant-recording.md)」を参照してください。
### 録画を無効にする方法
既存のステージで Amazon S3 記録を無効にする方法
+ コンソール — 関連するステージの詳細ページの**個々の参加者のストリーミングを記録する**セクションで、**[S3 への自動録画]** の **[自動録画の有効化]** をオフに切り替え、**[変更を保存する]** を選択します。保存設定によるステージとの関連付けが解除され、ステージ上のストリームが記録されなくなります。
+ CLI — `update-stage`コマンドを実行し、録画設定の ARN を空の文字列として渡します。
```
aws ivs-realtime update-stage --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh --auto-participant-recording-configuration storageConfigurationArn=""
```
記録が無効になったことを示す `storageConfigurationArn` の空の文字列が含まれるステージオブジェクトが返されます。
## IVS ステージを作成するためのコンソール手順
1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)を開きます。
([AWS マネジメントコンソール](https://console.aws.amazon.com/)から Amazon IVS コンソールにアクセスすることもできます。)
1. 左側のナビゲーションペインで **[ステージ]** を選択し、**[ステージを作成]** を選択します。**[ステージを作成]** ウィンドウが表示されます。
![\[[ステージを作成] ウィンドウを使用して、新しいステージとそのステージの参加者トークンを作成します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_IPR.png)
1. 必要に応じて、**[ステージ名]** を入力します。
1. 個々の参加者の記録を有効にする場合、以下の「[Amazon S3 に個々の参加者の自動記録を設定する (オプション)](#getting-started-create-stage-ipr)」の手順を完了させてください。
1. **[ステージを作成]** を選択してステージを作成します。新しいステージのステージ詳細ページが表示されます。
### Amazon S3 に個々の参加者の自動記録を設定する (オプション)
ステージの作成中に個々の参加者の記録を有効にするには、次の手順に従ってください。
1. **ステージを作成する**ページの**個々の参加者を記録する**で、**[自動録画の有効化]** をオンにします。**[記録済みメディアタイプ]** を選択し、既存の **[保存設定]** を選択するか新しい保存設定を作成し、ある時間間隔でサムネイルを記録するかどうかを選択するため、追加のフィールドが表示されます。
![\[[個々の参加者の記録] ダイアログを使用して、ステージによる個々の参加者の記録を設定します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_enable_IPR.png)
1. 記録するメディアタイプを選択します。
1. **[保存設定を作成する]** を選択します。新しいウィンドウが開きます。オプションを使用して、Amazon S3 バケットを作成し、新しい録画設定にアタッチします。
![\[[保存設定を作成する] ウィンドウを使用し、ステージの新規の保存設定を作成します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/Create_Storage_Configuration_IPR.png)
1. 次のフィールドに入力します。
1. 必要に応じて**保存設定名**を入力します。
1. [**バケット名**] を入力します。
1. **[保存設定を作成する]** を選択し、一意の ARN を持つ新規の保存設定リソースを作成します。通常、録画設定の作成は数秒ですが、最大で 20 秒かかることがあります。保存設定が作成されると、**[チャネルを作成する]** ウィンドウに戻ります。その**個々の参加者を記録する**エリアには、新規の**保存設定**および作成した S3 バケット (**ストレージ**) が表示されます。
![\[IVS コンソール を使用してステージを作成する: 新規の保存設定が作成されました。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_Storage_Configuration.png)
1. 必要に応じて、参加者レプリカの記録、個々の参加者による記録のマージ、サムネイル記録など、デフォルトでは無効になっているその他のオプションを有効にすることができます。
![\[IVS コンソールを使用してステージを作成する: サムネイル記録や IPR ステッチングなどの高度なオプションを有効にします。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_IPR_Stitching.png)
## IVS ステージを作成するための CLI 手順
AWS CLI をインストールするには、「[AWS CLI の最新バージョンをインストールまたは更新する](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。
個々の参加者による記録の有効の有無を問わず、ステージを作成するかどうかにより、CLI を使用して以下の 2 手順のいずれかに従ってリソースを作成および管理できるようになりました。
### 個々の参加者の記録なしでステージを作成する
ステージ API は ivs-realtime 名前空間の下にあります。例えば、ステージを作成するには以下のようにします。
```
aws ivs-realtime create-stage --name "test-stage"
```
レスポンスは次のとおりです。
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:376666121854:stage/VSWjvX5XOkU3",
"name": "test-stage"
}
}
```
### 個々の参加者の記録でステージを作成する
個々の参加者の記録を有効にしてステージを作成する方法
```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO
```
必要に応じて `thumbnailConfiguration` パラメータを渡してサムネイルの保存、記録モード、サムネイル間隔秒数を手動で設定します。
```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO,thumbnailConfiguration="{targetIntervalSeconds=10,storage=[SEQUENTIAL,LATEST],recordingMode=INTERVAL}"
```
必要に応じて `recordingReconnectWindowSeconds` パラメータを渡し、フラグメント化された個々の参加者の記録をマージできるようにします。
```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration "storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO,thumbnailConfiguration="{targetIntervalSeconds=10,storage=[SEQUENTIAL,LATEST],recordingMode=INTERVAL}",recordingReconnectWindowSeconds=60"
```
レスポンスは次のとおりです。
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/VSWjvX5XOkU3",
"autoParticipantRecordingConfiguration": {
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"mediaTypes": [
"AUDIO_VIDEO"
],
"recordingReconnectWindowSeconds": 60,
"recordParticipantReplicas": true,
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2",
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"storage": [
"SEQUENTIAL",
"LATEST"
],
"targetIntervalSeconds": 10
}
},
"endpoints": {
"events": "",
"rtmp": "",
"rtmps": "",
"whip": ""
},
"name": "test-stage-participant-recording"
}
}
```