> 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.md). # Solução de problemas do Velogic Studio Guia completo de solução de problemas comuns do Velogic Studio, incluindo desempenho, travamentos e problemas de vídeo Se você não conseguir obter nenhuma informação do Kinect, ou se o Kinect estiver se desconectando: confira nosso [guia de compatibilidade de hardware](/pt-br/secao-01-introducao/pc-system-requirements.md) e [guia de solução de problemas da câmera Kinect](/pt-br/secao-01-introducao/kinect-troubleshooting.md) primeiro. Depois que você tiver certeza de que o Kinect está funcionando bem (ou seja, o Verificador de Configuração do Kinect está estável e fornecendo 29 a 30 FPS), este guia ajudará você a diagnosticar problemas no aplicativo. ## A estrutura de arame não aparece automaticamente Veja: [Solução de problemas na detecção de marcadores](/pt-br/secao-02-usando-o-velogic-studio/troubleshooting-marker-detection.md) ## A taxa de quadros está baixa Se você está tentando obter as melhores condições ambientais (para melhorar a taxa de quadros), há algumas coisas que você deve verificar. * Se esta é a primeira vez que você executa o Velogic Studio, ou se você acabou de atualizar para uma nova versão, o Windows talvez ainda esteja ocupado otimizando o aplicativo para o seu computador. Aguarde alguns minutos e depois feche e reinicie. * Fontes de luz fortes (janela, porta, lâmpada) atrás do cavaleiro, no campo de visão do Kinect, levarão a uma piora na taxa de quadros e a uma imagem borrada (embora isso não afete a medição - apenas a imagem colorida). * Condições ruins de iluminação podem significar uma área pouco iluminada ou iluminação apenas vinda de cima. Qualquer situação de iluminação que crie um gradiente sobre o cavaleiro (por exemplo, claro na parte de cima e escuro na parte de baixo) ou pontos muito intensos (iluminando diretamente um dos marcadores) prejudicará a pontuação de iluminação. Veja também: [Iluminação e ambiente](/pt-br/secao-01-introducao/lighting-environment.md) ## A visualização ao vivo não está ao vivo (congela após um quadro) Este é um problema conhecido com os drivers gráficos Intel Iris Xe. Existem algumas soluções diferentes: * Você pode atualizar seus drivers para a versão mais recente e ver se o problema foi corrigido. Você deve conseguir fazer isso pelo Gerenciador de Dispositivos (expanda Adaptadores de vídeo, clique com o botão direito na sua placa de vídeo e escolha Atualizar driver) OU instalar manualmente o [versão de driver recomendada pela Intel](https://www.intel.com/content/www/us/en/download/19344/30579/intel-graphics-windows-dch-drivers.html?) para corrigir esse problema específico. Se você instalar essa versão do driver e ainda assim ocorrer o congelamento, tente usar [o próprio software de gerenciamento da Intel](https://www.intel.com/content/www/us/en/support/detect.html) para atualizar para uma versão mais recente dos drivers gráficos. * Você pode desativar o código problemático para todo o seu computador definindo este sinalizador dword no Editor do Registro: `HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1` * O Velogic Studio tem uma configuração especial para desativar a aceleração de hardware e contornar esse problema: Configurações -> Suporte -> Forçar modo de renderização por software. Em geral, é melhor manter essa configuração desativada (porque ela força sua CPU a fazer um trabalho que deveria ser feito pela GPU), mas ativá-la contorna o problema do driver. ## Travamentos aleatórios ocasionais O Velogic Studio é um aplicativo muito estável, mas se você tiver travamentos ocasionais, continue lendo para ver possíveis soluções. ### Atualizar os drivers de vídeo O Velogic Studio usa funcionalidades dos seus drivers de vídeo. Se os drivers de vídeo tiverem bugs, isso pode causar instabilidade no Velogic Studio. Siga [este guia da Microsoft](https://support.microsoft.com/en-us/windows/update-drivers-in-windows-10-ec62f46c-ff14-c91d-eead-d7126dc1f7b6), mas no Gerenciador de Dispositivos escolha "Adaptador de vídeo" em vez do exemplo fornecido no artigo: ![Device Manager window showing Display Adapters section for updating video drivers](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-78e146ad5890a5387a593d3c40fc9d49021e8839%2Ftroubleshooting.png?alt=media) ### Diga ao antivírus para não verificar os arquivos salvos pelo Velogic Studio Se o Velogic Studio estiver "travando" quando você salva uma captura, isso pode ajudar. O Windows tem um antivírus integrado que verifica todos os arquivos salvos no disco. Às vezes achamos que ele identifica erroneamente um vídeo sendo salvo como vírus e interrompe o Velogic Studio sem que nenhum relatório de erro seja enviado. Você pode evitar esses falsos positivos e também reduzir o tempo necessário para salvar os resultados de cada captura dizendo ao Windows para ignorar o diretório onde os dados de ajuste do Velogic Studio são salvos: * Clique em "Iniciar" e digite "Vírus"; clique em "Proteção contra vírus e ameaças" * Clique em "Gerenciar configurações" em "Configurações de proteção contra vírus e ameaças" ![Página de configurações do Windows Defender Proteção contra vírus e ameaças com o botão Gerenciar configurações](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5eed58b05bb9fbe0b708891f47118cbf07997a55%2Ftroubleshooting-1.png?alt=media) * Clique em "Adicionar ou remover exclusões" ![Página de configurações de proteção contra vírus com a opção Adicionar ou remover exclusões](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-e622bccfce29fe80e578a4c77b31906f5b9fec54%2Ftroubleshooting-2.png?alt=media) * Clique em "Adicionar uma exclusão" e depois em "Pasta" ![Caixa de diálogo Adicionar exclusão com a opção Pasta selecionada para excluir o diretório de dados de ajuste](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a1554c9b0cfb1e1b034b6c180158e4681cb3e49e%2Ftroubleshooting-3.png?alt=media) * Escolha a pasta onde o Velogic Studio salva os dados de ajuste (geralmente será "Documents\Velogic Studio fits", mas você pode ter alterado isso nas configurações do Velogic Studio) * Reinicie o Velogic Studio ### Verifique se há outros aplicativos usando LibUSB Alguns clientes relataram problemas com o Velogic Studio travando quando outros aplicativos que usam LibUSB estão instalados no mesmo computador. Um exemplo desse tipo de aplicativo é o software de gerenciamento de EBike. Você pode verificar a presença do LibUSB olhando no Gerenciador de Dispositivos. ![Gerenciador de Dispositivos mostrando drivers LibUSB na lista de dispositivos do sistema](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1949740b9d24d140f8b2e2c78090a2920de2b875%2Ftroubleshooting-4.png?alt=media) Se você descobrir que o LibUSB está presente no computador, tente remover quaisquer outros dongles USB do computador. Se o Velogic Studio ainda estiver instável, tente remover o libUSB do computador (clique com o botão direito na entrada no Gerenciador de Dispositivos e escolha "Desinstalar dispositivo") ### Verifique mensagens de erro do Velogic Studio no Visualizador de Eventos O Visual Studio grava informações de erro no Registro de Eventos do Windows. Talvez peçamos que você verifique os registros e nos envie um arquivo com informações relevantes. Veja como fazer isso: * Pressione a tecla Windows e pesquise por "Visualizador de Eventos"; depois clique para executá-lo ![Resultados da pesquisa no menu Iniciar do Windows mostrando o aplicativo Visualizador de Eventos](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0020cf6f004c6bba0ac6552c9a5289f1cb9b658f%2Ftroubleshooting-5.png?alt=media) * Clique em "Logs do Windows" e depois em "Aplicativo" ![Visualizador de Eventos com a seção Logs do Windows e Aplicativo destacada](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-66fb067705fb03676854ee610b0534563f9ca44a%2Ftroubleshooting-6.png?alt=media) * Na área de Ações no lado direito da janela, clique em "Filtrar log atual" ![Painel Ações do Visualizador de Eventos com a opção Filtrar log atual selecionada](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-16848a6983b9c3a4a260d4c79b9e658824c0b2b8%2Ftroubleshooting-7.png?alt=media) * Na janela pop-up do filtro, defina as opções: Nível do evento = Erro, Fontes do evento = .NET Runtime, ID do evento = 1011; depois clique em OK ![Caixa de diálogo Filtrar Log Atual com o nível Erro e as configurações do .NET Runtime definidas](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-53e1f68e8d8cde5680481b65981a26099c9a9e02%2Ftroubleshooting-8.png?alt=media) * Na área de Ações no lado direito da janela, clique em "Salvar arquivo de log filtrado como..." ![Painel Ações do Visualizador de Eventos mostrando a opção Salvar arquivo de log filtrado](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-75aa2f2d6a1cd4dc0daa3f572d1c07b1a3c6fae0%2Ftroubleshooting-9.png?alt=media) * Na caixa de diálogo Salvar, dê um nome ao arquivo (por exemplo, seu nome) e salve-o em um local onde você possa encontrá-lo novamente, por exemplo, na área de trabalho ![Caixa de diálogo Salvar como para exportar o arquivo de log de eventos filtrado para a área de trabalho](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-74dc2128b1d90e07023a1b40a284514564a14d75%2Ftroubleshooting-10.png?alt=media) * Envie um e-mail com esse arquivo anexado para ### Fazer upload de arquivos de dump Se o Velogic Studio encerrar inesperadamente (travar), ele deve gravar um arquivo de dump em um diretório do seu computador e depois reiniciar. Quando reiniciar, ele perceberá que o arquivo de dump existe e exibirá um aviso na parte inferior da janela principal do Velogic Studio. ![Prompt de envio de dump de falha do Velogic Studio com o botão Enviar na parte inferior da janela](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b07da01dd3e5207065367f1fbca048ec0543b210%2Ftroubleshooting-11.png?alt=media) Esses arquivos de dump são muito úteis para nos ajudar a diagnosticar e, eventualmente, corrigir o problema que causou a falha. Se você vir esta mensagem e tiver uma conexão razoável com a internet, clique no botão "Enviar". O Velogic Studio compactará os arquivos de dump em um zip e os enviará para nossa equipe de suporte. O envio pode levar vários minutos, mas você pode usar o aplicativo normalmente enquanto o upload acontece, e pode cancelá-lo a qualquer momento. Se você não quiser enviar os arquivos para o suporte, pode clicar em "Excluir". Ou pode clicar no botão X para ocultar a mensagem sem executar nenhuma ação. ### Enviando-nos um arquivo de dump manual Se o Visual Studio ficar sem resposta, mas não criar automaticamente um arquivo de dump (veja acima), talvez peçamos que você crie manualmente um arquivo de dump. Veja como fazer isso: * Execute o Explorador de Tarefas (pressionando as teclas ctrl+shift+esc ao mesmo tempo) * Encontre o Velogic Studio e clique no expansor ao lado dele ![Gerenciador de Tarefas mostrando o processo do Velogic Studio com a visualização expandida dos subprocessos](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-9ed9554ad89842648da249e060da5fcf4eb24bff%2Ftroubleshooting-12.png?alt=media) * Clique com o botão direito no processo e escolha "Criar arquivo de dump" ![Menu de contexto ao clicar com o botão direito no processo mostrando a opção Criar arquivo de dump](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a055a3ac74dfdabf9c0055385e8fc73287357ef3%2Ftroubleshooting-13.png?alt=media) * Você verá uma mensagem como esta: ![Diálogo de progresso da criação do arquivo de dump mostrando a geração do arquivo em andamento](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5efe042bba4a54dc8ba954ae605335cc39a8779b%2Ftroubleshooting-14.png?alt=media) ... e depois de alguns segundos, você verá: ![Diálogo de conclusão da criação do arquivo de dump mostrando a localização do caminho do arquivo](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-29c458bdaabcb998fbf5e7d65565dfa073a49412%2Ftroubleshooting-15.png?alt=media) * No seu navegador, acesse , e clique no botão "Selecionar arquivos" ![Interface de upload na web em vlgc.io/upload com o botão Selecionar arquivos](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-44ad9584d63e9094155da844db9575bceb60b279%2Ftroubleshooting-16.png?alt=media) * Navegue até o caminho da etapa anterior (por exemplo, c:\Users\\AppData\Local\temp\Velogic.Studio.App.DMP). Para facilitar, você pode digitar isso na caixa Nome do arquivo: `%localappdata%\temp\Velogic.Studio.App.DMP` * Digite seu nome e sobrenome e clique em "Enviar" ![Formulário de upload de arquivo com campos de nome e botão Enviar para enviar o arquivo de dump](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c980fa2f2fce73b68f324afdf74f84c46950469f%2Ftroubleshooting-17.png?alt=media) * Levará alguns minutos para fazer o upload, dependendo da sua conexão com a internet. O arquivo de dump provavelmente terá cerca de 1 GB, então, se sua internet for cara, entre em contato conosco para garantir que esse é o melhor processo para você. * Por favor, também envie um e-mail para , explicando por que você enviou o arquivo .dmp. De preferência, seu e-mail deve conter: * O que você estava fazendo * O que você esperava que acontecesse * O que realmente aconteceu ## O aplicativo geralmente parece lento, os vídeos ficam com atraso Os aplicativos Velogic devem sempre parecer ágeis e ter bom desempenho em hardware razoável. Se você tiver hardware que exceda nossas especificações mínimas e não estiver obtendo o desempenho esperado, aqui estão algumas coisas que você pode verificar. ### Tente desconectar a webcam Recebemos relatos de usuários de que algumas webcams consomem muita CPU, deixando pouco recurso para os aplicativos da Velogic fazerem seu trabalho. Tente desconectar sua webcam e, se o desempenho melhorar visivelmente, use uma webcam diferente. ### Use o Process Explorer para encontrar o gargalo O Process Explorer é um utilitário gratuito da Microsoft (parte do conjunto gratuito de ferramentas Sysinternals). Você pode baixar ou executar diretamente a partir da [página do Process Explorer](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer). Basta localizar o processo do Velogic na lista de processos, clicar com o botão direito e escolher "Propriedades". Deixe isso em execução enquanto você realiza algumas atividades no Velogic Studio e depois examine os gráficos. ![Gráficos de desempenho do Process Explorer mostrando uso de CPU, memória e estatísticas de E/S](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-695dd3522704a4b50c5d68b8a15716dfbcaac5bd%2Ftroubleshooting-18.png?alt=media) Você pode observar: * Uso de CPU - o uso de CPU está baixo, o que é bom. (Uso alto de CPU não é necessariamente ruim, a menos que você esteja insatisfeito com o desempenho geral do aplicativo) * "Bytes Privados" - este é o uso de memória e deve permanecer relativamente constante em algo em torno de 500 a 700 MB. Se estiver subindo continuamente e rapidamente, você pode estar enfrentando um vazamento de memória - entre em contato conosco e envie uma cópia do seu gráfico (você pode fazer uma captura de tela com o atalho \[Shift]-\[Windows]-\[s]) * E/S - o pico de E/S ocorre durante o período de Captura, quando o aplicativo está gravando vídeo no disco. Fora isso, a E/S é baixa. O pico de CPU durante o período de Captura é bem pequeno, então a CPU não está trabalhando demais para codificar os vídeos. Temos prazer em ajudar a diagnosticar quaisquer problemas de desempenho que você esteja tendo com nosso software. Entre em contato com o máximo de informações que tiver - de preferência incluindo uma captura de tela do Process Explorer. ### Enviar dados de desempenho para análise Criamos uma ferramenta no Velogic Studio que você pode usar para enviar dados detalhados de desempenho. Veja [este artigo](/pt-br/secao-01-introducao/submitting-performance-data.md) para detalhes. ### Enviando informações do sistema O Windows tem uma ferramenta integrada para reunir informações detalhadas sobre o hardware e o sistema operacional do seu computador. Isso às vezes pode ser útil para nos ajudar a diagnosticar problemas. Se pedirmos isso a você: * Clique no menu do Windows e digite "Informações do Sistema", depois execute o aplicativo: ![Pesquisa no menu Iniciar do Windows mostrando o aplicativo Informações do Sistema](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-3357cd97f790a4ab99602800af6415263a9d6633%2Ftroubleshooting-19.png?alt=media) * * Clique em Arquivo -> Exportar, salve o arquivo em algum lugar (por exemplo, na sua área de trabalho) e depois nos envie o arquivo por e-mail - --- # 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.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.