Player, marca d'água, vinhetas e prévias

O TubePress reproduz vídeos enviados e baseados em URL com FluidPlayer, um player HTML5 auto-hospedado incluído em vendor/fluidplayer. Em torno dele existem vários recursos produzidos durante a transcodificação — marcas d'água, clipes de introdução e encerramento, e miniaturas de pré-visualização — além das pré-visualizações ao passar o mouse exibidas nos cards de listagem.

O comportamento do player é configurado em Aparência → Assistir; os recursos de marca d'água, introdução e linha do tempo ficam nas respectivas sub-abas de /admin/settings?tab=transcode porque são codificados no vídeo, não ativados/desativados durante a reprodução.

O player de vídeo

Para um vídeo enviado ou baseado em URL, o TubePress renderiza um elemento <video> com uma <source> por rendição e inicializa o FluidPlayer nele. Como cada rendição é listada como uma fonte separada rotulada com sua qualidade (e marcada como HD em 720p e acima), o player exibe um menu de qualidade integrado. A cor de destaque segue a cor primária do seu tema, e os controles se ocultam automaticamente durante a reprodução.

O pacote inclui módulos para streaming adaptativo (HLS e MPEG-DASH), WebVTT e reprodução em 360°/VR, podendo lidar com mais do que simples MP4 quando necessário. Vídeos que possuem um código de incorporação ignoram o FluidPlayer completamente e renderizam o iframe de origem.

Marcas d'água

Uma marca d'água é um logotipo sobreposto ao vídeo. No TubePress ela é codificada em cada rendição pelo FFmpeg durante a transcodificação em vez de ser desenhada pelo player — portanto não pode ser removida no lado do cliente, mas requer transcodificação e só aparece em vídeos processados após você habilitá-la. Configure-a na sub-aba Marca d'água:

Uma pré-visualização ao vivo no editor mostra aproximadamente como a sobreposição ficará, mas a marca final é aplicada pelo FFmpeg na próxima codificação.

Intros pre-roll

Você pode adicionar um clipe curto ao início de cada vídeo — uma intro pre-roll — e um encerramento post-roll, ambos na sub-aba Intros. Cada um é um upload MP4, armazenado em uploads/intros/. Como as marcas d'água, fazem parte da codificação: durante a transcodificação cada clipe é recodificado para corresponder exatamente à resolução, codec e bitrate de cada formato de saída e, em seguida, concatenado de forma perfeita, sem salto de qualidade no meio do stream.

Para clipes de anúncio que são reproduzidos dentro do player em vez de serem codificados no arquivo, use os pre/mid/post-rolls VAST do sistema de Anúncios.

Pré-visualizações da linha do tempo

As pré-visualizações da linha do tempo são as miniaturas que aparecem ao percorrer a barra de progresso. Na sub-aba Linha do tempo, habilitar Gerar capturas de tela da linha do tempo faz com que o transcodificador crie um sprite de frames mais um mapa timeline.vtt, que o FluidPlayer integra automaticamente à barra de busca quando estiver pronto.

O sprite é gerado como um job separado na fila, portanto as pré-visualizações podem aparecer logo após a publicação do próprio vídeo.

Pré-visualizações ao passar o mouse

Separado do player, os cards de listagem reproduzem um clipe de pré-visualização curto quando o visitante passa o mouse sobre eles — um preview.mp4 real por vídeo, não o sprite da linha do tempo. Isso é controlado pela configuração de hover do card nas opções de aparência do seu tema e oferece aos visitantes uma prévia rápida de cada vídeo sem abrir a página de exibição.

Configurações do player

Abra Aparência → Assistir para controlar o player. Essas opções se aplicam apenas a vídeos enviados e baseados em URL, não a incorporações.

A mesma tela alterna quais metadados aparecem ao redor do player — visualizações, duração, data de publicação, curtir/não curtir e o botão de favoritos, além das seções de atores pornô, canais, categorias e tags — e define quantos vídeos relacionados (2–20) são exibidos na barra lateral.

Próximos passos