Documentazione tecnica · Multimedia

Variabili
Video & Audio

Video — 15 variabili Audio — 11 variabili Comuni — 7 variabili
🎬

Variabili Video

15 variabili · 6 categorie
Categoria Variabile Tipo Descrizione Esempio / Valori
Risoluzione width integer Larghezza del frame in pixel 1920, 3840
height integer Altezza del frame in pixel 1080, 2160
aspect_ratio string Rapporto larghezza/altezza "16:9", "4:3"
Frame framerate float Frame al secondo (fps) 24, 30, 60
frame_count integer Numero totale di frame 14400
gop_size integer Group of Pictures (distanza keyframe) 30, 60
Codec/Encoding video_codec string Codec di compressione video "h264", "hevc", "av1"
bitrate integer Bitrate video in kbps 5000, 15000
profile string Profilo codec "baseline", "main", "high"
level string Livello codec "4.0", "5.1"
Colore color_space string Spazio colore "bt709", "bt2020"
color_depth integer Profondità colore in bit 8, 10, 12
chroma_subsampling string Sottocampionamento croma "4:2:0", "4:2:2"
Metadata duration float Durata in secondi 125.45
rotation integer Rotazione del video 0, 90, 180
has_alpha boolean Presenza canale alfa true / false
🔊

Variabili Audio

11 variabili · 5 categorie
Categoria Variabile Tipo Descrizione Esempio / Valori
Base sample_rate integer Frequenza di campionamento (Hz) 44100, 48000
channels integer Numero di canali audio 1 (mono), 2 (stereo), 6 (5.1)
bit_depth integer Profondità bit per campione 16, 24, 32
Codec/Encoding audio_codec string Codec di compressione audio "aac", "mp3", "flac", "opus"
bitrate integer Bitrate audio in kbps 128, 320, 1411
compression_level integer Livello di compressione (codec lossless) 0–12 (FLAC)
Canali channel_layout string Disposizione canali "stereo", "5.1", "7.1"
lfe_channel boolean Presenza canale LFE (subwoofer) true / false
Metadata duration float Durata in secondi 125.45
language string Codice lingua audio "ita", "eng"
title string Titolo della traccia "Colonna sonora"
🔄

Variabili Comuni

7 variabili · Container / Metadata
Variabile Tipo Descrizione Esempio
container_format string Formato contenitore "mp4", "mkv", "mov"
file_size integer Dimensione file in byte 2147483648
creation_time datetime Data creazione file "2024-03-15T10:30:00Z"
title string Titolo del media "Video Presentazione"
artist / author string Autore / Artista "Mario Rossi"
copyright string Informazioni copyright "© 2024 Azienda XYZ"
tags array[string] Tag descrittivi ["tutorial", "hd", "italiano"]
💻

Struttura JSON

Esempio completo
JSON
{
  "video": {
    "width": 1920,
    "height": 1080,
    "framerate": 30,
    "codec": "h264",
    "bitrate": 8000,
    "color_space": "bt709",
    "color_depth": 8
  },
  "audio": {
    "codec": "aac",
    "sample_rate": 48000,
    "channels": 2,
    "bitrate": 256,
    "language": "ita"
  },
  "metadata": {
    "duration": 185.5,
    "container": "mp4",
    "title": "Esempio Video",
    "creation_time": "2024-03-14T15:00:00Z"
  }
}
🛠️

Utilizzo Pratico

⚙️
Script di encoding
Configurazione parametri per FFmpeg e HandBrake
🔍
Analisi tecnica
Ispezione e validazione di file multimediali
🎞️
Player / Editor
Sviluppo di applicazioni video e audio
🗃️
Database asset
Catalogazione di asset multimediali
✅
Pipeline di produzione
Validazione automatica di file in workflow
STRUMENTI CONSIGLIATI
ffprobe (FFmpeg) mediainfo moviepy (Python) fluent-ffmpeg (Node.js)