truloop Wiki

다크 모드

미디어 처리 파이프라인 ​

정보

미디어 처리 파이프라인은 업로드된 사진과 영상을 자동으로 최적화하여 빠르게 제공하는 백그라운드 시스템입니다. 사용자는 처리 완료를 기다릴 필요 없이 즉시 다른 활동을 계속할 수 있습니다.

기능 소개 ​

  • 업로드된 원본 미디어를 자동으로 최적화된 형식으로 변환합니다.
  • 이미지는 공개용 이미지와 썸네일 두 가지 버전으로 변환됩니다.
  • 동영상은 스트리밍에 최적화된 형식으로 변환되며, 별도로 썸네일 이미지도 생성됩니다.
  • 변환된 미디어는 CDN(CloudFront)을 통해 전 세계에 빠르게 배포됩니다.
  • 모든 처리는 백그라운드에서 자동으로 진행되며, 사용자 개입이 필요하지 않습니다.
  • HDR 영상(HDR10, HLG)의 색상 정보가 보존됩니다.

동작 규칙 ​

  1. 백그라운드 처리: 미디어 업로드가 완료되면 즉시 응답을 반환하고, 변환 작업은 백그라운드에서 자동으로 시작됩니다. 사용자는 처리 완료를 기다리지 않습니다.
  2. 이미지 변환: 원본 이미지는 두 가지 버전으로 변환됩니다. EXIF 회전 정보에 따라 올바른 방향으로 자동 보정됩니다.
    • 공개용 이미지: 최대 1440x3200 해상도의 WebP 형식 (품질 90)
    • 썸네일: 최대 500x500 해상도의 WebP 형식 (품질 75)
    • 원본이 최대 해상도보다 작은 경우 확대하지 않고 원본 크기를 유지합니다.
  3. 동영상 변환: 원본 동영상은 최대 1920x1080 해상도의 HEVC(H.265) MP4 형식으로 변환됩니다. 웹 재생에 최적화된 설정(fast start)이 적용됩니다.
  4. 동영상 썸네일: 동영상에서 첫 번째 프레임을 추출하여 최대 500x500 해상도의 WebP 썸네일을 자동 생성합니다. HDR 영상인 경우 SDR로 톤맵핑하여 미리보기 이미지가 정상적으로 표시됩니다.
  5. 동영상 스마트 처리: 원본 동영상이 이미 HEVC 코덱이고 해상도가 기준 이내인 경우, 전체 변환 대신 빠른 재포장(remux) 처리만 수행하여 화질 손실 없이 빠르게 처리됩니다.
  6. HDR 지원: HDR10 및 HLG 영상의 색상 메타데이터(color primaries, transfer, master display 등)가 변환 과정에서 보존됩니다.
  7. 동영상 병렬 처리: 동영상의 썸네일 생성과 최적화 변환은 병렬로 진행됩니다. 썸네일이 먼저 준비되면 다른 참여자가 미리보기를 즉시 볼 수 있고, 최적화된 영상은 변환 완료 후 제공됩니다.
  8. 원본 보존: 변환 후에도 원본 파일은 그대로 보존됩니다. 최적화된 버전은 별도로 생성됩니다.
  9. CDN 배포: 변환이 완료된 미디어는 CDN(CloudFront)을 통해 배포됩니다. 사용자는 지리적 위치에 관계없이 빠르게 미디어를 조회할 수 있습니다.
  10. 처리 실패 시 원본 제공: 변환 과정에서 오류가 발생하더라도 원본 파일은 이미 저장되어 있으므로, 사용자는 원본 미디어를 조회할 수 있습니다.
  11. 미디어 준비 대기: 미디어 업로드와 처리 완료 알림 사이에 타이밍 차이가 발생할 수 있습니다. 미디어가 아직 준비되지 않은 경우, 시스템은 최대 3회까지 자동으로 재시도합니다. 재시도 후에도 미디어를 찾을 수 없으면 실패로 처리됩니다.

사용자 흐름 ​

이미지 업로드 후 처리 ​

이미지 업로드 ​

사용자가 룹에 사진을 업로드합니다. 원본 파일이 저장되고 즉시 업로드 완료 응답을 받습니다.

백그라운드 변환 시작 ​

시스템이 원본 이미지를 감지하고, EXIF 회전 정보를 적용한 후 공개용 이미지(최대 1440x3200 WebP)와 썸네일(최대 500x500 WebP) 변환 작업을 병렬로 시작합니다.

변환 완료 및 CDN 배포 ​

변환이 완료되면 최적화된 이미지와 썸네일이 CDN에 배포됩니다.

최적화된 이미지 제공 ​

다른 참여자가 룹에서 미디어를 조회하면 CDN을 통해 최적화된 이미지를 빠르게 로딩합니다.

동영상 업로드 후 처리 ​

동영상 업로드 ​

사용자가 룹에 동영상을 업로드합니다. 원본 파일이 저장되고 즉시 업로드 완료 응답을 받습니다.

메타데이터 분석 ​

시스템이 동영상의 해상도, 길이, 코덱, HDR 여부, 촬영 정보 등을 분석합니다.

썸네일 생성과 최적화 변환 병렬 시작 ​

썸네일 추출(첫 프레임 WebP 변환)과 동영상 최적화 변환(HEVC MP4)이 동시에 진행됩니다.

썸네일 먼저 제공 ​

썸네일이 먼저 완료되면 CDN에 배포되어 다른 참여자가 미리보기를 볼 수 있습니다.

최적화된 동영상 제공 ​

동영상 변환이 완료되면 CDN에 배포되어 다른 참여자가 최적화된 동영상을 스트리밍할 수 있습니다.

관련 문서 ​

변경 이력 ​

날짜변경 내용
2026-03-16미디어 준비 대기 재시도 규칙 추가 (최대 3회)
2026-03-10코드 검증: 동영상 코덱을 H.264에서 HEVC(H.265)로 수정, 동영상 썸네일 생성 추가, 병렬 처리 구조 반영, HDR 지원 추가, 스마트 처리(remux) 설명 추가, 이미지 EXIF 회전 보정 추가
2026-03-09최초 작성