패키징 서비스 가이드

PallyCon 워터마크 패키징 서비스는 클라우드 SaaS 형태로 제공되는 워터마크 삽입 서비스입니다. CLI 임베더 또는 임베더 라이브러리를 이용한 별도의 서버를 구축할 필요 없이, 인코딩 결과물을 대상으로 PallyCon 클라우드 서비스를 이용하여 워터마크 삽입 및 패키징 작업을 수행할 수 있습니다.

sequenceDiagram participant A as 서비스 사이트 participant B as PallyCon 클라우드 A ->> B: 인코딩된 MP4 B -->> B: 워터마크 삽입 opt 멀티DRM 적용 B -->> B: 콘텐츠 암호화 end B ->> A: 패키징 결과물 Note right of B: DASH / HLS 콘텐츠
(각각 0, 1 두벌)

패키징 서비스는 PallyCon 콘솔 사이트의 웹 UI 또는 별도의 HTTP API를 통해 사용할 수 있습니다.

API를 통한 워터마크 패키징 연동에 대해서는 별도로 문의하시기 바랍니다.

웹 콘솔을 통한 패키징 가이드

PallyCon 콘솔 사이트에서 웹 UI를 이용해 워터마크 전처리 과정을 포함한 콘텐츠 패키징을 수행할 수 있습니다. 아래와 같은 과정을 통하여 원본 MP4 파일을 워터마크 적용된 0/1 두 벌의 DASH 또는 HLS 콘텐츠로 패키징합니다.

AWS 리전 및 S3 스토리지 설정

워터마크 패키징 서비스를 이용하기 위해서는 우선 해당 서비스를 수행할 AWS 리전을 선택해야 합니다.

콘솔 사이트에 로그인 후 사이트 설정 > 연동 설정 화면으로 이동해 포렌식 워터마킹 설정 항목의 패키징 서비스 리전에서 사용할 리전을 설정합니다.

region-setting

패키징 서비스 리전 목록에는 현재 시점에 패키징 작업에 필요한 인스턴스 타입이 지원되는 리전만 표시됩니다. 목록에 표시되지 않은 리전의 스토리지는 패키징 작업에 사용할 수 없습니다.

다음으로 원본 콘텐츠와 패키징 결과물이 저장될 AWS S3 스토리지 정보를 설정합니다.

화면 좌측의 포렌식 워터마킹 메뉴에서 패키징 서비스 > 스토리지 설정 화면으로 이동해 등록 버튼을 클릭합니다.

storage-setting

스토리지 등록 화면의 각 항목들을 아래와 같이 입력합니다.

storage-reg

  • 타입: 등록할 스토리지의 타입을 선택합니다. 현재는 S3만 지원합니다.
  • 스토리지 명: 해당 스토리지를 구별할 수 있는 임의의 이름을 입력합니다. (특수 문자 사용 불가, 50바이트 이하)
  • 버킷 명: 해당 S3 내부의 버킷 중에서 패키징 작업의 입력 또는 출력 용도로 사용할 버킷의 이름을 입력합니다.
  • Access Key: S3 접근을 위해 필요한 Access Key의 ID 값을 입력합니다.
  • Secret Key: 해당 Access Key의 Secret Access Key 값을 입력합니다.
  • 설명: 등록할 스토리지에 대한 자세한 설명을 입력합니다. (선택 사항)

용도에 따라 여러 개의 스토리지를 등록할 수 있으며, 패키징 작업을 위해서는 최소 두 개(입력용, 출력용) 이상의 스토리지가 등록되어야 합니다.

패키징 작업 등록

스토리지 등록이 완료되면 작업 등록을 위해 패키징 작업 화면으로 이동합니다. 화면 우측의 등록 버튼을 눌러 신규 작업을 등록합니다.

packaging-job

패키징 작업 등록 전에 패키징할 원본 비디오 파일(mp4)을 입력용 버킷에 업로드해야 합니다.

패키징 작업 등록 화면의 각 항목들을 아래와 같이 입력합니다.

job-reg

  • Job 명: 해당 작업을 구분할 임의의 이름을 입력합니다. (특수 문자 사용 불가, 최대 50바이트)
  • 콘텐츠 ID: 패키징할 콘텐츠의 고유 ID(Content ID)를 입력합니다. (특수 문자 사용 불가, 최대 200바이트)
  • 입력 스토리지: 이전 단계에서 등록한 입력용 스토리지를 목록에서 선택합니다.
  • 입력 콘텐츠 경로: 입력용 스토리지 내 원본 영상 파일(mp4)의 경로를 버킷명을 제외하고 입력합니다. (예: source/test1.mp4)
  • 출력 스토리지: 이전 단계에서 등록한 출력용 스토리지를 목록에서 선택합니다.
  • 출력 콘텐츠 경로: 출력용 버킷에 생성될 결과물의 경로를 입력합니다.
  • 보안 설정: 워터마킹과 DRM을 동시 적용해 패키징하는 경우, DRM 옵션을 클릭해 선택합니다.
  • 스트리밍 포맷: 패키징될 스트리밍 포맷을 선택합니다.
  • 자막 파일 경로: 자막을 포함하여 패키징하는 경우, 각 언어 별로 자막 파일을 원본 영상과 동일한 입력 스토리지에 업로드한 후 해당 경로를 입력합니다.

각 항목을 입력하고 등록 버튼을 누르면 해당 콘텐츠에 대한 패키징 작업이 등록됩니다. 대기 중 또는 진행 중인 패키징 작업의 목록은 해당 화면에서 확인할 수 있습니다.

동일 영상에 대해서 각 해상도 별로 여러 입력 파일을 등록하면 어댑티브 스트리밍(Adaptive bitrate, ABR) 콘텐츠로 패키징할 수 있습니다.

패키징 이력 확인

패키징이 성공적으로 완료되면, 작업 등록 시 설정한 출력 스토리지의 콘텐츠 경로에 DASH/HLS 포맷으로 패키징된 0/1 버전 워터마킹 콘텐츠가 생성됩니다.

완료된 패키징 작업의 이력은 아래와 같이 패키징 완료 이력 화면에서 조회할 수 있습니다.

job-history

패키징 완료된 DASH/HLS 콘텐츠는 실시간 조합을 위해 워터마크 믹서 모듈이 지원하는 CDN과 연결되어야 합니다. 해당 연동 처리에 대한 상세 내용은 워터마크 믹서 가이드를 참고하시기 바랍니다.