다큐멘트 센터 Object Storage API Avinfo Field Description

Avinfo Field Description

최신 업데이트:2025-08-18 15:33:05

API는 오디오 및 비디오 파일에 대한 포괄적인 메타데이터를 반환하며, 주요 정보는 streams(스트림 정보)와 format(파일 포맷 정보) 필드에 포함되어 있습니다. 이 문서에서는 API 응답에 포함되는 각 필드에 대해 설명합니다.

오디오 및 비디오 스트림 정보 – streams 필드

각 미디어 스트림은 streams 배열의 하나의 항목에 해당합니다.

공통 필드

필드명 설명
avg_frame_rate 평균 프레임 레이트
bit_rate 비트레이트
codec_long_name 전체 코덱명
codec_name 코덱명
codec_tag 코덱 태그
codec_tag_string 코덱 태그 문자열
codec_time_base 코덱 프레임 시간
codec_type 코덱 타입
display_aspect_ratio 디스플레이 화면 비율
disposition 설정 정보 (아래 참조)
duration 스트림 길이
rotate 회전 정보
duration_ts 전체 프레임 시간
has_b_frames B-프레임 버퍼 크기
height 비디오 세로 해상도
index 스트림 인덱스
level 레벨
nb_frames 전체 프레임 수
pix_fmt 픽셀 포맷
profile 프로파일
r_frame_rate 실제 기준 프레임 레이트
sample_aspect_ratio 샘플 화면 비율
start_pts 시작 PTS(프리젠테이션 타임스탬프)
start_time 첫 프레임 시간
tag 태그 정보 (아래 참조)
time_base 프레임 단위 시간
width 비디오 가로 해상도

disposition 필드 설명

필드 설명
attached_pic 썸네일/첨부 이미지
clean_effects 클린 이펙트
comment 코멘트
default 기본 스트림
dub 더빙
forced 강제 스트림
hearing_impaired 청각장애용 스트림
karaoke 노래방 트랙
lyrics 가사 트랙
original 원본 스트림
visual_impaired 시각장애용 스트림

tag 필드 설명

필드 설명
creation_time 생성 시간
encoder 인코더 명
handler_name 핸들러 명
language 언어

오디오 스트림 전용 필드

필드명 설명
bits_per_sample 샘플당 비트수
channels 채널 수
sample_fmt 샘플 포맷
sample_rate 샘플 속도(Hz)

파일 포맷 정보 – format 필드

이 필드는 전체 미디어 파일에 대한 정보를 포함합니다.

필드 설명

필드명 설명
bit_rate 비트레이트
duration 길이
format_long_name 전체 포맷명
format_name 포맷 약칭
nb_programs 프로그램 개수
nb_streams 스트림 개수
probe_score 프로브 점수(포맷 탐지 신뢰도)
size 파일 크기
start_time 첫 프레임 시간
tag 태그 정보 (아래 참조)

tag 필드 설명

필드 설명
compatible_brands 호환 브랜드
creation_time 생성 시간
major_brand 메인 브랜드
minor_version 마이너 버전

샘플 응답

{
    "streams": [
        {
            "avg_frame_rate": <average frame rate>,
            "bit_rate": <bitrate>,
            "codec_long_name": <full codec name>,
            "codec_name": <codec name>,
            "codec_tag": <codec tag>,
            "codec_tag_string": <codec tag string>,
            "codec_time_base": <codec frame duration>,
            "codec_type": <codec type>,
            "display_aspect_ratio": <display aspect ratio>,
            "disposition": { // disposition information
                "attached_pic": 0,
                "clean_effects": 0,
                "comment": 0,
                "default": 1,
                "dub": 0,
                "forced": 0,
                "hearing_impaired": 0,
                "karaoke": 0,
                "lyrics": 0,
                "original": 0,
                "visual_impaired": 0
            },
            "duration": <duration>,
            "rotate": <rotation information>,
            "duration_ts": <total frame time>,
            "has_b_frames": <B-frame buffer size>,
            "height": <height>,
            "index": <stream index>,
            "level": <level>,
            "nb_frames": <number of frames>,
            "pix_fmt": <pixel format>,
            "profile": <profile>,
            "r_frame_rate": <real base frame rate>,
            "sample_aspect_ratio": <sample aspect ratio>,
            "start_pts": <start PTS>,
            "start_time": <first frame time>,
            "tag": { // tag information
                "creation_time": <creation time>,
                "encoder": <encoder name>,
                "handler_name": <handler name>,
                "language": <language>
            },
            "time_base": <frame duration>,
            "width": <width>
        },
        {
            "avg_frame_rate": <average frame rate>,
            "bit_rate": <bitrate>,
            "bits_per_sample": <bits per sample>,
            "channels": <channels>,
            "codec_long_name": <full codec name>,
            "codec_name": <codec name>,
            "codec_tag": <codec tag>,
            "codec_tag_string": <codec tag string>,
            "codec_time_base": <codec frame duration>,
            "codec_type": <codec type>,
            "disposition": { // disposition information
                "attached_pic": 0,
                "clean_effects": 0,
                "comment": 0,
                "default": 1,
                "dub": 0,
                "forced": 0,
                "hearing_impaired": 0,
                "karaoke": 0,
                "lyrics": 0,
                "original": 0,
                "visual_impaired": 0
            },
            "duration": <duration>,
            "duration_ts": <total frame time>,
            "index": <stream index>,
            "nb_frames": <number of frames>,
            "profile": <profile>,
            "r_frame_rate": <real base frame rate>,
            "sample_fmt": <sample format>,
            "sample_rate": <sample rate>,
            "start_pts": <start PTS>,
            "start_time": <first frame time>,
            "tag": { // tag information
                "creation_time": <creation time>,
                "handler_name": <handler name>,
                "language": <language>
            },
            "time_base": <frame duration>
        }
    ],
    "format": {
        "bit_rate": <bitrate>,
        "duration": <duration>,
        "format_long_name": <full format name>,
        "format_name": <format name>,
        "nb_programs": <number of programs>,
        "nb_streams": <number of streams>,
        "probe_score": <probe score>,
        "size": <file size>,
        "start_time": <first frame time>,
        "tag": { // tag information
            "compatible_brands": <compatible brands>,
            "creation_time": <creation time>,
            "major_brand": <major brand>,
            "minor_version": <minor version>
        }
    }
}
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.