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) — Практические примеры для разных задач
|