Импорт видео

TubePress может наполнить вашу библиотеку несколькими способами — от добавления одного клипа вручную до загрузки сотен тысяч готовых видео из облака. На этой странице описан встроенный импортёр и показано, где находятся остальные маршруты.

Какой бы метод вы ни выбрали, результат одинаков: обычные видео, которые можно редактировать, организовывать, модерировать и публиковать, как любые другие. Выберите тот, который соответствует объёму вашего контента и тому, нужна ли вам разовая загрузка или постоянное пополнение.

Способы добавления контента в TubePress

Нет единственного «правильного» способа добавления видео — каждый метод подходит для разного масштаба и рабочего процесса. Используйте таблицу ниже для выбора, затем перейдите по ссылке за подробностями.

Импорт одного видео

В TubePress нет отдельного импортёра для «одного видео» — чтобы добавить одно видео, используйте экран Видео по адресу /admin/videos и выберите Добавить видео. Есть два способа предоставить медиафайл:

• Загрузка вручную — загрузите видеофайл, который вы размещаете самостоятельно.
• Импорт по одному URL — вставьте код вставки <iframe> или прямой URL видео для встраивания клипа, размещённого в другом месте.

Заполните название и миниатюру, прикрепите категории, теги или исполнителей, затем сохраните как черновик или сразу опубликуйте. Ни один из вариантов не использует кредиты.

Массовый импорт

Массовый импорт находится на вкладке Загрузить файл по адресу /admin/import. Он принимает один файл CSV или JSON — не вставленный список URL — и превращает каждую строку или объект в видео.

• CSV должен иметь строку заголовка и использовать запятые в качестве разделителей.
• JSON должен быть массивом объектов.

Перетащите файл в зону загрузки (или нажмите для просмотра), и TubePress прочитает столбцы и покажет предварительный просмотр. Минимальный CSV выглядит так:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

Затем вы сопоставляете свои столбцы с полями TubePress, перетаскивая их на место. Поля, которые распознаёт импортёр, включают:

Перед началом установите, как обрабатываются дубликаты (пропустить или обновить, сопоставляются по video_id), загружать ли миниатюры для хранения в вашем хранилище, а также любую необязательную переработку или перевод с помощью ИИ.

Как работает очередь импорта

Для любых файлов, кроме небольших, выберите Запустить в фоне. TubePress создаёт задание и передаёт его обработчику импорта, который обрабатывает строки даже после закрытия вкладки. Системный crontab не требуется — он работает на встроенном pseudo-cron.

Обработчик разработан для безопасной и устойчивой работы:

• Пакетный. Строки импортируются по несколько за раз, чтобы веб-воркер не был занят; регулируемая скорость импорта контролирует количество в каждом пакете.
• Асинхронный. pseudo-cron подхватывает задание по мере получения сайтом трафика, а страница импорта подталкивает его, пока открыта.
• Самовосстановление. Задание, которое зависло — например, при перезапуске сервера во время выполнения — автоматически ставится в очередь заново примерно через пять минут и продолжает с того места, где остановилось.
• Дедупликация. Строки с известным video_id пропускаются или обновляются, а не дублируются.
• Устойчивость к ошибкам. Некорректная строка записывается в журнал (первые несколько ошибок в каждом пакете фиксируются) и задание продолжается.

Отслеживание прогресса импорта

Откройте /admin/import и наблюдайте за Очередью импорта. Каждое активное задание показывает текущие счётчики — импортировано, пропущено, ошибки и обработано из общего числа — обновляемые каждые несколько секунд.

Здесь можно приостановить, возобновить, отменить или удалить задание. Задания за последние 24 часа остаются в списке, чтобы вы могли просмотреть, что произошло, включая образцы сообщений об ошибках для строк, которые не удалось обработать.

Советы и ограничения

• Принимаются только файлы .csv и .json; другие форматы отклоняются сразу.
• Практический минимум для строки — название плюс код вставки и миниатюра.
• Размер загрузки ограничен параметрами upload_max_filesize и post_max_size вашего сервера. Разделите очень большие файлы или используйте фоновое задание.
• Сопоставьте стабильный video_id, чтобы повторный запуск файла обновлял, а не дублировал данные.
• Включите Загрузку миниатюр для самостоятельного размещения изображений вместо горячей ссылки на источник.
• Переработка и перевод с помощью ИИ потребляют кредиты и требуют подключённого аккаунта tubepress.io; если ваш баланс слишком низок, задание останавливается с понятным сообщением.

Следующие шаги