91 lines
3.3 KiB
Markdown
91 lines
3.3 KiB
Markdown
|
# CLI Документация
|
|||
|
|
|
|||
|
|
Adaptive Video Converter предоставляет мощный интерфейс командной строки для конвертации видео в адаптивные форматы DASH и HLS.
|
|||
|
|
|
|||
|
|
## Основной синтаксис
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
avc <input-video> [output-dir] [options]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Быстрый старт
|
|||
|
|
|
|||
|
|
Простейший способ использования:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Конвертация с настройками по умолчанию
|
|||
|
|
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 для оптимального качества/размера
|
|||
|
|
- Возможность выбрать один кодек
|
|||
|
|
|
|||
|
|
## Системные требования
|
|||
|
|
|
|||
|
|
Перед использованием убедитесь, что установлены:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Проверка 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-я секунда)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Следующие шаги
|
|||
|
|
|
|||
|
|
- [Установка](/cli/installation) — Различные способы установки
|
|||
|
|
- [Использование](/cli/usage) — Базовые сценарии использования
|
|||
|
|
- [Опции и ключи](/cli/options) — Полный справочник параметров
|
|||
|
|
- [Примеры](/cli/examples) — Практические примеры для разных задач
|