비디오 어노테이터 스키마

비디오 어노테이터 전용 스키마

본 문서는 공통 어노테이터 스키마를 상속합니다.

따라서 extra, relations, annotations, annotationsData, annotationGroups, assignmentId의 최상위 구조와 AnnotationBase, Classification 등 공통 객체 정의는 공통 문서를 참고하세요.

1. 비디오 전용 메타데이터 (extra)

키	타입	설명
frameCount	number	전체 프레임 수
frameRate	number	FPS(프레임/초)
durationSeconds	number	영상 길이(초)
width / height	number	원본 해상도(px)

필요 시 카메라 정보, 코덱 등 프로젝트별 속성을 자유롭게 추가합니다.

2. 어노테이션 객체 (annotations)

• 사용 가능한 2D 툴은 이미지 어노테이터와 동일합니다 (bounding_box, polygon, polyline, keypoint, segmentation).
• 모든 어노테이션 객체는 공통 AnnotationBase를 상속합니다.
• 비디오 특화 차이점: 어노테이션이 유효한 프레임 구간을 가지며, 해당 구간 정보는 annotationsData에 저장됩니다.

2-1. 프레임 구간(section)

annotationsData.<videoId>[].section 구조:

필드	타입	설명
startFrame	number	어노테이션 시작 프레임(0-base)
endFrame	number	어노테이션 종료 프레임(포함)

동일 어노테이션 ID가 여러 구간에 나타날 수 있습니다 (예: 분할 편집).

3. 관계 (relations) 활용 예

• 동일 객체를 추적할 때 프레임별 어노테이션을 “track” 관계로 연결
• 다중 객체 상호작용(예: 충돌)도 관계로 표현 가능

4. 어노테이션 그룹 (annotationGroups)

• 장면별·샷별로 어노테이션을 묶어 레이어처럼 관리
• 그룹 객체는 annotationList로 자식 어노테이션을 참조하며, 필요 시 classification으로 장면 타입(“실내”, “야간” 등)을 태깅