add vitepress

This commit is contained in:
2025-12-03 22:46:15 +03:00
parent d85cb263ce
commit 0ccd16c1cf
15 changed files with 5802 additions and 4 deletions

90
docs/cli/index.md Normal file
View 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) — Практические примеры для разных задач