add vitepress
This commit is contained in:
90
docs/cli/index.md
Normal file
90
docs/cli/index.md
Normal file
@@ -0,0 +1,90 @@
|
||||
# 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) — Практические примеры для разных задач
|
||||
Reference in New Issue
Block a user