sync
This commit is contained in:
@@ -1,13 +1,13 @@
|
||||
# CLI Reference — Справочник команд
|
||||
|
||||
Полное руководство по использованию DASH Video Converter CLI.
|
||||
Полное руководство по использованию Adaptive Video Converter CLI.
|
||||
|
||||
---
|
||||
|
||||
## Синтаксис
|
||||
|
||||
```bash
|
||||
dvc-cli <input-video> [output-dir] [options]
|
||||
avc <input-video> [output-dir] [options]
|
||||
```
|
||||
|
||||
## Позиционные аргументы
|
||||
@@ -41,13 +41,13 @@ dvc-cli <input-video> [output-dir] [options]
|
||||
**Примеры:**
|
||||
```bash
|
||||
# Базовые разрешения (30 FPS)
|
||||
dvc-cli video.mp4 -r 360,720,1080
|
||||
avc video.mp4 -r 360,720,1080
|
||||
|
||||
# С указанием FPS
|
||||
dvc-cli video.mp4 -r 720@60,1080@60
|
||||
avc video.mp4 -r 720@60,1080@60
|
||||
|
||||
# Смешанный формат
|
||||
dvc-cli video.mp4 -r 360 720@60 1080 1440@120
|
||||
avc video.mp4 -r 360 720@60 1080 1440@120
|
||||
```
|
||||
|
||||
**Автоматическая коррекция FPS:**
|
||||
@@ -71,13 +71,13 @@ dvc-cli video.mp4 -r 360 720@60 1080 1440@120
|
||||
**Примеры:**
|
||||
```bash
|
||||
# Только H.264 (быстрее, больше места)
|
||||
dvc-cli video.mp4 -c h264
|
||||
avc video.mp4 -c h264
|
||||
|
||||
# Только AV1 (медленнее, меньше места)
|
||||
dvc-cli video.mp4 -c av1
|
||||
avc video.mp4 -c av1
|
||||
|
||||
# Оба кодека (максимальная совместимость)
|
||||
dvc-cli video.mp4 -c dual
|
||||
avc video.mp4 -c dual
|
||||
```
|
||||
|
||||
**GPU ускорение:**
|
||||
@@ -100,13 +100,13 @@ dvc-cli video.mp4 -c dual
|
||||
**Примеры:**
|
||||
```bash
|
||||
# Только DASH
|
||||
dvc-cli video.mp4 -f dash
|
||||
avc video.mp4 -f dash
|
||||
|
||||
# Только HLS (для Safari/iOS)
|
||||
dvc-cli video.mp4 -f hls
|
||||
avc video.mp4 -f hls
|
||||
|
||||
# Оба формата (максимальная совместимость)
|
||||
dvc-cli video.mp4 -f both
|
||||
avc video.mp4 -f both
|
||||
```
|
||||
|
||||
**Особенности:**
|
||||
@@ -163,10 +163,10 @@ output/
|
||||
**Примеры:**
|
||||
```bash
|
||||
# 5 секунд от начала
|
||||
dvc-cli video.mp4 -p 5
|
||||
avc video.mp4 -p 5
|
||||
|
||||
# 1 минута 30 секунд
|
||||
dvc-cli video.mp4 -p 00:01:30
|
||||
avc video.mp4 -p 00:01:30
|
||||
```
|
||||
|
||||
**По умолчанию:** `00:00:01` (1 секунда от начала)
|
||||
@@ -179,68 +179,68 @@ dvc-cli video.mp4 -p 00:01:30
|
||||
|
||||
```bash
|
||||
# Простейший запуск (оба формата, dual codec, автопрофили)
|
||||
dvc-cli video.mp4
|
||||
avc video.mp4
|
||||
|
||||
# С указанием выходной директории
|
||||
dvc-cli video.mp4 ./output
|
||||
avc video.mp4 ./output
|
||||
```
|
||||
|
||||
### Кастомные профили
|
||||
|
||||
```bash
|
||||
# Только 720p и 1080p
|
||||
dvc-cli video.mp4 -r 720,1080
|
||||
avc video.mp4 -r 720,1080
|
||||
|
||||
# High FPS профили
|
||||
dvc-cli video.mp4 -r 720@60,1080@60,1440@120
|
||||
avc video.mp4 -r 720@60,1080@60,1440@120
|
||||
|
||||
# Один профиль 4K
|
||||
dvc-cli video.mp4 -r 2160
|
||||
avc video.mp4 -r 2160
|
||||
```
|
||||
|
||||
### Выбор кодека
|
||||
|
||||
```bash
|
||||
# Быстрое кодирование (только H.264)
|
||||
dvc-cli video.mp4 -c h264
|
||||
avc video.mp4 -c h264
|
||||
|
||||
# Лучшее сжатие (только AV1)
|
||||
dvc-cli video.mp4 -c av1
|
||||
avc video.mp4 -c av1
|
||||
|
||||
# Максимальная совместимость
|
||||
dvc-cli video.mp4 -c dual
|
||||
avc video.mp4 -c dual
|
||||
```
|
||||
|
||||
### Выбор формата
|
||||
|
||||
```bash
|
||||
# DASH для современных браузеров
|
||||
dvc-cli video.mp4 -f dash
|
||||
avc video.mp4 -f dash
|
||||
|
||||
# HLS для Safari/iOS
|
||||
dvc-cli video.mp4 -f hls -c h264
|
||||
avc video.mp4 -f hls -c h264
|
||||
|
||||
# Оба формата для всех устройств
|
||||
dvc-cli video.mp4 -f both -c dual
|
||||
avc video.mp4 -f both -c dual
|
||||
```
|
||||
|
||||
### Комбинированные примеры
|
||||
|
||||
```bash
|
||||
# Производственная конфигурация
|
||||
dvc-cli video.mp4 ./cdn/videos -r 360,720,1080 -c dual -f both
|
||||
avc video.mp4 ./cdn/videos -r 360,720,1080 -c dual -f both
|
||||
|
||||
# High-end конфигурация (4K, high FPS)
|
||||
dvc-cli video.mp4 -r 720@60,1080@60,1440@120,2160@60 -c dual -f both
|
||||
avc video.mp4 -r 720@60,1080@60,1440@120,2160@60 -c dual -f both
|
||||
|
||||
# Быстрая конвертация для тестов
|
||||
dvc-cli video.mp4 -r 720 -c h264 -f dash
|
||||
avc video.mp4 -r 720 -c h264 -f dash
|
||||
|
||||
# Mobile-first (низкие разрешения, HLS)
|
||||
dvc-cli video.mp4 -r 360,480,720 -c h264 -f hls
|
||||
avc video.mp4 -r 360,480,720 -c h264 -f hls
|
||||
|
||||
# Кастомный постер
|
||||
dvc-cli video.mp4 -r 720,1080 -p 00:02:30
|
||||
avc video.mp4 -r 720,1080 -p 00:02:30
|
||||
```
|
||||
|
||||
---
|
||||
@@ -302,7 +302,7 @@ brew install ffmpeg gpac
|
||||
### Для максимальной совместимости
|
||||
|
||||
```bash
|
||||
dvc-cli video.mp4 -c dual -f both
|
||||
avc video.mp4 -c dual -f both
|
||||
```
|
||||
|
||||
Генерирует:
|
||||
@@ -313,7 +313,7 @@ dvc-cli video.mp4 -c dual -f both
|
||||
### Для быстрой разработки
|
||||
|
||||
```bash
|
||||
dvc-cli video.mp4 -r 720 -c h264 -f dash
|
||||
avc video.mp4 -r 720 -c h264 -f dash
|
||||
```
|
||||
|
||||
Быстрое кодирование одного профиля.
|
||||
@@ -321,7 +321,7 @@ dvc-cli video.mp4 -r 720 -c h264 -f dash
|
||||
### Для продакшена
|
||||
|
||||
```bash
|
||||
dvc-cli video.mp4 -r 360,480,720,1080,1440 -c dual -f both
|
||||
avc video.mp4 -r 360,480,720,1080,1440 -c dual -f both
|
||||
```
|
||||
|
||||
Широкий диапазон профилей для всех устройств.
|
||||
@@ -329,7 +329,7 @@ dvc-cli video.mp4 -r 360,480,720,1080,1440 -c dual -f both
|
||||
### Для 4K контента
|
||||
|
||||
```bash
|
||||
dvc-cli video.mp4 -r 720,1080,1440,2160 -c dual -f both
|
||||
avc video.mp4 -r 720,1080,1440,2160 -c dual -f both
|
||||
```
|
||||
|
||||
От HD до 4K для премиум контента.
|
||||
@@ -348,9 +348,9 @@ dvc-cli video.mp4 -r 720,1080,1440,2160 -c dual -f both
|
||||
**Решение:**
|
||||
```bash
|
||||
# Используйте h264 или dual
|
||||
dvc-cli video.mp4 -f hls -c h264
|
||||
avc video.mp4 -f hls -c h264
|
||||
# или
|
||||
dvc-cli video.mp4 -f hls -c dual
|
||||
avc video.mp4 -f hls -c dual
|
||||
```
|
||||
|
||||
### FPS источника ниже запрошенного
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# Возможности DASH Video Converter
|
||||
# Возможности Adaptive Video Converter
|
||||
|
||||
## Архитектура
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@ npm login
|
||||
### Шаг 2: Сборка проекта
|
||||
|
||||
```bash
|
||||
cd /home/gromov/projects/my/dvc-cli
|
||||
cd /home/gromov/projects/my/adaptive-video-converter
|
||||
npm run build
|
||||
```
|
||||
|
||||
@@ -30,7 +30,7 @@ npm pack --dry-run
|
||||
|
||||
# Или создать тестовый архив для проверки
|
||||
npm pack
|
||||
# Это создаст файл grom13-dvc-cli-0.1.0.tgz
|
||||
# Это создаст файл grom13-adaptive-video-converter-0.1.0.tgz
|
||||
```
|
||||
|
||||
## Публикация
|
||||
@@ -47,13 +47,13 @@ npm publish --access public
|
||||
|
||||
```bash
|
||||
# Проверить что пакет доступен
|
||||
npm view @grom13/dvc-cli
|
||||
npm view @grom13/adaptive-video-converter
|
||||
|
||||
# Протестировать установку через npx
|
||||
npx @grom13/dvc-cli --help
|
||||
npx @grom13/adaptive-video-converter --help
|
||||
|
||||
# Или установить глобально и протестировать
|
||||
npm install -g @grom13/dvc-cli
|
||||
npm install -g @grom13/adaptive-video-converter
|
||||
dvc --help
|
||||
```
|
||||
|
||||
@@ -82,10 +82,10 @@ npm publish --access public
|
||||
|
||||
```bash
|
||||
# Удалить конкретную версию (в течение 72 часов)
|
||||
npm unpublish @grom13/dvc-cli@0.1.0
|
||||
npm unpublish @grom13/adaptive-video-converter@0.1.0
|
||||
|
||||
# Удалить весь пакет (использовать осторожно!)
|
||||
npm unpublish @grom13/dvc-cli --force
|
||||
npm unpublish @grom13/adaptive-video-converter --force
|
||||
```
|
||||
|
||||
⚠️ **Внимание:** После unpublish нельзя повторно опубликовать ту же версию. Нужно увеличить версию.
|
||||
@@ -96,14 +96,14 @@ npm unpublish @grom13/dvc-cli --force
|
||||
|
||||
```bash
|
||||
# Через npx (без установки)
|
||||
npx @grom13/dvc-cli video.mp4 ./output
|
||||
npx @grom13/adaptive-video-converter video.mp4 ./output
|
||||
|
||||
# Глобальная установка
|
||||
npm install -g @grom13/dvc-cli
|
||||
npm install -g @grom13/adaptive-video-converter
|
||||
dvc video.mp4 ./output
|
||||
|
||||
# Локальная установка в проект
|
||||
npm install @grom13/dvc-cli
|
||||
npm install @grom13/adaptive-video-converter
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
@@ -468,8 +468,8 @@ chmod +x test_codec.sh
|
||||
# - AV1 для современных браузеров
|
||||
# - H.264 для старых устройств (iOS < 14)
|
||||
|
||||
# Пример: dvc-cli уже реализует это
|
||||
dvc-cli input.mp4 output/ -c dual -f both -r 360,720,1080
|
||||
# Пример: avc уже реализует это
|
||||
avc input.mp4 output/ -c dual -f both -r 360,720,1080
|
||||
```
|
||||
|
||||
### Для архивирования
|
||||
|
||||
Reference in New Issue
Block a user