К содержимому
Документация
На этой странице

Экспорт видео

Редактор рендерит открытый уровень в видеофайл через ffmpeg, установленный на вашем компьютере. Рендер идёт офлайн, кадр за кадром, поэтому видео точное, как бы медленно ни работал компьютер

Экспорт работает на Windows, macOS и Linux. На телефонах его нет

Где найти

  • Экспорт видео в боковой колонке настроек уровня
  • команда Экспорт видео в палитре команд

Окно открывается поверх редактора. Пока видео рендерится, окно нельзя закрыть: рендер прерывает Остановить

Установка ffmpeg

ffmpeg не входит в игру. Установите его один раз, и окно найдёт его само. Нужна версия 7.0 или новее. Более старая отклоняется, и окно пишет, какую версию нашло

СистемаКоманда установки
Windowswinget install ffmpeg
macOSbrew install ffmpeg
Linuxпакет вашего дистрибутива, например sudo apt install ffmpeg
Предупреждение

Некоторые дистрибутивы Linux поставляют ffmpeg старше 7.0 (в Ubuntu 24.04 это 6.1). Тогда установите свежую сборку с сайта ffmpeg и укажите её окну вручную

Окно ищет ffmpeg в таком порядке:

  1. файл, выбранный через Указать ffmpeg.... Тогда больше нигде не ищется
  2. путь в переменной окружения BH_FFMPEG
  3. tools/ffmpeg в папке данных игры
  4. каждая папка из PATH
  5. папки, куда пишут обычные установщики

Искать автоматически забывает выбранный файл и ищет заново. Проверить снова повторяет проверку, например сразу после установки

В вашем ffmpeg могут быть аппаратные энкодеры (NVIDIA, AMD, Intel, Apple). Окно пробует каждый на десятой доле секунды чёрного кадра и использует только те, что реально работают на этом компьютере

Параметры окна

ПараметрЧто делает
Контейнер, Кодеквид файла и способ сжатия, см. форматы ниже
Разрешениеразмер видео. Ширина и высота - чётные числа от 16 до 7680
Частота кадровкадров в секунду в видео, до 240. Не зависит от частоты кадров самого уровня. Ниже 60 каждый кадр симулируется в несколько шагов, чтобы бот играл как в игре
Диапазонвесь уровень, диапазон цикла таймлайна или свои начальный и конечный кадры
Качествосколько места займёт видео. Скрыто для форматов, которые и так без потерь
Полный цвет (4:4:4)цвет для каждого пикселя, а не для каждого второго. Тонкие цветные линии чётче, файл больше
Сид (0 = как в редакторе)сид случайности уровня. 0 оставляет тот, что сейчас в редакторе
Пре-ролл, секундсколько секунд до начала проигрывается, но не записывается, чтобы у эффектов уже была история. По умолчанию 2, максимум 10
Кто играетпо умолчанию Reflex Bot v1, ещё Warm Bot v1 или Без бота для видео без аватара. Попадания во время экспорта ничего не делают
Постобработка, Эффектыте же переключатели, что в редакторе, только для видео
Звукдорожки уровня в видео

У каждого параметра в окне есть свой ?.

Интерфейс редактора, сетка, гизмо, выделение и границы камеры в видео никогда не попадают. Кадр строит камера уровня, а то, что не покрывает её соотношение сторон, заполняют чёрные полосы

Скорость рендера

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

Warm Bot v1 рассчитывает весь путь до первого кадра, и окно показывает, сколько уже готово. Если путь не найден, экспорт останавливается и просит выбрать другого бота

Форматы

Формат - это два выбора: Контейнер и Кодек. В списке только пары, которые умеет ваш ffmpeg. Строка под ними говорит, какой звук идёт в паре и какой файл получится

КонтейнерКодекЗвукДля чего подходит
MP4H.264, HEVC, AV1AAC, 320 кбит/сотправить и загрузить куда угодно
MKV (Matroska)H.264, HEVC, AV1, VP9, FFV1FLAC, без потерьархив, FFV1 вообще без потерь
MOV (QuickTime)H.264, HEVC, ProResPCM 16 бит, без сжатиямонтаж в Premiere, DaVinci Resolve, Final Cut
WebMVP9, AV1Opus, 256 кбит/свеб
GIF, WebP (анимация), APNG-без звукакороткие зацикленные клипы для чатов и страниц
Последовательность кадровPNG, JPEG, WebP, TIFFaudio.wav рядом с кадрамиимпортирует любой монтажный редактор
Только звукWAV, FLAC, MP3, Opusсам форматтолько звук уровня, ничего не рендерится

GIF берёт одну палитру из 256 цветов на весь клип. Делайте его коротким и небольшим: GIF всего уровня весит намного больше, чем MP4 того же уровня

Куда попадает видео

По умолчанию видео сохраняется в recordings/<id уровня>/ в папке данных игры, с именем уровня и временем экспорта. Открыть папку записей открывает эту папку. Выбрать... сохраняет следующее видео в любое другое место

Записи остаются, когда вы удаляете уровень. В перенос профиля они попадают, только если отметить Видеозаписи

Звук

Звук видео не записывается с динамиков, и во время экспорта вы ничего не слышите.

Если включён Звук через движок (с эффектами) (по умолчанию) и у дорожек есть эффекты, звук уровня проигрывается в реальном времени параллельно с рендером кадров и записывается звук самой игры вместе с эффектами. Экспорт длится не меньше длины диапазона: быстрый компьютер ждёт, пока доиграет звук. Если выключен, дорожки сводятся отдельно, с ключами громкости и панорамы, но без эффектов. Только звук всегда сводится отдельно

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

Предупреждение

Не закрывайте игру, пока рендерится видео. Окно напоминает об этом всё время записи

Чего нет в видео

  • эффектов на аудиодорожках, но только при выключенном Звук через движок (с эффектами) или в Только звук. Окно предупреждает, если они есть в уровне
  • прозрачного фона
  • записи того, как играли вы: в видео может играть только бот

Читайте дальше: Экспорт и защита, Аудио