| 소품 | 유형 | 필수 | 예시 | 값 범위 | 설명 |
|---|---|---|---|---|---|
| width | number | true | - | - | 비디오 요소의 너비. |
| height | number | true | - | - | 비디오 요소의 높이. |
| ext | string | true | - | mp4 | mov | 비디오의 파일 확장자 (예: "mp4", "mov"). |
| externalUrl | string | false | - | - | 외부 소스에서 비디오 파일의 URL. |
| startInSource | number | true | - | - | 소스 파일에서 비디오 클립의 시작 시간(초 단위). 보통 0이며, 비디오 노드가 원본 비디오의 앞쪽에서 잘려진 경우에만 0과 다릅니다. startInSource와 duration의 합은 sourceDuration보다 작거나 같아야 합니다. |
| sourceDuration | number | true | - | - | 원본 비디오 파일의 총 길이(초 단위). 이 필드는 원본 비디오의 실제 길이와 일치해야 합니다. |
| isFrontTrimmed | boolean | false | - | - | 비디오가 원본 비디오의 앞쪽에서 잘려졌는지 여부를 나타냅니다. startInSource가 0이 아닐 때 true로 설정해야 합니다. |
| volume | number | false | - | 0 - 1 | 비디오 요소의 볼륨 레벨. 1은 최대 볼륨을 나타내고, 0은 음소거를 나타냅니다. |
| hasAudio | boolean | true | - | - | 비디오 요소가 오디오를 포함하는지 여부를 나타냅니다. |
| tone | object | false | - | - | 감마, 채도, 대비, 밝기 및 색상 채널을 포함한 이미지 톤 조정. |
| lut | object | false | - | - | 이미지 톤을 조정하는 데 사용되는 룩업 테이블. |
| filterAgent | object | false | - | - | 비디오에 적용된 필터 구성. 선택적 영역 마스킹을 지원합니다. |
| maskData | object | false | - | - | 비디오 요소 자체를 자르거나 형태를 만드는 마스크 구성(노드 수준 클리핑). 이는 필터 효과가 적용되는 위치를 제한하는 filterAgent.region과 다릅니다. |
참고:
- externalUrl은 접근 가능해야 합니다.
- H.264 인코딩된 비디오만 지원되며, HEVC (H.265) 인코딩된 비디오는 지원되지 않습니다.
sourceDuration필드는 원본 비디오 파일의 실제 길이와 일치해야 합니다.startInSource와duration의 합은sourceDuration보다 작거나 같아야 합니다.- 대부분의 경우,
startInSource는 0입니다. 비디오 노드가 원본 비디오의 앞쪽에서 잘려진 경우에만 0과 다릅니다.startInSource가 0이 아닐 경우, 비디오가 앞쪽에서 잘려졌음을 나타내기 위해isFrontTrimmed를 true로 설정해야 합니다.
{
"id": "30793500-aee2-4f6d-845f-b3adbe4302ca",
"type": "Video",
"width": 1280,
"height": 720,
"hasAudio": true,
"start": 0,
"duration": 10.218542,
"trackIndex": 0,
"x": -209.95197696399893,
"y": 254.59255700448338,
"blendMode": "normal",
"anchorX": 640,
"anchorY": 360,
"rotation": 0,
"scaleX": 1,
"scaleY": 1,
"alpha": 1,
"skewX": 0,
"skewY": 0,
"keyframes": [],
"filterAgent": {
"type": "Pixelate",
"options": [{ "key": "size", "value": 8, "min": 1, "max": 100 }]
},
"externalUrl": "https://videos.pexels.com/video-files/1526909/1526909-hd_1280_720_24fps.mp4",
"ext": "mp4",
"tone": {
"gamma": -0.66,
"saturation": 0,
"contrast": 0,
"brightness": 0,
"red": 0,
"green": 0,
"blue": 0
},
"startInSource": 0,
"sourceDuration": 30.5,
"volume": 1
}