Como funciona o ficheiro de download de vídeo (data.zip)

Neste artigo vais perceber a estrutura técnica do ficheiro de download de vídeo (data.zip) e como podes utilizar os conteúdos incluídos, seja através do ficheiro original ou reconstruindo o vídeo a partir dos segmentos.

Pré-requisitos

Antes de conseguires descarregar vídeos, é necessário garantir que:

• a funcionalidade de download está ativa na tua conta (deve ser solicitada ao suporte)
• a tua conta está ativa e em conformidade
• não existem pedidos pendentes de KYC/AML

Nota: Caso algum destes pontos não esteja cumprido, o download de vídeos pode não estar disponível.

Visão geral

Quando descarregas um vídeo, recebes um ficheiro data.zip que contém todos os dados necessários para reprodução e distribuição do conteúdo.

Este formato segue um modelo de streaming segmentado (HLS), onde o vídeo é dividido em vários ficheiros pequenos para otimizar entrega e compatibilidade.

Estrutura da pasta

Após descompactares o ficheiro data.zip, vais encontrar uma estrutura semelhante a esta:

• playlist.m3u8
• preview.gif / preview.webp
• thumbnail.jpg (e variações)
• pasta(s) de qualidade (ex: 720p, 1080p)
• (opcional) ficheiro original

Ficheiros principais

• playlist.m3u8
  • Ficheiro principal de playlist no formato HLS
  • Define como o vídeo deve ser reproduzido (qualidades disponíveis, segmentos, etc.)
• Thumbnails (thumbnail.jpg, etc.)
  • Imagens estáticas usadas como capa ou pré-visualização
• Previews (preview.gif, preview.webp)
  • Pequenas animações de preview do vídeo

Pastas de qualidade (ex: 720p)

Dentro de cada pasta de qualidade vais encontrar:

• video.m3u8
• múltiplos ficheiros .ts (ex: video0.ts, video1.ts, ...)

O que significam estes ficheiros

• video.m3u8
  • Playlist específica dessa qualidade
  • Lista todos os segmentos .ts na ordem correta
• Ficheiros .ts
  • Segmentos do vídeo (partes pequenas)
  • Cada ficheiro contém alguns segundos do vídeo

Este formato permite:

• streaming eficiente
• adaptação à qualidade de rede
• carregamento progressivo

Ficheiro original (quando disponível)

Em alguns casos existe um ficheiro com o nome:

• original (sem extensão)

Como utilizar

Podes simplesmente:

• adicionar a extensão .mp4 (ficando original.mp4)

Depois disso, o ficheiro pode ser aberto normalmente em qualquer leitor de vídeo.

Nota: Este é o ficheiro mais simples de usar, pois já está completo e não requer processamento adicional.

Como utilizar o vídeo

Tens duas opções principais:

Opção 1 - Usar o ficheiro original (recomendado)

Se existir o ficheiro original:

• adiciona a extensão .mp4
• usa diretamente o ficheiro

Vantagens:

• rápido e simples
• compatível com qualquer plataforma
• sem necessidade de conversão

---

Opção 2 - Reconstruir a partir dos ficheiros .ts

Se não existir ficheiro original, podes usar os segmentos .ts.

Método 1: Usar o ficheiro .m3u8

Alguns players (como VLC) permitem:

• abrir diretamente o ficheiro video.m3u8
• converter o video.m3u8 para um ficheiro de vídeo através das opções do player

Método 2: Converter para MP4

Podes usar ferramentas como FFmpeg:

• usar o ficheiro video.m3u8 como input
• gerar um ficheiro final .mp4

Notas importantes

• Os ficheiros .ts isoladamente não representam o vídeo completo
• O .m3u8 é essencial para manter a ordem correta dos segmentos
• A existência do ficheiro original depende do processamento do vídeo
• A estrutura segue padrões de streaming e não um ficheiro tradicional único

O que fazer se algo não funcionar

• Verifica se:
  • todos os ficheiros .ts estão presentes
  • o ficheiro .m3u8 não foi alterado
• Tenta abrir o .m3u8 num leitor compatível (ex: VLC)
• Se necessário:
  • usa ferramentas de conversão (ex: FFmpeg)
• Caso exista original, usa sempre essa opção primeiro