View a markdown version of this page

문제 해결 - Amazon Kinesis Video Streams
이미지가 Amazon S3 버킷으로 전송되지 않음

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

문제 해결

이미지가 Amazon S3 버킷으로 전송되지 않음

이 문제를 해결하기 위해 주의해야 할 몇 가지 사항이 있습니다.

  1. 권한 누락

  2. 이미지 생성 구성이 잘못되었습니다.

  3. 태그가 조각에 추가되지 않았습니다.

권한 누락

고객 관리형 KMS 키를 사용하는 경우 PutMedia 호출을 수행하는 역할(업로더)에 적절한 암호화 및 복호화 권한이 있고 다음과 같이 Amazon S3 버킷에 액세스할 수 있는지 확인합니다.

  • kms:Encrypt

  • kms:GenerateDataKey

  • kms:Decrypt

  • s3:PutObject

자세한 내용은 서버 측 암호화를 시작하는 방법 단원을 참조하십시오.

대상 확인

AWS CLI 를 사용하여 스트림에 대한 DescribeImageGenerationConfiguration API를 호출합니다.

aws kinesisvideo describe-image-generation-configuration \
  --stream-name "demo-stream"

응답DestinationConfig에서를 검토하고 올바른지 확인합니다.

이미지 생성 태그가 조각에 추가되었는지 확인

  1. putKinesisVideoEventMetadata 호출이 성공했는지 확인합니다.

    putKinesisVideoEventMetadata 메서드는 성공 시 상태 코드 0을 반환합니다. 0에 대한 함수의 반환 값을 확인하는 것이 좋습니다. 0이 아닌 상태 코드가 반환되면 16진수로 변환하고 오류 코드 참조에서 자세한 내용을 확인합니다.

    오류 로그가 켜져 있는지 확인하고 애플리케이션에서 다른 오류가 있는지 로그를 검토합니다. 애플리케이션의 프레임 제출 호출 패턴을 검토하고 권장 구현인와 비교합니다조각에 이미지 생성 태그 추가.

  2. 로컬에서 생성된 MKV 파일 확인

    생산자 SDK 또는 샘플 애플리케이션이 태그를 올바르게 추가했는지 확인합니다.

    1. KVS_DEBUG_DUMP_DATA_FILE_DIR 환경 변수를 설정합니다. 이 값을 설정하면 생산자 SDK는 지정된 위치에 Kinesis Video Streams로 전송했을 미디어 파일을 씁니다.

      export KVS_DEBUG_DUMP_DATA_FILE_DIR=/path/to/output/directory
      참고

      경로가 없는 경우 SDK는 새 디렉터리를 생성하지 않습니다. 필요한 경우 폴더를 생성합니다.

    2. 애플리케이션을 다시 실행합니다. 지정된 출력 디렉터리에 .mkv 파일이 기록되는 것을 볼 수 있습니다.

    3. MKVToolNix 또는 기타 소프트웨어를 사용하여 태그가 있는지 콘텐츠를 확인합니다.

      1. MKVToolNix를 설치합니다. brew install mkvtoolnix

      2. 출력 디렉터리의 .mkv 파일 중 하나를 사용하여 MKVToolNix를 실행합니다.

        mkvinfo -v ./path/to/video/file

      3. MKVToolNix 출력을 검토합니다. KinesisVideoStream::PutFragmentMetadata 생산자 SDK 메서드가 올바르게 호출된 경우 다음 MKV 태그가 표시됩니다.

        |+ Tags
| + Tag
|  + Simple
|   + Name: AWS_KINESISVIDEO_IMAGE_GENERATION
        참고

        태그는 앞에 있는 클러스터에 속합니다.

    4. MKV 태그가 없는 경우 생산KinesisVideoStream::PutEventMetadata자 SDK 메서드가 STREAM_EVENT_TYPE_IMAGE_GENERATION 인수와 함께 호출되었고 성공(0) 코드를 반환했는지 확인합니다.