Files
2025-12-03 22:46:15 +03:00

3.3 KiB
Raw Permalink Blame History

CLI Документация

Adaptive Video Converter предоставляет мощный интерфейс командной строки для конвертации видео в адаптивные форматы DASH и HLS.

Основной синтаксис

avc <input-video> [output-dir] [options]

Быстрый старт

Простейший способ использования:

# Конвертация с настройками по умолчанию
avc video.mp4

Это создаст в текущей директории папку с именем видео, содержащую:

  • DASH и HLS манифесты
  • Сегменты для H.264 и AV1
  • Автоматически выбранные профили качества
  • Превью-спрайты и постер

Основные возможности

🎯 Автоматическая конфигурация

  • Автоопределение GPU (NVENC)
  • Автовыбор профилей качества на основе исходного видео
  • Динамический расчет битрейтов

GPU-ускорение

  • NVIDIA NVENC для H.264 и AV1
  • Автоматический фоллбек на CPU если GPU недоступен

📊 Адаптивный стриминг

  • DASH (современный стандарт)
  • HLS (совместимость с Apple)
  • Множественные профили качества (360p - 4K)
  • Поддержка высоких FPS (60/90/120)

🎬 Двойное кодирование

  • H.264 для максимальной совместимости
  • AV1 для оптимального качества/размера
  • Возможность выбрать один кодек

Системные требования

Перед использованием убедитесь, что установлены:

# Проверка FFmpeg
ffmpeg -version

# Проверка MP4Box
MP4Box -version

Необходимо:

  • Node.js ≥ 18.0.0
  • FFmpeg (с NVENC для GPU)
  • MP4Box (gpac)

Опционально:

  • NVIDIA GPU с поддержкой NVENC

Структура выходных файлов

video/
├── manifest.mpd              # DASH манифест
├── master.m3u8               # HLS мастер-плейлист
├── 720p-h264/                # Сегменты профиля 720p H.264
│   ├── 720p-h264_init.mp4
│   └── 720p-h264_*.m4s
├── 720p-av1/                 # Сегменты профиля 720p AV1
├── 1080p-h264/
├── 1080p-av1/
├── thumbnails.jpg            # Спрайт превью (160×90px)
├── thumbnails.vtt            # WebVTT метки для превью
└── poster.jpg                # Постер из видео (1-я секунда)

Следующие шаги