CLI 지침

AWS CLI를 사용하여 채널을 생성하는 방법은 고급 옵션이며, 먼저 시스템에 CLI를 다운로드하고 구성해야 합니다. 자세한 내용은 AWS 명령줄 인터페이스 사용 설명서를 참조하세요.

레코딩을 활성화하거나 활성화하지 않고 채널을 생성하는지 여부에 따라 아래 두 절차 중 하나를 수행합니다.

레코딩 없이 채널 생성

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",
      "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에 대해 ‘없음’ 이외 값의 채널 오브젝트를 반환하고 레코딩이 활성화되었음을 나타냅니다. (아래 응답은 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",
      "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단계: 스트리밍 소프트웨어 설정