프로필 유형

프로필은 구성 세부정보를 저장하는 데 사용되는 "템플릿"입니다. 아래에서는 Ooyala Flex에서 사용 가능한 두 가지 프로필 유형에 대해 설명합니다.

유효성 검사 프로필

적절한 구조적 메타데이터 값을 기준으로 자산 유효성을 검사하는 데 사용됩니다. 유효성 검사 프로필은 일부 유효성 검사 동작 내에서도 참조하고, 들어오는 미디어 파일 유효성 검사를 위해 받은 편지함에서도 참조합니다. 유효성 검사 작업 중에 Ooyala Flex는 유효성 검사 프로필을 자산에서 추출된 비트 전송률, 프레임 속도, 코덱 등의 기술 메타데이터 값과 비교하여 유효성 검사 프로필 규칙이 충족되는지 여부를 확인합니다.

유효성 검사 프로필에는 두 가지 유형이 있습니다.

  • 미디어 유효성 검사: 미디어 자산 유형의 유효성을 검사하는 데 사용됩니다.
  • 이미지 유효성 검사: 이미지 자산 유형의 유효성을 검사하는 데 사용됩니다.

복합 유형 및 패턴 일치

Ooyala Flex의 유효성 검사 프로필은 스크립팅뿐 아니라 복합 유형도 지원합니다. 따라서 숫자 필드에 값을 입력하는 대신 연산자를 입력하여 일치 정확도를 높일 수 있습니다. 문자열 및 텍스트 필드에서도 스크립팅을 사용할 수 있습니다.

사용 가능한 연산자는 다음과 같습니다.

패턴 설명 예

.. 작은 값에서 큰 값까지의 범위 20..30

> 지정된 값보다 크면 일치함 >35.0

< 지정된 값보다 작으면 일치함 65.3<

| "또는" 연산자. 두 값 중 하나가 일치해야 함 65 | 64

! "!" 연산자. 표시된 값이 아니어야 일치함 !65

* 모든 항목이 일치함을 나타내는 와일드카드

29834

코드 변환 프로필

자산을 파일 형식 간에 코드 변환할 때 사용할 코드 변환 프로필을 정의하는 데 사용됩니다. 코드 변환 작업을 코드 변환 리소스에 위임할 때 수행되어야 하는 코드 변환 프로세스 유형을 지정하기 위해 일부 코드 변환 동작 내에서 코드 변환 프로필을 참조합니다.

참고:

프로필은 실제로는 구성 템플릿 저장용으로 사용되는 시스템 생성 메타데이터 스키마입니다.

미디어 코드 변환 프로필

참고: 이 템플릿은 문자열 및 텍스트 필드의 스크립팅 값만 지원합니다!

속성:

Table 1.
필드 설명
아이콘 플러그인 아이콘
스크립팅 지원 구성이 스크립팅을 지원하는지 여부
스크립팅 컨텍스트 자산, 작업

스크립팅 컨텍스트 내에서 참조할 수 있는 Ooyala Flex 개체

구성:

Table 2.
필드 필드 유형 필수 다중성 설명
코드 변환 엔진 transcode-engine 0.1 이 프로필에 필요한 특정 코드 변환 엔진
코드 변환기 이름 string 0..1 코드 변환기 관련 사전 설정/프로필 이름
코드 변환 프로필 템플릿 file 0..1 코드 변환 프로필이 업로드한 템플릿을 기준으로 함
구성된 프로필 complex 0..1 코드 변환 프로필이 구성을 기준으로 함
소스 complex 1..* 소스 자산에 대한 정보
소스 자산 컨텍스트 string   소스 자산에 대한 자산 콘텐츠 계층 참조
내부 string    
외부 string    
소스 변환 complex    
디인터레이스 complex 0..1 인터레이스된 소스 디인터페이스
디인터레이스 방법 transcode-deinterlace-method    
임계값 string    
자르기 complex 0..1 소스 비디오 자르기
위쪽(px) integer    
아래쪽(px) integer    
왼쪽(px) integer    
오른쪽(px) integer    
프레임 속도 변환 complex 0..1 가변 프레임 속도에서 고정 프레임 속도로 변환
변환 프레임 속도(fps) transcode-frame-rate    
픽셀 가로세로비 변환 complex 0..1 비디오의 보고된 가로세로비 수정
픽셀 가로세로비 변환(예: 4:3) string    
제품 complex   제품 관련 정보
형식 transcode-format    
형식 변형 transcode-format-variant    
출력 complex   출력 관련 정보
파일 옵션 complex 0..1 파일 출력 옵션
파일 옵션 complex 0..* 파일 출력 옵션
파일 옵션 이름 string    
파일 옵션값 string    
비디오 스트림 complex 0..1 비디오 관련 정보
비디오 스트림 complex 0..1 스트림 관련 일반 정보
비디오 코덱 transcode-video-codec    
비디오 비트 전송률 string    
비디오 프레임 속도(fps) double    
비디오 너비(px) integer    
비디오 너비(px) integer    
픽셀 가로세로비(예: 4:3) string    
인터레이스 형식 transcode-interlace-format    
비디오 옵션 complex 0..1 비디오 코덱 옵션
비디오 옵션 complex 0..* 비디오 코덱 옵션
비디오 옵션 이름 string    
비디오 옵션값 string    
비디오 변환 complex    
비디오 페이드 complex 0..1  
비디오 페이드 인(초) string    
비디오 페이드 아웃(초) string    
오버레이 complex    
그래픽 오버레이 complex 0..*  
이미지 image   코드 변환용 오버레이 이미지
시작 시간 코드 string    
종료 시간 코드 string    
페이드 인 시간(초) integer    
페이드 아웃 시간(초) integer    
X 위치(픽셀) integer   가로 오프셋(픽셀). "0"은 맨 왼쪽을 나타내며 값을 높이면 이미지가 오른쪽으로 오프셋 됩니다.
Y 위치(픽셀) integer   세로 오프셋(픽셀). "0"은 이미지 맨 위를 나타내며 값을 높이면 이미지가 아래쪽으로 오프셋 됩니다.
X 배율 double   가로 배율. 예를 들어 1.0은 실제 크기이고 0.5는 절반 크기이며 2.0은 원래 크기의 2배입니다.
Y 배율 double   세로 배율. 예를 들어 1.0은 실제 크기이고 0.5는 절반 크기이며 2.0은 원래 크기의 2배입니다.
투명도(0.0~1.0) double   0.0(완전 불투명) 및 1.0(완전 투명)
텍스트 오버레이 complex   0..*
텍스트 string    
시작 시간 코드 string    
종료 시간 코드 string    
페이드 인 시간(초) integer    
페이드 아웃 시간(초) integer    
X 위치(0.0~1.0) double   0.0(화면 왼쪽) 및 1.0(화면 오른쪽)
Y 위치(0.0~1.0) double   0.0(화면 맨 위) 및 1.0(화면 맨 아래)
가로 맞춤 complex 1  
가로 맞춤 single-option   가로 맞춤
세로 맞춤 complex 1  
세로 맞춤 single-option   세로 맞춤
투명도(0.0~1.0) double   0.0(완전 불투명) 및 1.0(완전 투명)
글꼴 string    
크기(0.0~1.0) double    
빨간색 구성 요소(0~255) integer    
파란색 구성 요소(0~255) integer    
녹색 구성 요소(0~255) integer    
그림자(0.0~1.0) double   0.0(후광 없음) 및 1.0(가장 강한 후광)
진한 그림자 부울    
배경 활성화됨 부울    
미디어 확장 complex 0..1  
미리 받기 프레임 추가 integer    
나중에 받기 프레임 추가 integer    
필드 순서 이동 complex 0..1  
필드 순서 이동 single-option   필드 순서 이동
오디오 스트림 complex 0..1 오디오 관련 정보
오디오 스트림 complex 0..1 스트림 관련 일반 정보
오디오 코덱 transcode-audio-codec    
샘플 속도(kHz) double    
오디오 비트 전송률 string    
샘플당 비트 수 integer    
채널 integer    
오디오 옵션 complex 0..1 오디오 코덱 옵션
오디오 옵션 complex 0..* 오디오 코덱 옵션
오디오 옵션 이름 string    
오디오 옵션값 string    
오디오 변환 complex    
오디오 페이드 complex 0..1  
오디오 페이드 인(초) string    
오디오 페이드 아웃(초) string    
채널 매핑 complex 0..1  
왼쪽 채널 매핑 string    
오른쪽 채널 매핑 string    
가운데 채널 매핑 string    
왼쪽 뒤 채널 매핑 string    
채널 매핑 LFE string    
오디오 게인 complex 0..1  
게인(dB) double   오디오 게인(dB)
일반화 부울    
음의 강도 조정 complex 0..1  
게인(dB) double   게인(dB)
ITU BS 1770 complex 0..1  
목표 인식 음의 강도(LKFS) double   목표 인식 음의 강도(LKFS)
최고 수준 제한 complex 0..1 최고 수준(dBFS)
최고 수준(dBFS) double    
정적 이미지 image 0..1 코드 변환용 정적 이미지

코드 변환 작업의 동작을 관리하는 일반적인 방법은 위에 나와 있는 것처럼 코드 변환 프로필을 구성하는 것입니다. 그러나 코드 변환 프로필을 훨씬 적게 조작해도 되는 옵션이 있습니다. 위에 빨간색으로 표시되어 있는 코드 변환 프로필 템플릿 옵션을 사용하면 코드 변환 템플릿을 업로드할 수 있습니다. 이 옵션을 설정하면 코드 변환 프로필을 훨씬 낮은 수준에서 보다 동적으로 제어할 수 있습니다. 여기에 대해서는 하위 수준 프로필 섹션에서 설명합니다.

하위 수준 프로필

보다 낮은 수준의 코드 변환 템플릿을 코드 변환 프로필에 업로드할 수 있습니다. 이 템플릿은 Velocity 템플릿 형식입니다. Apache Velocity Engine은 무료 오픈 소스 템플릿 작성 엔진입니다. Velocity에서는 단순하지만 효율적인 템플릿 언어를 사용하여 Java 코드로 정의된 개체를 참조할 수 있습니다. 이 템플릿은 완전히 순수하게 Java로만 작성되며 어플리케이션에 쉽게 임베드할 수 있습니다.

참고:이 가이드에서는 Velocity 템플릿 사용에 대해 설명하지 않습니다. 자세한 내용은 velocity.apache.org 및 API 가이드의 스크립팅 섹션에서 확인할 수 있습니다.

슈퍼 사용자는 Velocity 템플릿을 업로드하여 기본 코드 변환기에 대한 직접 XML 요청 API 호출을 생성할 수 있습니다. 이 템플릿은 보다 높은 수준의 미디어 코드 변환 프로필을 바이패스하며 코드 변환 어댑터도 바이패스합니다. 이 템플릿을 사용하는 경우의 이점은 다음과 같습니다.

• 코드 변환기에 대해 보다 자세하게 사용자 지정된 하위 수준 API 호출을 작성할 수 있습니다.

• 템플릿 작성과 스크립팅을 수행하면 컨텍스트 내에 있는 변수를 기준으로 하여 프로필을 동적으로 생성할 수 있습니다.

• 미디어 코드 변환 프로필에서 새롭게 제공되거나 아직 제공되지 않는 API 호출에 액세스할 수 있습니다.

Velocity Template Engine의 컨텍스트에서 제공되는 개체는 다음과 같습니다.

• 워크플로 컨텍스트에 있는 "document"라는 XML 문서

• 코드 변환 중인 자산에 속하는 메타데이터 인스턴스를 나타내는 "contentMetadata"라는 XML 문서

Velocity 템플릿을 생성하는 방법에 대한 자세한 내용은 API 가이드를 참조하십시오. Velocity 템플릿의 전체 예제는 부록에 나와 있습니다.

이미지 코드 변환 프로필

참고: 이 템플릿은 문자열 및 텍스트 필드의 스크립팅 값만 지원합니다!

속성:

Table 3.
필드 설명
아이콘 플러그인 아이콘
스크립팅 지원 구성이 스크립팅을 지원하는지 여부
스크립팅 컨텍스트 자산, 작업 스크립팅 컨텍스트 내에서 참조할 수 있는 Ooyala Flex 개체

구성:

Table 4.
필드 필드 유형 필수 다중성 설명
소스 complex 1 소스 0에 대한 정보
자산 컨텍스트 string    
이미지 형식 single-option   코드 변환할 자산 이미지
너비 integer   원하는 이미지의 너비. 크기 조정 모드 = 고정 너비 또는 배율인 경우에는 무시됨
높이 integer   원하는 이미지의 높이. 크기 조정 모드 = 고정 높이 또는 배율인 경우에는 무시됨
너비 배율 double   크기 조정 모드 = 배율인 경우 이미지 너비에 적용할 배율
높이 배율 double   크기 조정 모드 = 배율인 경우 이미지 높이에 적용할 배율
크기 조정 모드 single-option   크기 조정 모드

미디어 유효성 검사 프로필

참고: 이 템플릿은 문자열 및 텍스트 필드의 스크립팅 값만 지원합니다!

속성:

Table 5.
필드 설명
아이콘 플러그인 아이콘
스크립팅 지원 구성이 스크립팅을 지원하는지 여부
스크립팅 컨텍스트 자산, 작업, 이벤트 스크립팅 컨텍스트 내에서 참조할 수 있는 Ooyala Flex 개체

구성:

Table 6.
필드 필드 유형 필수 다중성 설명
파일 complex   형식 관련 정보
파일 비트 전송률 long    
시간(uSec) long    
스트림 수 integer    
비디오 스트림 수 integer    
오디오 스트림 수 integer    
형식 validation-format    
비디오 스트림 complex 0..1 비디오 스트림 정보. 이 항목을 추가하는 경우 오디오 스트림이 하나 이상 있어야 합니다.
비디오 스트림 complex 0..1 특정 비디오 스트림 관련 정보
일반 비디오 스트림 정보 complex   스트림 관련 일반 정보
비디오 비트 전송률 long    
비디오 언어 string    
비디오 시작 시간 코드 string    
비디오 외부 스트림 부울 0..1  
비디오 코덱 validation-video-codec    
MPEG-2 코덱 컨텍스트 complex 0..* 스트림 관련 일반 정보
GOP 크기 integer    
GOP 시퀀스 string    
I-프레임 전용 부울 0..1  
비트 전송률 유형 validation-bit-rate-type    
VBV 버퍼 크기 integer    
MPEG-2 프로필 validation-mpeg-2-profile    
MPEG-2 수준 validation-mpeg-2-level    
프레임 속도(fps) double    
프레임 너비(px) integer    
프레임 높이(px) integer    
픽셀 가로세로비(예: 4:3) string    
인터레이스 형식 validation-interlace-format    
픽셀 형식 validation-pixel-format    
표준 validation-standard    
텔레시네 형식 validation-telecine-format    
오디오 스트림 complex 0..1 오디오 스트림 정보. 이 항목을 추가하는 경우 오디오 스트림이 하나 이상 있어야 합니다.
오디오 스트림 complex 0..1 특정 비디오 스트림 관련 정보
일반 오디오 스트림 정보 complex   스트림 관련 일반 정보
오디오 비트 전송률 long    
오디오 언어 string    
오디오 시작 시간 코드 string    
오디오 외부 스트림 부울 0..1  
오디오 코덱 validation-audio-codec    
샘플 속도(kHz) double    
채널 integer    
샘플당 비트 수 integer    
내부 텍스트 메타데이터 complex 1 파일 내에 포함된 설명 메타데이터
필드 수 integer   메타데이터 필드의 수
필드 complex    
요약 string    
작성자 string    
저작권 string    
설명 string    

이미지 유효성 검사 프로필

참고: 이 템플릿은 문자열 및 텍스트 필드의 스크립팅 값만 지원합니다!

속성:

Table 7.
필드 설명
아이콘 플러그인 아이콘
스크립팅 지원 구성이 스크립팅을 지원하는지 여부
스크립팅 컨텍스트 자산, 작업, 이벤트 스크립팅 컨텍스트 내에서 참조할 수 있는 Ooyala Flex 개체

구성:

Table 8.
필드 필드 유형 필수 다중성 설명
이미지 형식 single-option   이미지의 파일 형식
파일 크기 long   파일의 크기(예: 100, 100..200, 100|200, >100, <200)
너비 integer   이미지의 픽셀 단위 너비(예: 800, 600..800, 600|800, >600, <800)
높이 integer   이미지의 픽셀 단위 높이(예: 800, 600..800, 600|800, >600, <800)
디스플레이 가로세로비 string   이미지의 가로세로비(예: 16:9)