> 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 Guia completo para solucionar problemas comuns de detecção de marcadores no Velogic Studio O Velogic Studio deve estar mostrando para você uma estrutura/esqueleto sólida: {% embed url="" %} e os Indicadores de Qualidade devem estar mostrando "Bom" para a detecção: ![Indicadores de qualidade mostrando status de detecção Bom para reconhecimento correto dos marcadores](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-228659437abda88d137f68f93eb5b8d8ae54c2a9%2Ftroubleshooting-marker-detection.png?alt=media) Se você não estiver vendo isso, esta página vai ajudar você a solucionar o problema. > **Problema conhecido:** alguns rolos de fita marcador produzidos no início de 2026 não são totalmente retrorefletivos, o que faz os marcadores desaparecerem quando não estão voltados diretamente para a câmera. Se um marcador continua desaparecendo mesmo estando colocado corretamente, veja [Problema de refletividade do marcador](/pt-br/secao-02-usando-o-velogic-studio/marker-reflectivity-issue.md). ## Procure 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 encontrou. ![Pontos vermelhos exibidos quando o Velogic Studio não consegue formar um esqueleto válido a partir dos marcadores detectados](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0acc728aa3146b4837fa02004334d9bd464d7cbb%2Ftroubleshooting-marker-detection-1.png?alt=media) Você pode observar o ciclista pedalando e ver se um dos marcadores às vezes não está sendo exibido como um ponto vermelho. Se perceber 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 precise 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 eles estiverem perto de uma posição válida de marcador, você precisará cobri-los. ## Verifique a posição dos marcadores Consulte nossa [documentação sobre a posiçã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 colocado alto demais * Marcador do pulso girado demais para longe da câmera * Marcador do calcanhar (se usado) colocado muito baixo no sapato ## Verifique se a quantidade correta de pontos foi selecionada (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 no calcanhar). Certifique-se de que essa configuração corresponda ao número real de marcadores que você está usando. ## Procure outros reflexos destacados como pontos vermelhos * Logotipos ou abas em shorts, camisa e sapatos * Partes brilhantes na bicicleta * Aros de liga leve Temos bastante filtragem no processo de detecção para eliminar os reflexos extras e os marcadores de alta qualidade (o material impresso na VF-Tape é classificado para visão noturna) fazem parte de como distinguimos entre reflexos desejados e indesejados. ## Ciclista com proporções incomumente grandes/pequenas/incomuns? Para ajudar o Velogic Studio a filtrar reflexos indesejados, ele tem 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 outras 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 gerando uma estrutura/esqueleto, esse pode ser o seu caso. Para nos ajudar a refinar as regras, envie um arquivo de exemplo que iremos analisar e usar para ajustar as regras. Veja "Enviando um arquivo para acessarmos" abaixo. ## Câmera longe demais? Se a câmera estiver posicionada a mais de cerca de 8' do plano da bicicleta, os pontos podem ficar pequenos demais para a câmera reconhecer. Veja também: [Configurando a área de ajuste](/pt-br/secao-01-introducao/setting-up-fit-area.md) ## Enviando um arquivo de exemplo para analisarmos 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-introducao/sharing-with-support.md) (veja a seção "Compartilhando arquivos de replay" nessa página). Aqui está um vídeo do processo de "Enviar amostra":"} {% embed url="" %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.velogicfit.com/pt-br/secao-02-usando-o-velogic-studio/troubleshooting-marker-detection.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.