FFMpegCore는 .NET 환경에서 FFmpeg 및 FFprobe를 손쉽게 연동할 수 있도록 설계된 래퍼(Wrapper) 라이브러리입니다. 이 가이드에서는 해당 라이브러리의 내부 구조와 실제 프로젝트에 통합하여 사용하는 방법을 살펴봅니다.

1. 소스 코드 및 디렉터리 구조 분석

저장소를 클론하면 다음과 같은 주요 디렉터리와 파일을 확인할 수 있습니다. 버전 업데이트에 따라 세부 사항이 변경될 수 있으나, 기본적인 아키텍처는 다음과 같이 구성됩니다.

• src: 라이브러리의 핵심 소스 코드가 위치합니다.
  • FFMpegCore: 실제 기능이 구현된 메인 네임스페이스입니다.
    • MediaInfo.cs: 미디어 파일의 메타데이터 및 속성을 추출하는 로직을 담당합니다.
    • FFMpegArguments.cs: FFmpeg CLI 명령어를 생성하기 위한 플루언트(Fluent) 인터페이스를 제공합니다.
    • FFMpegCoreException.cs: 미디어 처리 중 발생하는 오류를 핸들링하기 위한 커스텀 예외 클래스입니다.
• tests: 라이브러리의 안정성을 검증하기 위한 단위 테스트 프로젝트가 포함되어 있습니다.
• bin 및 obj: 빌드 프로세스 중에 자동 생성되는 컴파일 결과물 디렉터리입니다.

2. 라이브러리 초기화 및 실행 방식

FFMpegCore는 독립적으로 실행되는 애플리케이션이 아닌 클래스 라이브러리이므로, 특정 '진입점(Entry Point)'이나 메인 실행 파일을 가지고 있지 않습니다. 대신, 호스트 애플리케이션 내에서 인스턴스를 생성하고 메서드를 호출하는 방식으로 동작합니다.

다음은 입력된 비디오 파일을 H.265(HEVC) 코덱으로 인코딩하고, 오디오는 AAC로 변환하며 해상도를 1080p로 업스케일링하는 플루언트 API 사용 예시입니다.

using FFMpegCore;
using FFMpegCore.Enums;

// 입력 및 출력 경로 정의
string sourceFilePath = "source_video.mov";
string targetFilePath = "processed_video.mp4";

// FFmpeg 인자 빌드 및 작업 실행
await FFMpegArguments
    .FromFileInput(sourceFilePath)
    .OutputToFile(targetFilePath, overwrite: true, options => options
        .WithVideoCodec(VideoCodec.LibX265)
        .WithConstantRateFactor(23)
        .WithAudioCodec(AudioCodec.Aac)
        .WithAudioBitrate(192)
        .WithCustomArgument("-movflags +faststart")
        .Scale(1920, 1080))
    .ProcessAsynchronously();

위 코드에서 볼 수 있듯이, 메서드 체이닝을 통해 복잡한 CLI 파라미터를 직관적인 C# 코드로 변환하여 비동기 방식으로 미디어 처리 작업을 수행할 수 있습니다.

3. 실행 파일 경로 구성

이 라이브러리는 기본적으로 시스템의 환경 변수(PATH)에 등록된 FFmpeg 및 FFprobe 실행 파일을 탐색합니다. 하지만 배포 환경이나 컨테이너 내부에서 실행 파일이 특정 디렉터리에 위치해 있는 경우, 전역 설정을 통해 바이너리 경로를 명시적으로 지정해야 합니다.

애플리케이션 시작 시점에서 다음과 같이 경로를 설정할 수 있습니다.

using FFMpegCore;

// 사용자 정의 바이너리 경로 지정
string customBinaryPath = @"/opt/custom/ffmpeg/bin";
GlobalFFOptions.Configure(options => options.BinaryFolder = customBinaryPath);

이러한 전역 구성을 적용하면, 라이브러리가 미디어 작업을 수행할 때 지정된 폴더에서 실행 파일을 올바르게 찾아 사용할 수 있습니다.