A anotação de vídeo é como você cria dados de treinamento para coisas como reconhecimento de ações, rastreamento de objetos e detecção de eventos temporais. Este tutorial cobre a navegação por quadros, a segmentação de um clipe no tempo e como manter a rotulagem rápida. Para a referência completa do esquema de vídeo, consulte a documentação de origem.

O que a anotação de vídeo pode fazer

O Potato lida com vídeo tanto para tarefas de rotulagem quanto de classificação:

Classificação de vídeo: rotule clipes de vídeo inteiros
Marcação multirrótulo: aplique várias tags aos vídeos
Anotação temporal: marque eventos nos vídeos

Configuração Básica de Vídeo

yaml

annotation_task_name: "Video Action Recognition"
 
data_files:
  - "data/videos.json"
 
annotation_schemes:
  - annotation_type: video_annotation
    name: action
    description: "What action is shown in this video?"
    labels:
      - Walking
      - Running
      - Jumping
      - Sitting
      - Standing
      - Other

Navegação Quadro a Quadro

yaml

annotation_schemes:
  - annotation_type: video_annotation
    name: frame_label
    description: "Annotate video frames"
    labels:
      - Action
      - No action

Anotação de segmentos temporais

Marque eventos com um tempo de início e de fim:

yaml

annotation_task_name: "Video Event Detection"
 
data_files:
  - "data/videos.json"
 
annotation_schemes:
  - annotation_type: video_annotation
    name: events
    description: "Mark all events and their duration"
    labels:
      - name: conversation
        color: "#4ECDC4"
      - name: action_sequence
        color: "#FF6B6B"
      - name: transition
        color: "#45B7D1"
      - name: title_card
        color: "#FFEAA7"

Criando Segmentos

Navegue até o início de um evento
Pressione [ ou clique em "Mark Start"
Navegue até o fim do evento
Pressione ] ou clique em "Mark End"
Selecione o rótulo do evento
Repita para todos os eventos

Marcando momentos-chave

Marque momentos específicos dentro de um clipe:

yaml

annotation_schemes:
  - annotation_type: video_annotation
    name: key_moments
    description: "Mark important moments"
    labels:
      - name: action_start
        description: "When the action begins"
        color: "#22C55E"
      - name: action_peak
        description: "Most intense moment"
        color: "#EF4444"
      - name: action_end
        description: "When the action completes"
        color: "#3B82F6"

Classificação por vídeo

Classifique um vídeo inteiro com os tipos de anotação padrão:

yaml

annotation_schemes:
  - annotation_type: radio
    name: video_label
    description: "What is happening in this video?"
    labels:
      - Person visible
      - No person
      - Transition/blur

Vídeo com rótulos de categoria

Anote vídeos com rótulos de categoria:

yaml

annotation_schemes:
  - annotation_type: video_annotation
    name: video_labels
    description: "Label video content"
    labels:
      - name: person
        color: "#FF6B6B"
      - name: vehicle
        color: "#4ECDC4"
      - name: ball
        color: "#FFEAA7"

Uma configuração completa

yaml

annotation_task_name: "Sports Video Analysis"
 
data_files:
  - "data/sports_clips.json"
 
output_annotation_dir: "annotations/"
export_annotation_format: "jsonl"
 
annotation_schemes:
  # Game events
  - annotation_type: video_annotation
    name: game_events
    description: "Mark game events"
    labels:
      - name: goal
        color: "#22C55E"
      - name: foul
        color: "#EF4444"
      - name: corner_kick
        color: "#3B82F6"
      - name: free_kick
        color: "#F59E0B"
      - name: penalty
        color: "#EC4899"
      - name: offside
        color: "#8B5CF6"
 
  # Clip-level annotation
  - annotation_type: multiselect
    name: clip_tags
    description: "Tags for this clip"
    labels:
      - Highlight worthy
      - Good camera angle
      - Multiple players
      - Close-up
      - Wide shot
      - Slow motion available
 
annotation_guidelines:
  title: "Sports Video Annotation Guide"
  content: |
    ## Event Marking
    - Mark events from when they START
    - Include the full play sequence
    - Goal: From shot to ball crossing line
 
    ## Navigation
    - Space: Play/Pause
    - Arrow keys: Frame navigation

Formato de Saída

json

{
  "id": "clip_001",
  "video_path": "/videos/match_highlight.mp4",
  "annotations": {
    "game_events": ["goal", "corner_kick"],
    "clip_tags": ["Highlight worthy", "Good camera angle"]
  }
}

Dicas para anotação de vídeo

Visão geral na primeira passagem: assista primeiro em velocidade normal
Câmera lenta para precisão: use 0,25x para timestamps exatos
Atalhos de teclado: muito mais rápidos do que o mouse
Faça pausas: anotação de vídeo é visualmente exigente
Critérios consistentes: documente os casos limítrofes com clareza

Próximos Passos

Aprenda comparação de imagens para avaliação de qualidade de vídeo
Configure crowdsourcing para anotação de vídeo em larga escala

Documentação completa em /docs/features/image-annotation (seção de vídeo).