투케이2K

68. (Aws/Amazon) [Aws Kinesis Video Streams] Aws KVS HLS MKV 파일 설명 - PutMedia API 스트리밍 업로드 시 전송 파일 본문

Aws (Amazon)

68. (Aws/Amazon) [Aws Kinesis Video Streams] Aws KVS HLS MKV 파일 설명 - PutMedia API 스트리밍 업로드 시 전송 파일

투케이2K 2025. 5. 22. 19:17
728x90
반응형

[개발 환경 설정]

개발 환경 : Aws / Amazon Web Services

 

[설명 정리]

// --------------------------------------------------------------------------------------
[개발 및 환경]
// --------------------------------------------------------------------------------------

- 인프라 : Aws / Amazon Web Services

- 기술 구분 : Aws / Aws Kinesis Video Streams / HLS / MKV / PutMedia API

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설 명]
// --------------------------------------------------------------------------------------

1. AWS PutMedia API 간략 설명 : 

  >> Aws PutMedia API 는 미디어 데이터를 Kinesis 비디오 스트림에 업로드 할 수 있는 HTTP API 입니다

  >> PutMedia API 사용 전 GetDataEndpointAPI 를 호출하여 엔드포인트를 가져와야 합니다 (Credential EndPoint)

    - 가져온 엔드포인트 정보를 사용해 PutMedia API 호출 시 사용합니다

  >> GetDataEndpointAPI 를 호출하여 엔드포인트 정보를 가져오기 위해서는 IAM 계정에 할당 된 AccessKey , SecretKey 정보가 필요합니다

  >> PutMedia API 를 통해 비디오 스트림을 업로드 하기 위해서는 MKV 파일을 Stream 스트림으로 읽어 전송해야합니다

  >> 자바 소스 코드 PutMediaClient 객체 생성 예시 : 

    final PutMediaClient client = PutMediaClient.builder()
          .putMediaDestinationUri(uri)
          .mkvStream(inputStream)  -------------------> mkv 파일 읽은 스트림 데이터
          .streamName(STREAM_NAME) -------------------> 비디오 업로드를 수행 할 스트림 명칭
          .timestamp(System.currentTimeMillis())
          .fragmentTimeCodeType("RELATIVE")
          .signWith(getKinesisVideoSigner(configuration))
          .upstreamKbps(MAX_BANDWIDTH_KBPS)
          .receiveAcks(ackConsumer)
          .build();


2. MKV 파일 설명 : 

  >> MKV 파일은 다른 일반적인 파일 형식과 달리 비디오 압축 형식이 아니며, 비디오, 오디오, 텍스트를 단일 파일에 통합할 수 있는 멀티미디어 컨테이너 포맷입니다

  >> MKV 파일은 산업 표준이 아니기 때문에 모든 미디어 플레이에서 열 수 있는 것은 아니며, 파일을 열고 재생하기에 약간의 제약이 있습니다

    - MKV 파일을 열고 재생할 수 있는 앱 : MPC-HC , MPV , DivX Player , MKV File Player , KMPlayer , The Core Media Player 

  >> MKV 파일 주요 기능 : 

    - 메뉴, 챕터 및 메타 데이터 지원

    - 온라인 스트리밍 호환성 

    - 손상된 파일의 재생을 허용하는 오류 복구 기능

    - 선택 가능한 다양한 비디오 및 오디오 스트림

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

[Aws 사이트 : PutMedia API를 사용하여 Kinesis Video Streams로 데이터 전송]

https://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/examples-putmedia.html


[Aws 사이트 : API 요청용 AWS Signature Version 4]

https://docs.aws.amazon.com/ko_kr/IAM/latest/UserGuide/reference_sigv.html


[Aws KVS PutMedia 비디오 스트림 전송 API 설명 정리]

https://blog.naver.com/kkh0977/223856688678


[Aws KVS 비디오 스트림 , 신호 전송 채널 차이점 설명 정리]

https://blog.naver.com/kkh0977/223854439046


[Aws Kvs WebRTC 실시간 영상 재생 관련 학습 정리]

https://blog.naver.com/kkh0977/223855985471


[Aws Kvs HSL 비디오 스트림 녹화 영상 관련 학습 정리]

https://blog.naver.com/kkh0977/223855980812

// --------------------------------------------------------------------------------------
 
728x90
반응형
Comments