IVS チャネルを作成するための CLI の手順

AWS CLI を使用してチャネルを作成することは詳細オプションであり、最初に CLI をダウンロードしてマシンに設定する必要があります。詳細については、AWS コマンドラインインターフェイスのユーザーガイドを参照してください。

チャネル作成時に録画を有効／無効にするかどうかに応じて、次の 2 つの手順のいずれかに従います。

録画せずにチャネルを作成する

create-channelコマンドを実行し、オプション名を渡します:
```
aws ivs create-channel --name test-channel
```

これにより、新しいチャネルが返されます。


{
   "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"
   }
}

重要: ingestEndpoint、streamKey value、および playbackUrl の点に注意してください。これらを使用して、ストリーミングと再生を設定します。

録画付きチャネルの作成

前提条件 この手順を開始する前に Amazon S3 バケットを作成し、その ARN を書き留めます。Amazon S3 の開始方法を参照してください。S3 バケットは、録画設定を作成する同じリージョンに作成する必要があります。以下のステップ 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は、(ACTIVEの代わりに) CREATE_FAILEDとなります。(他のリージョンでは、バケットが別のリージョンにある場合、CLI は正しく失敗を返します)。

回避方法: S3 バケットが録画設定と同じリージョンにあることを確認してください。S3 バケットとして別のリージョンに録画設定を作成する場合は、その録画設定を削除し、正しいリージョンから S3 バケットで新しい録画設定を作成します。

これにより、一意の 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
      }
   }
}

通常、録画設定の作成は数秒ですが、最大で 20 秒かかることがあります。録画設定が作成されたことを確認するには、get-recording-configurationコマンドを実行します。
```
aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```

これにより、録画設定が作成されたことを示すレスポンスが返されます (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
      }
   }
}

チャネルを作成し、そのチャネルでの録画を有効にするには、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"

これにより、録画が有効であることを示す、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"
   }
}

重要: ingestEndpoint、streamKey value、および playbackUrl の点に注意してください。これらを使用して、ストリーミングと再生を設定します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

コンソールでの手順

ステップ 5: ストリーミングソフトウェアの設定