Documentação ComusThumbz
Login de Admin

Configuração do Processador de Vídeo

O que esta página faz

Esta página é seu centro de controle para como os vídeos são processados e exibidos em seu site. Você pode controlar a qualidade do vídeo, criar miniaturas, adicionar marcas d'água, configurar publicidade e personalizar a experiência do jogador de vídeo. Pense nisso como a página de configurações que determina tudo sobre como os vídeos parecem e funcionam para seus visitantes.

[Screenshot: page-overview]


Como chegar aqui

Navegar para Painel de administração > Vídeos > Configurações do Processador


Compreender a Página

Quando você abrir esta página pela primeira vez, você verá um painel de status no topo mostrando quantos vídeos estão sendo processados atualmente, quantos estão esperando na fila e se houver algum problema. Abaixo disso, você encontrará cinco abas que organizam todas as configurações.

Painel de Estado

No topo da página, você verá quatro caixas mostrando:

  • Estado do Processador - Se o processador de vídeo está em execução ou ocioso
  • Trabalhos Activos - Vídeos actualmente a ser processados agora
  • Tarefas pendentes - Vídeos à espera de serem processados
  • Tarefas Falhadas - Vídeos que tiveram erros nas últimas 24 horas

As Cinco Páginas

A página está organizada em cinco seções principais:

  1. Configuração do Processamento - Controla a qualidade de vídeo, miniaturas e como os vídeos são convertidos
  2. Pré- Rolar e Pós- Rolar - Vídeos que reproduzem antes ou depois do seu conteúdo
  3. Sobreposição de Vídeo - Marcas de água que são permanentemente adicionadas aos seus vídeos
  4. Reprodutor de Vídeo - Como o leitor de vídeo olha e funciona no seu site
  5. Anúncios do Leitor de Vídeo - Configurações e opções de publicidade

Tarefas comuns

Como ajustar configurações de qualidade de vídeo

As configurações de qualidade determinam como seus vídeos parecem e quanto armazenamento eles usam.

  1. Clique na Configuração do Processamento tab no topo.
  2. Role para baixo para encontrar Configuração da Conversão de Vídeo.
  3. Ajuste o Taxa de bits de vídeo máxima - números mais elevados significam melhor qualidade, mas arquivos maiores (5000 é um bom equilíbrio).
  4. Definir Taxa de bits de áudio máxima - 192 é geralmente perfeito para a maioria dos vídeos.
  5. Role para o fundo e clique Salvar configurações.
  6. Clique Sim. quando solicitado para confirmar.
Dica: Taxas de bits mais altas criam vídeos mais bonitos, mas usam mais espaço de armazenamento e largura de banda. Comece com os valores padrão e só aumente se os vídeos parecerem embaçados.

Como habilitar o Streaming Adaptativo de Alta Qualidade

A transmissão adaptativa ajusta automaticamente a qualidade do vídeo com base na velocidade da internet do seu espectador.

  1. Ir para o Configuração do Processamento tab.
  2. Rolar para baixo para Configurações de Streaming Adaptativo HLS.
  3. Assinale a caixa ao lado de Activar o Streaming Adaptativo HLS.
  4. Definir Altura mínima da fonte para 720 (isso só permite streaming para vídeos em HD).
  5. Na Resoluções HLS Ativas box, digite quais qualidades você deseja: tipo hd,high,medium,low para todas as opções.
  6. Clique Salvar configurações no fundo.
Aviso: O streaming adaptativo cria várias cópias de cada vídeo com diferentes qualidades. Isso pode usar 3-4 vezes mais espaço de armazenamento do que um único arquivo de vídeo.

Como configurar a geração de miniaturas

As miniaturas são as imagens de visualização que os visitantes veem ao navegar em vídeos.

  1. Abra o Configuração do Processamento tab.
  2. Encontrar o Configuração da Geração de Miniaturas secção.
  3. Definir Contagem de Miniaturas para quantas imagens de visualização você quer por vídeo (5-10 é bom).
  4. Ajustar Largura da Miniatura e Altura da Miniatura se necessário (320x180 trabalha para a maioria dos locais).
  5. Definir Largura do Poster e Altura do Poster - esta é a imagem de visualização principal (1280x720 é HD padrão).
  6. Verificar Activar a Antevisão Animada para criar pré-visualizações GIF.
  7. Verificar Gerar imagens de vídeo para activar a antevisão da linha do tempo ao passar.
  8. Clique Salvar configurações.
Dica: Visualizações de GIF animados e imagens de vídeo ajudam os visitantes a ver o que há em um vídeo antes de clicar. Eles aumentam o uso de armazenamento ligeiramente, mas melhorar muito a experiência de navegação.

Como escolher formatos de arquivo de miniaturas

Você pode gerar miniaturas em formato JPG, formato WebP moderno ou ambos.

  1. Na Configuração do Processamento tab, rolagem para Configuração do Formato da Imagem em Miniatura.
  2. Na Formatos das Miniaturas caixa, tipo um destes:
  • Tipo jpg para compatibilidade universal
  • Tipo webp para tamanhos de arquivos menores
  • Tipo both para gerar ambos os formatos
  1. Clique Salvar configurações.
Nota: As imagens WebP são cerca de 30% menores que o JPG, mas funcionam em todos os navegadores modernos. Escolher "ambos" permite que navegadores mais novos usem WebP enquanto navegadores mais antigos recebem JPG.

Como Configurar as Visualizações GIF Animadas

GIFs animados dão aos visitantes uma visualização rápida ao passarem sobre miniaturas.

  1. Ir para o Configuração do Processamento tab.
  2. Rolar para Configuração do GIF Animado.
  3. Definir Duração do GIF animado para quanto tempo a pré-visualização deve ser (3-5 segundos funciona bem).
  4. Para uma visualização que mostra clipes de todo o vídeo:
  • Verificar Usar GIF Segmentado Animado
  • Definir Segmentos GIF animados a 3-5
  • Definir Deslocamento inicial do GIF animado para pular as seções de introdução (10 segundos é típico)
  1. Clique Salvar configurações.
Nota: O modo contínuo cria um clipe suave. Modo segmentado leva clipes curtos de diferentes partes do vídeo e combina-los, dando aos espectadores uma melhor visão geral de todo o vídeo.

Como adicionar um vídeo que reproduz antes de seu conteúdo

Os vídeos pré-rolagem reproduzem antes de cada vídeo no seu site - perfeito para apresentações, avisos ou anúncios.

  1. Clique na Pré- Rolar e Pós- Rolar tab.
  2. Embaixo Enviar Novo Vídeo Pré- Rolo, clique Escolher arquivo.
  3. Selecione um vídeo MP4 de seu computador.
  4. Sair Activar imediatamente Verifique se você quer que ele comece a trabalhar imediatamente.
  5. Clique Enviar o Vídeo Pré- Rolado.

O pré-roll agora aparecerá no início de todos os vídeos recém-processados. Vídeos que já foram processados não mudarão.

Dica: Mantenha vídeos pré-roll curtos (5-15 segundos). Intros mais longas podem frustrar espectadores e aumentar as taxas de abandono.

Como remover vídeos pré-rolo ou pós-rolo

  1. Ir para o Pré- Rolar e Pós- Rolar tab.
  2. Encontrar o vídeo que deseja remover em Vídeo Pré- Rolo Actual ou Vídeo Post- Roll atual.
  3. Clique na Apagar Botão.
  4. Clique Sim, Apagar para confirmar.

Novos vídeos não incluirão mais o pré-roll ou pós-roll. Os vídeos existentes mantêm-no até serem reprocessados.

Como adicionar uma marca d'água a todos os vídeos

Sobreposições de vídeo são marcas de água que são adicionados permanentemente aos seus vídeos durante o processamento.

  1. Ir para o Sobreposição de Vídeo tab.
  2. Escolha se deseja adicionar uma imagem ou marca d'água de texto.
  3. Para uma marca d'água de texto:
  • Digite um nome em Nome da Sobreposição (como "Notificação de Copyright")
  • Escolher um Posição do dropdown (baixo-direita é comum)
  • Digite o texto da marca d'água Conteúdo do Texto
  • Escolher um Cor da Fonte (branco funciona na maioria dos vídeos)
  • Ajustar Tamanho da Fonte (18-24 é legível, mas não intrusivo)
  • Verificar Activar a Sombra de Texto para tornar mais fácil de ler
  • Definir Opacidade para 0,5-0,8 (números mais baixos torná-lo mais transparente)
  1. Para uma marca d'água de imagem:
  • Digite um nome em Nome da Sobreposição (como "Logo Watermark")
  • Clique Escolher arquivo abaixo Enviar imagem e selecione um arquivo PNG
  • Escolher um Posição a partir da gota
  • Definir Opacidade a 0, 5- 0, 8
  1. Sair Activar imediatamente Verificado.
  2. Clique Criar Sobreposição.
Aviso: Marcas d'água são permanentemente queimadas em vídeos durante o processamento. Eles não podem ser removidos mais tarde sem reprocessamento do vídeo inteiro.

Como adicionar marca de jogador

A marca do player é diferente das sobreposições de vídeo - é um logotipo ou texto que aparece em cima do player de vídeo, não gravado no arquivo de vídeo.

  1. Clique na Reprodutor de Vídeo tab.
  2. Rolar para baixo para Marca de água de vídeo / Branding.
  3. Verificar Activar a Marca de Água.
  4. Escolher Texto ou Imagem Da largada.
  5. Para marcação de texto:
  • Digite sua marca em Texto da Marca de Água
  • Escolher um Cor do Texto
  • Selecionar um Família de fontes
  • Ajustar Tamanho da Fonte (14-20 funciona bem)
  1. Para marca de imagem:
  • Digite seu URL de logotipo URL da imagem (deve ser um ficheiro PNG com transparência)
  1. Escolha onde aparece usando o Posição Largar.
  2. Definir Opacidade (0,3-0,5 é sutil, mas visível).
  3. Verificar Desvanecer em Hover para torná-lo menos intrusivo.
  4. Clique Gravar a Configuração da Marca de Água.

Como limitar quantos vídeos os usuários podem assistir

Você pode definir limites diários e mensais para incentivar os usuários a se registrar ou atualizar.

  1. Ir para o Reprodutor de Vídeo tab.
  2. Rolar para baixo para Limites de visualização de vídeo e controle de acesso.
  3. Definir limites para usuários livres:
  • Limite diário gratuito - quantos vídeos por dia (tentar 5)
  • Limite Mensal Livre - quantos vídeos por mês (tentar 50)
  1. Fixar limites para os membros do prémio:
  • Limite Diário Premium - Tenta 20.
  • Limite Mensal Premium - Tenta 200.
  1. Clique Salvar limites de visão.
Dica: Definir um limite para 0 para acesso ilimitado. Usuários VIP, moderadores e administradores sempre têm acesso ilimitado, não importa o que você definir aqui.

Como personalizar a mensagem de atualização

Quando os usuários atingem o limite de visualização, eles veem uma mensagem popup. Você pode personalizar o que ele diz e como ele parece.

  1. In the Video Player tab, scroll to Upgrade Prompt Customization.
  2. For free users, edit:
  • Title - the heading (like "Daily Limit Reached")
  • Message - the body text (you can use {views_used} and {limit} to show numbers)
  • Background Color - the popup color (you can use gradients)
  1. Do the same for premium users.
  2. Customize the buttons:
  • Register Button - for free users to create an account
  • VIP Button - to upgrade to premium
  • Set the text, colors, and URLs for each button
  1. Click Save Customization.

How to Change the Video Player Sidebar

The sidebar shows related videos next to the player. You can control what it looks like.

  1. Go to the Video Player tab.
  2. Scroll to Playlist & Sidebar UI Customization.
  3. Adjust thumbnail sizes:
  • Thumbnail Width - try 120 pixels
  • Thumbnail Height - try 68 pixels
  1. Choose colors:
  • Background Color - the sidebar background
  • Item Hover Color - what happens when you hover
  • Selected Gradient Start/End - the currently playing video
  1. Customize the duration badges (the time labels on thumbnails).
  2. Adjust the scrollbar colors to match your site.
  3. Set Sidebar Width (300-400 pixels works well).
  4. Click Save Playlist UI Settings.

How to Set Up Video Advertising

You can show video ads before, during, or after your videos.

  1. Click the Video Player Ads tab.
  2. Check Enable Video Ads at the top.
  3. Enter your VAST Tag URL - you get this from your advertising provider.
  4. Under Ad Placement, check which types of ads you want:
  • Enable Pre-Roll - ads before the video starts
  • Enable Mid-Roll - ads during the video
  • Enable Post-Roll - ads after the video ends
  1. If you enabled mid-roll, set when it appears:
  • Use Mid-Roll Time to show it at a specific second
  • Or use Mid-Roll Percentage to show it at 25%, 50%, etc.
  1. Set Skip Button Delay to how many seconds before viewers can skip (5 is standard).
  2. Click Save Ad Settings.
Tip: Start with pre-roll ads only. Adding too many ads (especially mid-roll) can frustrate viewers and reduce watch time.

How to Test Your Video Processing Settings

After changing settings, it's important to test that everything works.

  1. Upload a test video through Admin Panel > Videos > Upload Video.
  2. Wait for it to process (check the status dashboard at the top of this page).
  3. Once it shows "Active Jobs: 0", go view the video on your site.
  4. Check that:
  • Thumbnails generated correctly
  • Video plays smoothly
  • Quality options appear (if you enabled adaptive streaming)
  • Watermarks appear in the correct position
  • Any ads or overlays work as expected
  1. If something doesn't work, return to this page and adjust the settings.

Understanding Player Features

The Video Player tab includes a section called Player Features & Mode Configuration. This lets you turn features on or off separately for the public site (Frontend) and the admin panel (Backend).

Feature What It Does
Playlist Sidebar Shows related videos next to the player
Autoplay Next Automatically plays the next video when one ends
Video Watermark Displays your branding overlay on the player
Player Overlays Shows messages and calls-to-action during playback
Video Ads Enables advertising
Quality Selector Lets viewers switch between HD, medium, and low quality
Playback Speed Lets viewers watch at 0.5x, 1x, 1.5x, 2x speed
Picture-in-Picture Allows the video to float in a small window
Fullscreen Shows the fullscreen button
Download Button Lets users download the video file
Note: Most of these features only work with videos hosted on your own server or CDN. Videos embedded from other sites (like YouTube or Vimeo) can't use these features.

Tips for New Users

Tip:
  • Start simple: Don't enable every feature right away. Start with basic thumbnail generation and video quality, then add features as you need them.
  • Test with short videos first: Use a 30-second test video to verify your settings work before processing a library of long videos.
  • Monitor storage: Adaptive streaming and multiple thumbnail formats use more storage. Keep an eye on your server disk space.
  • Use pre-roll sparingly: Long pre-roll videos annoy users. Keep them under 10 seconds or let users skip them.
  • Watermark placement matters: Bottom-right is least intrusive. Avoid center placement which blocks the action.
  • Set view limits gradually: Start generous (10-20 per day) and adjust based on user behavior.

Troubleshooting

Videos aren't being processed

What you see: You upload a video but it stays stuck with "Pending" status forever.

How to fix it:

  1. Check the status dashboard at the top of this page. If it says "Idle" or shows 0 active jobs, the processor might not be running.
  2. Contact your hosting provider or server administrator - they need to enable the video processing system.
  3. If "Failed Jobs" is increasing, there's a problem with the processing settings. Try reducing quality settings or disabling HLS.

 

Thumbnails aren't showing up

What you see: Videos process successfully but have no thumbnail images.

How to fix it:

  1. Go to the Processing Settings tab and scroll to Thumbnail Generation Settings.
  2. Make sure Thumbnail Count is set to at least 5 (not 0).
  3. Check that Enable Animated Preview and Generate Video Sprites are checked if you want those features.
  4. Click Save Settings and try uploading a new test video.

 

Video quality is poor or blurry

What you see: Processed videos look worse than the original files you uploaded.

How to fix it:

  1. Open the Processing Settings tab.
  2. Scroll to Video Conversion Settings.
  3. Increase Max Video Bitrate to 8000 or 10000.
  4. Scroll to MP4 Encoding Settings.
  5. Change MP4 CRF Quality to 20 or 21 (lower numbers = better quality).
  6. Click Save Settings.

 

Existing videos won't improve - only newly uploaded videos will use the new settings.

Watermarks aren't appearing on videos

What you see: You created a watermark but it doesn't show up on videos.

How to fix it:

  1. Go to the Video Overlays tab.
  2. Find your watermark in the list at the bottom.
  3. Check if the Status says "Active" - if it says "Inactive", click Activate.
  4. Note that watermarks only appear on newly processed videos. Old videos won't have the watermark unless you reprocess them.

 

Player branding isn't showing

What you see: You set up player branding but don't see it when watching videos.

How to fix it:

  1. Go to the Video Player tab.
  2. Scroll to Video Watermark / Branding.
  3. Make sure Enable Watermark is checked.
  4. Scroll up to Player Features & Mode Configuration.
  5. Find Video Watermark in the features list and make sure the Frontend checkbox is checked.
  6. Click Save Feature Settings.

 

Video ads aren't playing

What you see: You configured ads but they don't appear before videos.

How to fix it:

  1. Click the Video Player Ads tab.
  2. Verify Enable Video Ads is checked at the top.
  3. Make sure you've entered a VAST Tag URL from your ad provider.
  4. Check that Enable Pre-Roll is selected under Ad Placement.
  5. Try using one of the test VAST tags shown at the bottom of the page to verify the system works.
  6. Remember: ads only work with videos hosted on your server, not embedded videos from other sites.

 

View limits aren't working

What you see: Users can watch unlimited videos even though you set limits.

How to fix it:

  1. Go to the Video Player tab and scroll to Video View Limits & Access Control.
  2. Make sure the limits aren't set to 0 (zero means unlimited).
  3. If you see a message about a missing database table, you may need to contact your developer or hosting provider to enable this feature.
  4. Remember: VIP users, moderators, and admins can always watch unlimited videos regardless of these settings.

 

Upload buttons don't work

What you see: When you try to upload a pre-roll video, font, or watermark image, nothing happens.

How to fix it:

  1. Check if there's a banner at the top of the page that says "Demo Mode" - if so, uploads are disabled to prevent changes.
  2. Make sure your file is the correct type:

 

  • Pre/post-roll: must be MP4, MOV, AVI, or WebM
  • Watermark images: must be PNG or GIF
  • Fonts: must be TTF or OTF

 

  1. Try a smaller file if yours is very large.

 

Adaptive streaming isn't working

What you see: You enabled HLS adaptive streaming but videos don't offer quality selection.

How to fix it:

  1. Go to Processing Settings and find HLS Adaptive Streaming Settings.
  2. Check that Enable HLS Adaptive Streaming is turned on.
  3. Look at Minimum Source Height - if this is set to 1080, only Full HD videos will get adaptive streaming. Lower it to 720 to include HD videos.
  4. Make sure Active HLS Resolutions contains at least two qualities, like high,medium.
  5. Try uploading a new HD video (at least 720p or 1080p) to test.

 


Page When to Use It
Video Upload To upload new videos that will be processed with these settings
Video Management To view the status of videos being processed and manage your video library
Conversion Servers If you need to set up multiple servers to process videos faster
Storage Servers To configure where processed videos, thumbnails, and previews are stored

This guide was created to help you use your video processor settings without needing technical knowledge. If you encounter problems not covered here, contact your site administrator or support team.