Pular para o conteúdo
Documentação
Nesta página

Exportação de vídeo

O editor renderiza o nível aberto em um arquivo de vídeo pelo ffmpeg do seu computador. A renderização é offline, um quadro por vez, por isso o vídeo sai exato por mais lenta que seja a máquina

A exportação funciona no Windows, macOS e Linux. Ela não está disponível em celulares

Onde encontrar

  • Exportar vídeo na coluna lateral das configurações do nível
  • o comando Exportar vídeo na paleta de comandos

A janela abre por cima do editor. Se foi aberta pelas configurações do nível, ela volta para elas ao fechar. Enquanto um vídeo renderiza, a janela não pode ser fechada: Parar encerra a renderização

Instalar o ffmpeg

O ffmpeg não faz parte do jogo. Instale-o uma vez, e a janela o encontra sozinha. É necessária a versão 7.0 ou mais nova. Uma mais antiga é recusada, e a janela informa a versão que encontrou

SistemaComando de instalação
Windowswinget install ffmpeg
macOSbrew install ffmpeg
Linuxo pacote da sua distribuição, por exemplo sudo apt install ffmpeg
Aviso

Algumas distribuições Linux trazem um ffmpeg mais antigo que 7.0 (o Ubuntu 24.04 traz o 6.1). Nesse caso, instale uma build mais nova do site do ffmpeg e indique-a na janela

A janela procura o ffmpeg nesta ordem:

  1. o arquivo que você escolheu com Escolher ffmpeg.... Então nada mais é procurado
  2. o caminho na variável de ambiente BH_FFMPEG
  3. tools/ffmpeg dentro da pasta de dados do jogo
  4. cada pasta em PATH
  5. as pastas em que os instaladores comuns gravam

Pesquisar automaticamente esquece o arquivo escolhido e procura de novo. Verificar de novo repete a verificação, por exemplo logo depois de instalar

O seu ffmpeg pode conter codificadores de hardware (NVIDIA, AMD, Intel, Apple). A janela testa cada um em um décimo de segundo de preto e usa só os que de fato funcionam neste computador

Opções da janela

OpçãoO que faz
Contêiner, Codeco tipo de arquivo e como ele é comprimido, veja os formatos abaixo
Resoluçãoo tamanho do vídeo. Largura e altura são números pares de 16 a 7680
Taxa de quadrosquadros por segundo do vídeo, até 240. Não depende da taxa de quadros do próprio nível. Abaixo de 60, cada quadro é simulado em vários passos, para que o bot jogue como joga no jogo
Trechoo nível inteiro, o trecho de loop da linha do tempo ou um quadro inicial e final seus
Qualidadequanto espaço o vídeo ocupa. Fica oculta nos formatos que já são sem perdas
Cor completa (4:4:4)cor para cada pixel em vez de um pixel sim, outro não. Linhas finas coloridas mais nítidas, um arquivo maior
Semente (0 = como no editor)a semente da aleatoriedade do nível. 0 mantém a semente que o editor está usando
Pre-roll, segundosquantos segundos antes do início são reproduzidos, mas não gravados, para que os efeitos já tenham o seu histórico. 2 por padrão, até 10
Quem jogaReflex Bot v1 por padrão, Warm Bot v1 ou Sem bot para um vídeo sem avatar. Os impactos não fazem nada durante uma exportação
Pós-processamento, Efeitosos mesmos interruptores do editor, só para o vídeo
Áudioas faixas do nível no vídeo

Cada opção tem o seu próprio ? na janela

A interface do editor, a grade, os gizmos, a seleção e os limites da câmera nunca entram no vídeo. A câmera do nível enquadra a imagem, e barras pretas preenchem o que a proporção dela não cobre

Velocidade de renderização

O vídeo não depende da velocidade do seu computador. O tempo do nível e o bot avançam exatamente um quadro do vídeo por quadro renderizado, por isso uma máquina lenta renderiza o mesmo vídeo, só que mais tarde

Warm Bot v1 calcula a rota inteira antes do primeiro quadro, e a janela mostra até onde ele chegou. Se ele não encontrar uma rota, a exportação para e pede outro bot

Formatos

Um formato são duas escolhas: Contêiner e Codec. Só aparecem os pares que o seu ffmpeg consegue gerar. A linha abaixo deles diz qual som acompanha o par e que arquivo você recebe

ContêinerCodecSomBom para
MP4H.264, HEVC, AV1AAC, 320 kbit/senviar e publicar em qualquer lugar
MKV (Matroska)H.264, HEVC, AV1, VP9, FFV1FLAC, sem perdasarquivamento, FFV1 sem nenhuma perda
MOV (QuickTime)H.264, HEVC, ProResPCM 16 bits, sem compressãoedição no Premiere, DaVinci Resolve, Final Cut
WebMVP9, AV1Opus, 256 kbit/sa web
GIF, WebP (animado), APNG-sem somclipes curtos em loop para chats e páginas
Sequência de imagensPNG, JPEG, WebP, TIFFaudio.wav ao lado dos quadrosqualquer editor importa
Só somWAV, FLAC, MP3, Opuso próprio formatosó o som do nível, nada é renderizado

O GIF usa uma única paleta de 256 cores para o clipe inteiro. Mantenha-o curto e pequeno: um GIF de um nível inteiro pesa muito mais que um MP4 do mesmo nível

Para onde o vídeo vai

Por padrão, o vídeo vai para recordings/<level id>/ na pasta de dados do jogo, com o nome do nível e a hora da exportação. Abrir pasta de gravações abre essa pasta. Escolher... salva o próximo vídeo em qualquer outro lugar

As gravações ficam quando você exclui o nível. Elas não fazem parte de uma transferência de perfil, a menos que você marque Gravações de vídeo

Som

O som do vídeo não é gravado dos alto-falantes, e você não ouve nada durante uma exportação

Com Som pelo motor (com efeitos) ativado (o padrão) e efeitos nas faixas, o som do nível toca em tempo real enquanto os quadros renderizam, e o próprio som do jogo é gravado, efeitos incluídos. A exportação dura pelo menos a duração do trecho: um computador rápido espera o som terminar. Desativado, as faixas são mixadas à parte, com os quadros-chave de volume e pan, mas sem os efeitos. Só som sempre mixa à parte

Abaixo da pré-visualização, a janela mostra duas linhas do tempo, Quadros e Som: elas andam de forma independente. Em um nível pesado, o som em paralelo pode engasgar. Nesse caso, ative Gravar o som depois dos quadros: o som é gravado depois do último quadro, e a exportação demora mais pela duração do trecho

Aviso

Não feche o jogo enquanto um vídeo renderiza. A janela avisa isso durante toda a execução

O que não entra no vídeo

  • os efeitos nas faixas de áudio, mas só com Som pelo motor (com efeitos) desativado ou em Só som. A janela avisa quando o nível tem esses efeitos
  • um fundo transparente
  • uma gravação de como você jogou: só o bot pode jogar no vídeo

Leia a seguir: Exportação e proteção, Áudio