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