<!-- Source: https://9pic.ai/pt-br/blog/clip-event-videos-from-csv-timestamps/ -->
![Fundo abstrato com listras](/images/stripes.svg)

[Voltar ao blog](/pt-br/blog/)

![Como criar clipes de vídeos de eventos a partir de um CSV: uma linha por clipe com número de peito, vídeo, início e fim](https://bgimg.9pic.ai/images/blog/clip-event-videos-from-csv-timestamps.jpg?title=Como+criar+clipes+de+v%C3%ADdeos+de+eventos+a+partir+de+um+CSV+de+n%C3%BAmeros+de+peito+e+tempos&amp;subtitle=Uma+linha+por+clipe%3A+n%C3%BAmero+de+peito%2C+v%C3%ADdeo%2C+in%C3%ADcio+e+fim.+O+Motion+corta+exatamente+o+que+voc%C3%AA+lista.&amp;kicker=Guia+do+Motion&amp;author=Equipe+9Pic+AI&amp;readTime=8+min&amp;lang=pt-BR)

**Em resumo**: no Motion, vá em **Configuration**, ative **Bib Number Search** e salve. Selecione **Download template**, preencha uma linha por clipe com `bib_number`, `video_source`, `start_time` e `end_time`, e depois use **Upload CSV**. Os tempos são posições dentro do arquivo de vídeo, não o horário do dia. Escolha **Prepare ahead** se quiser os clipes prontos assim que as pessoas buscarem.

Quando um CSV é a ferramenta certa
-----------------------------------

O Motion consegue encontrar pessoas por selfie e ler números de peito nas gravações. Um CSV é diferente: você diz ao Motion exatamente onde está cada clipe. É a melhor escolha quando:

- **A programação já diz quem aparece na câmera.** A ordem de entrada de uma competição de hipismo, as baterias e raias da natação, a ordem de apresentação na dança ou na ginástica, as etapas de tiro.
- **Rostos e números são difíceis de ver.** Capacetes, câmeras laterais, cavaleiros do outro lado da pista, números na manta da sela.
- **Você quer cortes exatos.** Um percurso ou uma série inteira, do começo ao fim, em vez de alguns segundos em torno de uma aparição.
- **Você quer preencher lacunas.** Um corredor que a leitura automática de números não pegou ainda pode receber um clipe com uma linha do CSV.


Vídeos usados só para clipes do CSV não precisam de leitura de rostos nem de números. O Motion prepara esses vídeos só para o recorte.

Passo 1: Ative Clips from your CSV
----------------------------------

Abra o evento, vá em **Motion**, depois em **Configuration** e **Search methods**. Ative **Bib Number Search**. Isso também ativa **Clips from your CSV**. Selecione **Save changes**.

Um painel de envio aparece logo abaixo da chave, com **Download template** e **Upload CSV**. Você pode enviar antes de salvar, mas os participantes só recebem os clipes depois que a chave estiver salva.

Passo 2: Preencha as colunas
----------------------------

Selecione **Download template**. O modelo tem uma linha por vídeo importado, já preenchida com o ID desse vídeo. Copie linhas conforme precisar e preencha. A primeira linha traz os nomes das colunas:

| Coluna | O que vai nela |
| --- | --- |
| `bib_number` | O número que o atleta vai digitar. Letras, dígitos, espaços, `/` e `-`, até 32 caracteres. |
| `video_source` | O ID do vídeo no modelo. O nome exato do arquivo também funciona quando só um vídeo tem esse nome. |
| `start_time` | Onde o clipe começa nesse vídeo. |
| `end_time` | Onde ele termina. Precisa ser depois do início, no máximo 10 minutos depois, e não pode passar do fim do vídeo. |
| `label` | Opcional. Uma anotação para você, como "Chegada" ou "Percurso 2". |

Um pequeno exemplo:

    bib_number,video_source,start_time,end_time,label
    1042,finish-cam-1.mp4,00:41:05,00:41:20,Finish
    A17,arena-north.mov,01:12:30,01:14:10,Round 1
    A17,arena-north.mov,02:03:00,02:04:35,Jump-off

O número A17 tem duas linhas, então quem digitar A17 recebe dois clipes. Os números são comparados sem diferenciar maiúsculas de minúsculas, mas zeros à esquerda contam: `0123` e `123` são números diferentes.

Passo 3: Escreva os tempos do jeito que o Motion lê
----------------------------------------------------

Um tempo é uma **posição no arquivo de vídeo**: quanto tempo depois do início da gravação o momento acontece. Não é o horário do dia. O Motion aceita:

- `00:01:02`: horas, minutos e segundos
- `01:02`: minutos e segundos
- `62` ou `62.5`: segundos


Datas, AM/PM e fusos horários são rejeitados. Uma armadilha das planilhas: o Excel e o Planilhas Google podem transformar `01:02` em um horário. Formate as duas colunas de tempo como texto simples antes de digitar ou colar.

Os clipes do CSV usam os seus tempos exatamente. O Motion não adiciona margem, e a configuração de duração do clipe não os altera. Se você quer um ou dois segundos antes de o atleta aparecer, inclua isso no tempo de início.

Como transformar tempos de chip ou horários em posições
----------------------------------------------------------

O Motion não se conecta a sistemas de cronometragem. Mas, se você tem horários do dia, vindos da cronometragem por chip, de um sistema de pontuação ou das anotações de alguém, uma planilha pode convertê-los:

1. Descubra o horário do dia em que a gravação começou. Filmar um relógio, ou o relógio da prova, no início de cada gravação torna isso fácil e confiável.
2. Para cada atleta, subtraia o início da gravação do horário dele. O resultado é a posição no arquivo.
3. Tire alguns segundos do início e some alguns ao fim, para que o clipe cubra a aproximação e o próprio momento.
4. Escreva os resultados como texto no formato `hh:mm:ss`.


Por exemplo, uma câmera começou a gravar às 08:12:40 e um corredor passou pelo tapete de cronometragem às 08:53:50. A passagem está a 41 minutos e 10 segundos do início do arquivo, então um clipe de `00:41:05` a `00:41:20` cobre esse momento.

Os relógios das câmeras e os da cronometragem raramente coincidem no segundo, e o tapete pode ficar um pouco antes ou depois do campo de visão da câmera. Confira alguns clipes depois do primeiro envio e desloque a coluna inteira se eles começarem cedo ou tarde demais.

Passo 4: Confira o arquivo e importe
------------------------------------

Selecione **Upload CSV** e escolha o arquivo (até 5 MB e 50.000 linhas). Se o evento já tem clipes, escolha **Replace all clips** ou **Add to current clips**.

**Check file** não salva nada. Ele mostra quantas linhas estão prontas, as linhas com problemas, as duplicatas que serão ignoradas e os avisos. A tabela **Rows to check** indica cada problema com o número da linha como aparece na sua planilha, para você corrigir rápido. Avisos, como duas linhas sobrepostas para o mesmo número, não bloqueiam a importação.

Quando estiver tudo certo, selecione **Import N clips** (ou **Replace with N clips**). Só as linhas prontas são salvas. Um evento pode ter até 50.000 clipes de CSV.

Passo 5: Escolha quando os clipes são criados
----------------------------------------------

Na seção **Clips from your CSV**, **How participants get these clips** tem duas opções e o seu próprio botão Save:

- **Cut when searched** (padrão): o clipe é criado na primeira vez que alguém busca aquele número. A primeira busca leva cerca de um minuto, e a página se atualiza sozinha.
- **Prepare ahead**: o Motion cria cada clipe em segundo plano, para que ele apareça na hora. Os clipes são preparados a cerca de um a cada 2 segundos, então alguns milhares de linhas levam algumas horas. Defina **Keep prepared clips for** entre 30 e 365 dias.


Com Prepare ahead, uma barra de progresso mostra quantos clipes estão prontos, e cada linha recebe um status: Ready, Preparing, Waiting, Failed, Needs update ou Expired. Se você mudar a marca d'água ou as configurações de venda de clipes, os clipes são marcados como **Needs update**, e **Update clips** cria os clipes de novo. Até lá, os participantes continuam recebendo os clipes, cortados na hora da busca.

Use Prepare ahead quando muita gente for buscar ao mesmo tempo, por exemplo logo depois de uma prova grande ou assim que os resultados saem.

Como corrigir erros
-------------------

- **Remove last import** apaga só os clipes do seu envio mais recente.
- **Delete all clips** apaga todos os clipes do CSV depois que você confirma.
- Não dá para apagar uma única linha. Corrija a linha no seu arquivo e envie de novo com **Replace all clips**.
- Se você enviar um vídeo de novo, os clipes antigos dele são marcados como "(replaced)" e deixam de ser entregues. Envie um CSV com o ID do vídeo novo.


Como usar um CSV com os números automáticos
---------------------------------------------

Você também pode ativar **Find bibs automatically**. Em cada vídeo, as linhas do CSV de um número têm prioridade sobre os números que o Motion encontrou ali, e os números encontrados automaticamente completam os vídeos que o seu CSV não cobre. Isso faz do CSV uma boa forma de corrigir ou completar os resultados automáticos. Veja [como encontrar números de peito em vídeos de corrida](/pt-br/blog/find-bib-numbers-in-race-video/).

O que os participantes veem
---------------------------

Na galeria, eles escolhem **Clipes de vídeo**, digitam o número de peito e selecionam **Encontrar Vídeos**. Recebem um clipe por linha do CSV daquele número, até 20. Se você vende clipes, eles veem uma prévia com marca d'água e podem comprar a versão limpa. Todos que buscam o mesmo número recebem os mesmos clipes.

Perguntas frequentes
--------------------

### Ainda preciso processar os vídeos?

Sim. Importe e processe os vídeos no Motion para que possam ser cortados. Com apenas os clipes do CSV ativados, o Motion pula a leitura de rostos e de números.

### Um número pode ter clipes de várias câmeras?

Sim. Adicione uma linha por vídeo. Cada linha é um clipe.

### Posso usar o mesmo CSV em um percurso com voltas?

Sim. Adicione uma linha para cada volta. Os clipes do CSV não ficam limitados a um por vídeo.

### Qual é o clipe mais longo que uma linha pode gerar?

10 minutos, o que cobre a maioria dos percursos, séries e etapas.

O que fazer agora
-----------------

Baixe o modelo, preencha cinco linhas de atletas que você consegue conferir e envie antes de fazer a lista completa. Para o resto da configuração, siga [como configurar clipes de vídeo de corrida](/pt-br/products/motion/#how). Para eventos em pista, veja [clipes de cavaleiros a partir de vídeos longos de competições de hipismo](/pt-br/blog/rider-video-clips-from-long-video-9pic-motion/). Todas as opções do Motion estão na página do [9Pic Motion](/pt-br/products/motion/).

Pronto para começar?
---------------------

Junte-se aos organizadores de eventos que já entregaram 100M+ fotos a 5M+ participantes em 5k+ eventos com a 9Pic AI para hospedagem, busca com IA e entrega de mídia.

[Começar](https://admin.9pic.ai/sign-up) [Agendar demo](/pt-br/contact/)
