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

자동 실시간 이미지 생성

Amazon Kinesis Video Streams는 이미지를 트랜스코딩하고 전송하는 기능을 제공합니다. Kinesis Video Streams는 비디오 데이터에서 이미지를 실시간으로 자동으로 추출하고 지정된 Amazon S3 버킷에 이미지를 전송합니다. 실시간 자동 이미지 추출을 구현하려면 다음 단계를 수행해야 합니다.

다음 절차에서는 이러한 각 단계를 완료하는 지침을 제공합니다.

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

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

Kinesis Video Streams는 이미지 생성 태그가 있는 조각에 대해서만 이미지를 생성하고 전송합니다. Amazon S3 이미지 생성 태그와 함께 제공되는 추가 조각 메타데이터는 Amazon S3 메타데이터로 저장됩니다.

다음은 mkvinfo 유틸리티를 사용하는 조각 메타데이터 태그 구조의 예입니다. 이미지 생성 태그는 키가 AWS_KINESISVIDEO_IMAGE_GENERATION 이고 값이 없는 MKV 단순 태그입니다. 자세한 내용은 Matroska 설명서의 비디오 태그 예제를 참조하세요.

|+ Tags
| + Tag
|  // MANDATORY: Predefined MKV tag to trigger image generation for the fragment
|  + Simple
|   + Name: AWS_KINESISVIDEO_IMAGE_GENERATION

|  // OPTIONAL: S3 prefix which will be set as prefix for generated image.
|  + Simple
|   + Name: AWS_KINESISVIDEO_IMAGE_PREFIX 
|   + String: image_prefix_in_s3 // 256 bytes max

| // OPTIONAL: Key value pairs that will be persisted as S3 Image object metadata.
|  + Simple
|   + Name: CUSTOM_KEY_1 // Max 128 bytes
|   + String: CUSTOM_VALUE_1 // Max 256 bytes
|  + Simple
|   + Name: CUSTOM_KEY_2 // Max 128 bytes
|   + String: CUSTOM_VALUE_2 // Max 256 bytes

조각에 이미지 생성 태그 추가

Kinesis Video Streams는 이미지 생성 태그가 있는 조각에 대해서만 이미지를 생성하고 전송합니다. Kinesis Video Streams는 이러한 특수 MKV 태그를 인식하고 스트림의 이미지 처리 구성을 기반으로 이미지 생성 워크플로를 시작합니다.

Kinesis Video Streams 생산자 SDK를 사용하여 미디어를 업로드하는 경우 putKinesisVideoEventMetadata 메서드를 사용하여 태그를 지정할 각 조각에 이미지 생성 태그를 추가합니다. keyframe 플래그가 포함된 프레임으로 putFrame를 호출하면 새 조각이 시작됩니다.

사전 레코딩된 비디오를 업로드하는 경우 네트워크 속도에 따라 레코딩된 속도와 다른 속도로 업로드될 수 있습니다. 비디오의 원래 타임스탬프를 기반으로 이미지를 정기적으로 생성하고 Amazon Kinesis Video Streams가 비디오를 수신한 속도를 기반으로 생성된 서버 타임스탬프를 사용하지 않으려면 생산자 타임스탬프를 사용하여 이미지 생성을 구성하는 것이 좋습니다.

이 코드의 전체 예를 보려면 GitHub의 VideoOnlyRealtimeStreamingSample 코드 샘플을 참조하세요.

// Setup sample frame
MEMSET(frameBuffer, 0x00, frameSize);
frame.frameData = frameBuffer;
frame.version = FRAME_CURRENT_VERSION;
frame.trackId = DEFAULT_VIDEO_TRACK_ID;
frame.duration = HUNDREDS_OF_NANOS_IN_A_SECOND / DEFAULT_FPS_VALUE;
frame.decodingTs = defaultGetTime(); // current time
frame.presentationTs = frame.decodingTs;

Frame eofr = EOFR_FRAME_INITIALIZER;

while(defaultGetTime() > streamStopTime) {
    frame.index = frameIndex;
    frame.flags = fileIndex % DEFAULT_KEY_FRAME_INTERVAL == 0 ? FRAME_FLAG_KEY_FRAME : FRAME_FLAG_NONE;
    frame.size = SIZEOF(frameBuffer);

    CHK_STATUS(readFrameData(&frame, frameFilePath));

    // 1. End the previous fragment
    if (frame.flags == FRAME_FLAG_KEY_FRAME && !firstFrame) {
        putKinesisVideoFrame(streamHandle, &eofr);
    }

    // 2. putFrame call
    CHK_STATUS(putKinesisVideoFrame(streamHandle, &frame));

    if (frame.flags == FRAME_FLAG_KEY_FRAME) {
        // 3. Adding the image generation tag
        CHK_STATUS(putKinesisVideoEventMetadata(streamHandle, STREAM_EVENT_TYPE_IMAGE_GENERATION, NULL);)

        // 4. Adding fragment metadata
        for (n = 1; n <= 5; n++) {
            SNPRINTF(metadataKey, METADATA_MAX_KEY_LENGTH, "SAMPLE_KEY_%d", n);
            SNPRINTF(metadataValue, METADATA_MAX_VALUE_LENGTH, "SAMPLE_VALUE_%d", frame.index + n);
            CHK_STATUS(putKinesisVideoFragmentMetadata(streamHandle, metadataKey, metadataValue, FALSE));
        }
    }
    defaultThreadSleep(frame.duration);

    frame.decodingTs += frame.duration;
    frame.presentationTs = frame.decodingTs;
    frameIndex++;
    fileIndex++;
    fileIndex = fileIndex % NUMBER_OF_FRAME_FILES;
    firstFrame = TRUE;
}

// 5. End the final fragment
putKinesisVideoFrame(streamHandle, &eofr);

샘플 프레임을 설정하기 위한 예제 코드의 요소는 다음과 같습니다.

샘플을 사용하여 이미지 생성 태그 추가

명령줄 옵션을 사용하여 이미지 생성 태그를 추가하려면 C++ 생산자 SDKkvs_gstreamer_audio_video_sample에서를 사용할 수 있습니다. 다음 예제와 같이 -e image 또는 -e both 인수를 추가하여이 기능을 활성화합니다.

./kvs_gstreamer_audio_video_sample stream-name \
  -f video-to-upload.mp4 \
  -e both

이 샘플 애플리케이션에 대한 자세한 내용은 GitHub의 Amazon Kinesis Video Streams CPP Producer, GStreamer Plugin 및 JNI README를 참조하세요.

Amazon S3 객체 경로(이미지)

S3 객체 경로는 생성된 이미지가 전달될 구성된 S3 버킷의 위치를 설명합니다. 다음 형식을 사용합니다.

ImagePrefix_AccountID_StreamName_ImageTimecode_RandomID.file-extension

객체 경로 요소는 다음과 같이 정의됩니다.

이 예제에서 생성된 이미지의 객체 경로는 다음과 같습니다.

111122223333_demo-stream_16907729324_f20f9add-75e7-4399-a30f-fc7aefb1bab7.jpg

이미지 메타데이터 검색

S3 콘솔 또는 CLI를 사용하여 생성된 이미지의 메타데이터를 검색할 수 있습니다.

Kinesis Video Streams는 조각 번호, 생산자 및 서버 타임스탬프, 생성된 이미지의 콘텐츠 유형 메타데이터를 모두 Amazon S3 객체 메타데이터로 설정합니다. 추가 MKV 태그가 있는 경우 해당 태그도 Amazon S3 객체 메타데이터로 추가됩니다. 다음 예제에서는 Amazon S3 헤드 객체 API 명령을 사용하여 객체 메타데이터를 검색하는 방법을 보여줍니다. 응답에는 Kinesis Video Streams에서 생성한 메타데이터가 포함됩니다.

aws s3api head-object --bucket my-bucket-name --key 111122223333_demo-stream_1690707290324_f20f9add-7e57-4399-a30f-fc7aefb1bab7.jpg
{
    "AcceptRanges": "bytes",
    "LastModified": "2023-07-30T08:54:51+00:00",
    "ContentLength": 22693,
    "ETag": "\"63e03cb6d57f77e2db984c1d344b1083\"",
    "ContentType": "image/jpeg",
    "ServerSideEncryption": "AES256",
    "Metadata": {
        "aws_kinesisvideo_producer_timestamp": "1690707290324",
        "aws_kinesisvideo_server_timestamp": "1690707289209",
        "aws_kinesisvideo_fragment_number": "91343852333182036507421233921329142742245756394"
    }
}

S3 객체 메타데이터에 대한 자세한 내용은 섹션을 참조하세요https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html.

제한을 방지하기 위한 Amazon S3 URI 권장 사항

Amazon S3에 수천 개의 이미지를 쓰면 제한이 발생할 위험이 있습니다. 자세한 내용은 S3 접두사 Put 요청 제한을 참조하세요.

Amazon S3 접두사는 초당 3,500개의 PUT 요청이라는 PUT 제한으로 시작되며 고유한 접두사에 대해 시간이 지남에 따라 점진적으로 증가합니다. 날짜와 시간을 Amazon S3 접두사로 사용하지 마세요. 시간 코딩 데이터는 한 번에 하나의 접두사에 영향을 미치며, 정기적으로 변경되어 이전 접두사 스케일 업을 무효화합니다.

더 빠르고 일관된 Amazon S3 조정을 활성화하려면 Amazon S3 대상 URI에 16진수 코드 또는 UUID와 같은 임의의 접두사를 추가하는 것이 좋습니다. 예를 들어, 16진수 코드 접두사는 16개의 서로 다른 접두사(각 고유한 16진수 문자에 대한 접두사)로 요청을 무작위로 분할하므로 Amazon S3가 자동 조정된 후 초당 56,000개의 PUT 요청을 허용합니다.