Об этом проекте

pyJianYingDraft — это легкий, гибкий и простой в освоении инструмент на Python для генерации и экспорта черновиков CapCut (JianYing), нацеленный на создание полностью автоматизированных конвейеров видеомонтажа и нарезки. Проект устанавливается через pip (рекомендуются Python 3.8 или 3.11); текущая версия 0.3.0 прошла масштабное обновление. Версия для CapCut разрабатывается в отдельном репозитории. Основные возможности Видео и изображения: поддержка локальных видео/изображений с контролем времени, общая настройка (поворот, отражение, масштабирование, прозрачность, смещение), ключевые кадры, маски, хромакей, заливка фона, режимы наложения (10 типов, включая умножение, осветление, перекрытие и др.). Аудио: поддержка локальных аудиофайлов с контролем времени, плавное появление/затухание и громкость, фоновые звуки и тембровые эффекты; эффект озвучивания музыки не работает в CapCut 5.9, но работает в 10.8. Текст и субтитры: поддержка стилей текста, шрифтов, ключевых кадров, анимаций, обводки/фона/тени, пузырей и декоративных эффектов, автоматический перенос строк, а также импорт файлов субтитров SRT с поддержкой временного смещения и эталонных стилей. Эффекты, фильтры и переходы: анимации клипов, эффекты клипов, фильтры клипов, а также отдельные дорожки эффектов и фильтров; типы эффектов именуются через перечисления с комментариями к параметрам, доступно нечеткое сопоставление через from_name. Управление дорожками: предоставляются два набора интерфейсов — append_track/append_tracks и insert_track/insert_tracks, с контролем уровня через over_track, under_track или at_index. Режим шаблонов: можно загружать существующие черновики CapCut в качестве шаблонов; поддерживается замена материалов по имени, замена материалов по клипам (с возможностью повторного выбора диапазона материала и растяжения клипа), замена текстового содержимого, импорт аудио/видео/текстовых дорожек из шаблона, а также извлечение метаданных стикеров/пузырей/декоративных эффектов. В новых версиях CapCut файл draft_content.json часто не является открытым JSON; для этого требуется подключение дополнительного считывателя через fallback_loader. Пакетный экспорт: управление экспортом черновиков CapCut через JianyingController, с настройкой разрешения и частоты кадров. Эта функция зависит от uiautomation, поддерживает только Windows и применима только к CapCut версии 6 и ниже (в CapCut 7+ соответствующие элементы управления скрыты). Обработка времени: внутренне используется микросекунды, также поддерживаются строковые форматы (например, "1.5s", "1h3m12s"); предоставляются удобные функции tim, trange, trange_seconds. Кроссплатформенная совместимость: Windows поддерживает генерацию черновиков, режим шаблонов и автоматический экспорт (с ограничениями по версии CapCut); Linux/MacOS поддерживают генерацию черновиков и режим шаблонов, но не поддерживают автоматический экспорт — созданные черновики все равно необходимо экспортировать в Windows-версии CapCut. Примечания: при открытии черновика CapCut пытается автоматически загрузить некэшированные анимации/эффекты/переходы, что может привести к тайм-ауту и ошибке загрузки; некэшированные шрифты требуют повторного открытия черновика; автоматический экспорт выводит окно CapCut на передний план и управляет щелчками курсора, поэтому рекомендуется запускать его в простое время и убедиться, что есть разрешение на экспорт.