[ios] VideoToolbox 인코딩 프레임워크의 적용

22 Dec 2023

소개

VideoToolbox는 iOS 및 macOS의 멀티미디어 처리를 위한 프레임워크입니다. 이 프레임워크를 사용하여 비디오 인코딩을 수행할 수 있습니다. 이번 포스트에서는 VideoToolbox를 사용하여 iOS 애플리케이션에서 비디오 인코딩을 수행하는 방법에 대해 알아보겠습니다.

비디오 인코딩 준비

비디오 인코딩을 수행하기 전에 VideoToolbox 프레임워크를 프로젝트에 추가해야 합니다. Xcode에서 프로젝트를 열고, Build Phases 섹션의 Link Binary With Libraries에서 VideoToolbox.framework를 추가합니다.

비디오 인코딩 수행

비디오 인코딩을 수행하기 위해 아래의 단계를 따릅니다.

비디오 소스를 가져옵니다.
VTCompressionSessionCreate를 사용하여 압축 세션을 생성합니다.
코덱 설정 및 비디오 매개변수를 설정합니다.
VTCompressionSessionEncodeFrame을 사용하여 프레임을 인코딩합니다.
인코딩이 완료되면 압축된 비디오를 처리합니다.

다음은 VideoToolbox를 사용하여 H.264 코덱으로 비디오 인코딩을 수행하는 간단한 예제 코드입니다.

#include <VideoToolbox/VideoToolbox.h>

VTCompressionSessionRef compressionSession;
OSStatus status = VTCompressionSessionCreate(NULL, width, height, kCMVideoCodecType_H264, NULL, NULL, NULL, compressionOutputCallback, (__bridge void * _Nullable)(self), &compressionSession);
if (status != noErr) {
    // 압축 세션 생성 중에 오류 발생
}

VTSessionSetProperty(compressionSession, kVTCompressionPropertyKey_RealTime, kCFBooleanTrue);
VTSessionSetProperty(compressionSession, kVTCompressionPropertyKey_ProfileLevel, kVTProfileLevel_H264_Baseline_AutoLevel);
VTSessionSetProperty(compressionSession, kVTCompressionPropertyKey_AverageBitRate, (__bridge CFTypeRef)@(bitRate));
VTSessionSetProperty(compressionSession, kVTCompressionPropertyKey_ExpectedFrameRate, (__bridge CFTypeRef)@(frameRate));

// 프레임을 가져와 인코딩 수행
CVImageBufferRef imageBuffer; // 비디오 프레임
CMTime presentationTimeStamp; // 프레임 타임스탬프
VTCompressionSessionEncodeFrame(compressionSession, imageBuffer, presentationTimeStamp, kCMTimeInvalid, NULL, NULL, NULL);

// 압축된 비디오 처리

결론

이제 iOS 애플리케이션에서 VideoToolbox를 사용하여 비디오를 인코딩하는 방법에 대해 알아보았습니다. VideoToolbox를 이용하면 손쉽게 비디오 인코딩을 수행할 수 있으며, 세세한 설정을 통해 다양한 비디오 인코딩 요구사항에 대응할 수 있습니다.

참고 문헌

Apple Developer Documentation, VideoToolbox Framework