> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/pt-br/secao-02-usando-o-velogic-studio/troubleshooting-marker-detection.md).

# Solução de problemas de detecção de marcadores

O Velogic Studio deve estar exibindo um wireframe/esqueleto consistente:

{% embed url="<https://ik.imagekit.io/vfframes/docs/George%20skeleton_D-74O6nry.mp4>" %}

e os Indicadores de Qualidade devem estar mostrando "Bom" para a detecção:

![Indicadores de qualidade mostrando status de detecção Bom para o reconhecimento correto dos marcadores](/files/b78f7a2f8d8aee5f5f741b83965c852072fed215)

Se não estiver vendo isso, esta página ajudará você a diagnosticar o problema.

> **Problema conhecido:** alguns rolos de fita de marcadores produzidos no início de 2026 não são totalmente retrorrefletivos, o que faz com que os marcadores desapareçam quando não estão de frente para a câmera. Se um marcador continuar desaparecendo mesmo estando corretamente posicionado, consulte [Problema de refletividade dos marcadores](/pt-br/secao-02-usando-o-velogic-studio/marker-reflectivity-issue.md).

## Procure por pontos vermelhos — há algum extra? Falta algum?

Se o Velogic Studio não conseguir encontrar um esqueleto válido a partir de 7 (ou 8) pontos, ele mostrará pontos vermelhos para os marcadores que conseguiu encontrar.

![Pontos vermelhos exibidos quando o Velogic Studio não consegue formar um esqueleto válido a partir dos marcadores detectados](/files/5b9e602c89892afa4b482df4f039b33bc02b255f)

Você pode observar enquanto o ciclista pedala e ver se um dos marcadores às vezes não aparece como ponto vermelho. Se notar isso, ajuste o marcador problemático para que a câmera consiga vê-lo melhor.

Se você vir pontos vermelhos adicionais na cena (como reflexos no aro da roda dianteira), talvez seja necessário ocultá-los, por exemplo, cobrindo com fita crepe. Observe que o Velogic Studio consegue lidar com alguns reflexos adicionais, especialmente se estiverem longe de uma posição válida de marcador; mas, se houver muitos reflexos adicionais ou se estiverem perto de uma posição válida de marcador, será necessário cobri-los.

## Verifique a colocação dos marcadores

Consulte nossa [documentação sobre a colocação dos marcadores](/pt-br/secao-02-usando-o-velogic-studio/joint-marker-placement.md). Os marcadores precisam ser colocados onde a câmera possa vê-los diretamente. Problemas comuns são:

* Marcador do ombro posicionado muito alto
* Marcador do pulso girado demais para longe da câmera
* Marcador do calcanhar (se usado) muito baixo no sapato

## Verifique se o número correto de pontos foi selecionado (7 ou 8)

Há uma configuração na Etapa 1 que informa ao Velogic Studio se você está usando 7 marcadores ou 8 (incluindo um marcador de calcanhar). Certifique-se de que a configuração corresponda ao número real de marcadores que você está usando.

## Procure outros reflexos destacados como pontos vermelhos

* Logotipos ou abas no shorts, na camisa e nos sapatos
* Partes brilhantes da bicicleta
* Aros de liga leve

Nós temos muita filtragem no processo de detecção para eliminar os reflexos extras, e os marcadores de alta qualidade (o material impresso na VF-Tape é compatível com visão noturna) fazem parte de como distinguimos entre reflexos desejados e indesejados.

## Ciclista excepcionalmente grande/pequeno/com proporções incomuns?

Para ajudar o Velogic Studio a filtrar reflexos indesejados, ele possui algumas regras internas para garantir que o esqueleto formado pelos marcadores possa razoavelmente formar um corpo humano. Algumas das regras são sobre proporcionalidade, e algumas envolvem tamanhos de segmentos corporais.

Às vezes você pode encontrar uma situação em que um ciclista viola uma de nossas regras de proporcionalidade (mais provável com ciclistas muito baixos ou muito altos). Se você estiver vendo 7 (ou 8) pontos vermelhos, todos no lugar correto, mas o Velogic Studio não estiver produzindo um wireframe/esqueleto, esse pode ser o seu caso.

Para nos ajudar a refinar as regras, envie um arquivo de amostra, que então analisaremos e usaremos para ajustar as regras. Veja abaixo "Como enviar um arquivo para acessarmos".

## A câmera está longe demais?

Se a câmera estiver posicionada a mais de cerca de 8' do plano da bicicleta, os pontos podem ser pequenos demais para a câmera reconhecer.

Veja também: [Configurando a área de ajuste](/pt-br/secao-01-como-comecar/setting-up-fit-area.md)

## Enviando um arquivo de amostra para avaliarmos

Se você estiver tendo problemas com a Detecção de Marcadores, temos um processo simples para [enviar arquivos para análise](/pt-br/secao-01-como-comecar/sharing-with-support.md) (veja a seção "Compartilhando arquivos de replay" nessa página).

Aqui está um vídeo do processo "Enviar amostra":

{% embed url="<https://vimeo.com/377229580>" %}