> 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

Se você não consegue obter nenhuma informação do Kinect, ou o Kinect está desconectando: consulte nosso [guia de compatibilidade de hardware](/pt-br/secao-01-comecando/pc-system-requirements.md) e [guia de solução de problemas da câmera Kinect](/pt-br/secao-01-comecando/kinect-troubleshooting.md) primeiro.

Uma vez que você tenha certeza de que o Kinect está funcionando bem (ou seja, o Verificador de Configuração do Kinect está estável e fornecendo 29-30 FPS), este guia ajudará você a solucionar problemas do aplicativo.

## A malha (wireframe) não aparece automaticamente

Veja: [Solução de problemas de detecção de marcadores](/pt-br/secao-02-usando-o-velogic-studio/troubleshooting-marker-detection.md)

## Taxa de quadros está baixa

Se você está tentando obter as melhores condições ambientais (para melhorar a taxa de quadros), há algumas coisas a verificar.

* Se esta for a primeira vez que você executa o Velogic Studio, ou se você acabou de atualizar para uma nova versão - o Windows pode ainda estar ocupado otimizando o aplicativo para o seu computador. Deixe-o rodar por alguns minutos e então feche e reinicie.
* Fontes de luz fortes (janela, porta, lâmpada) atrás do ciclista, na vista do Kinect, levarão a uma piora na taxa de quadros e uma imagem borrada (embora isso não afete a medição - apenas a imagem colorida).
* Condições de iluminação ruins podem significar uma área mal iluminada, ou iluminação apenas superior. Qualquer situação de iluminação que crie um gradiente sobre o ciclista (por exemplo, claro na parte superior e escuro na parte inferior) ou pontos quentes (brilhando diretamente em um dos marcadores) prejudicará a pontuação de iluminação.

Veja também: [Iluminação & ambiente](/pt-br/secao-01-comecando/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 é resolvido. Você deve conseguir fazer isso pelo Gerenciador de Dispositivos (expanda Adaptadores de vídeo, clique com o botão direito na sua placa gráfica e escolha Atualizar driver), OU instalar manualmente o [driver recomendado 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 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 computador definindo esta chave 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 para contornar esse problema: Configurações -> Suporte -> Forçar modo de renderização por software. Geralmente é melhor que essa configuração esteja desligada (porque força sua CPU a fazer trabalho que deveria ser feito pela GPU), mas ativá-la resolverá o problema do driver.

## Travamentos aleatórios ocasionais

O Velogic Studio é um aplicativo muito estável, mas se você experimentar travamentos ocasionais, leia abaixo possíveis soluções.

### Atualizar drivers de vídeo

O Velogic Studio utiliza funcionalidades dos seus drivers de vídeo. Se os drivers de vídeo estiverem com 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 dado no artigo: ![Device Manager window showing Display Adapters section for updating video drivers](/files/ac7e5110b08783f515f8a62d60edf362852ccaf3)

### Diga ao antivírus para não verificar os arquivos salvos pelo Velogic Studio

Se o Velogic Studio está "congelando" para você quando você salva uma captura, isso pode ajudar. O Windows possui um antivírus integrado que verifica cada arquivo salvo no disco. Às vezes acreditamos que ele identifica erroneamente um vídeo sendo salvo como um vírus, e irá interromper o Velogic Studio sem que qualquer 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 fit 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"

![Configurações do Windows Defender de Proteção contra vírus e ameaças com botão Gerenciar configurações](/files/eed4dbc1453fa6a495fa86dcf1cd93d3cb7e207e)

* Clique em "Adicionar ou remover exclusões"

![Página de configurações de proteção contra vírus com opção Adicionar ou remover exclusões](/files/d4f8222b2e66b5a86db8fb919be0d8c8b425c249)

* Clique em "Adicionar uma exclusão" e então em "Pasta"

![Diálogo de adicionar exclusão com opção Pasta selecionada para excluir o diretório de dados de fit](/files/6dc3782df8e533705ca71bbd0e72b34af87a4855)

* Escolha a pasta onde o Velogic Studio salva os dados de fit (normalmente será "Documents\Velogic Studio fits", mas você pode ter alterado isso nas configurações do Velogic Studio)
* Reinicie o Velogic Studio

### Verifique outros aplicativos que usam LibUSB

Alguns clientes relataram problemas com o Velogic Studio travando quando outros aplicativos que usam LibUSB estão instalados no mesmo computador. Um exemplo de tal 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](/files/2a47986f7cb3c50e5b2d00d6ea51223fc382d67b)

Se você encontrar LibUSB 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 Log de Eventos do Windows. Podemos pedir que você verifique os logs e nos envie um arquivo com informações relevantes. Veja como fazer isso:

* Pressione a tecla Windows e pesquise por "Visualizador de Eventos", então clique para executá-lo

![Resultados da pesquisa do menu Iniciar do Windows mostrando o aplicativo Visualizador de Eventos](/files/5c0295effebfa6c8f3f9cfad10aa7595b4e58edd)

* Clique em "Logs do Windows" e então em "Aplicativo"

![Visualizador de Eventos com Logs do Windows e seção Aplicativo destacadas](/files/03effa43aff2d51e846f9b693710aad305542977)

* Na área Ações no lado direito da janela, clique em "Filtrar log atual"

![Painel Ações do Visualizador de Eventos com opção Filtrar log atual selecionada](/files/c8fbc645154d8bb6e20ead2bc9597bfe4bd04f26)

* Na janela pop-up Filtrar, defina as opções: Nível do evento = Erro, Origem do evento = .NET Runtime, ID do evento = 1011, então clique em OK

![Diálogo Filtrar Log Atual com nível Erro e configurações .NET Runtime configuradas](/files/c7720f0285c2761cba15db31495366271c0eb48f)

* Na área Ações no lado direito da janela, clique em "Salvar arquivo de log filtrado como..."

![Painel Ações do Visualizador de Eventos mostrando opção Salvar arquivo de log filtrado](/files/b6241e5786259e79474248f9e14397d3a7d8a84f)

* Na caixa 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

![Diálogo Salvar Como para exportar arquivo de log de eventos filtrado para a área de trabalho](/files/b389428c9e9198b9c96b86f7538926c5273675d3)

* Envie um e-mail com esse arquivo em anexo para <support@velogicfit.com>

### Enviar arquivos de despejo (dump)

Se o Velogic Studio fechar inesperadamente (travamento), ele deverá gravar um arquivo de despejo em um diretório no seu computador e então reiniciar.

Quando reiniciar, ele notará que o arquivo de despejo existe e mostrará um prompt na parte inferior da janela principal do Velogic Studio.

![Prompt de upload de dump de travamento do Velogic Studio com botão Enviar (Upload) na parte inferior da janela](/files/d895007e96af0a390c061c727de15f9a7f370d63)

Esses arquivos de despejo são muito úteis para nos ajudar a diagnosticar e, eventualmente, corrigir o problema que causou o travamento. Se você vir essa mensagem e tiver conexão à internet razoável, por favor clique no botão "Enviar" (Upload). O Velogic Studio irá compactar o(s) arquivo(s) de despejo e enviá-los para nossa equipe de suporte.

Pode levar vários minutos para enviar, mas você pode usar o aplicativo normalmente enquanto o upload estiver ocorrendo, e pode cancelá-lo a qualquer momento.

Se você não desejar enviar os arquivos ao suporte, pode clicar em "Excluir". Ou pode clicar no botão X para ocultar a mensagem sem tomar nenhuma ação.

### Enviando-nos um arquivo de despejo manualmente

Se o Visual Studio ficar sem resposta, mas não criar automaticamente um arquivo de despejo (veja acima), podemos pedir que você crie manualmente um arquivo de despejo. Veja como fazer isso:

* Execute o Gerenciador de Tarefas (pressionando as teclas ctrl+shift+esc juntas)
* Encontre o Velogic Studio e clique no expansor ao lado dele

![Gerenciador de Tarefas mostrando processo Velogic Studio com visualização expandida dos subprocessos](/files/2d1ead275e0ac97e5b299da28212afb505c23936)

* Clique com o botão direito no processo e escolha "Criar arquivo de despejo"

![Menu de contexto ao clicar com o botão direito no processo mostrando opção Criar arquivo de despejo](/files/cc97fbfb25cd84ade4ddfd3867b7a0a887e7d513)

* Você verá uma mensagem como esta:

  ![Diálogo de progresso de criação de arquivo de despejo mostrando geração de arquivo em andamento](/files/7403b98442d6559932c8da7fec23d699807e8d02)

  ... e então após alguns segundos, você verá:

  ![Diálogo de conclusão da criação do arquivo de despejo mostrando o caminho do arquivo](/files/aeeea25e291ae372ad8e79683c9a3d9a644f7b37)
* No seu navegador, visite <https://vlgc.io/upload>, e clique no botão "Selecionar arquivos"

![Interface de upload web em vlgc.io/upload com botão Selecionar arquivos](/files/2d248cc8fddced44a12d36c3ad6fb04eb88fd802)

* Navegue até o caminho do passo anterior (por exemplo c:\Users\<seunome>\AppData\Local\temp\Velogic.Studio.App.DMP). Para facilitar, você pode digitar isto na caixa Nome do arquivo: `%localappdata%\temp\Velogic.Studio.App.DMP`
* Digite seu nome e sobrenome e clique em "Enviar" (Upload)

![Formulário de upload de arquivo com campos de nome e botão Enviar para enviar o arquivo de despejo](/files/fa9df40f293b30297d528318645463654fcc4b42)

* Levará alguns minutos para enviar, dependendo da sua conexão com a internet. O arquivo de despejo provavelmente terá cerca de 1GB, então se você estiver com internet cara, por favor contate-nos para garantir que esse é o melhor processo para você.
* Por favor, também envie um e-mail para <support@velogicfit.com>, explicando por que você enviou o arquivo .dmp. Idealmente seu e-mail conterá:
  * O que você estava fazendo
  * O que você esperava que acontecesse
  * O que realmente aconteceu

## Aplicativo geralmente parece lento, vídeos estão com atraso

Os aplicativos Velogic devem sempre parecer "responsivos" e ter bom desempenho em hardware razoável. Se você tem hardware que excede nossas especificações mínimas e não está obtendo o desempenho esperado, aqui estão algumas coisas que você pode verificar.

### Tente desconectar a webcam

Recebemos relatos de usuários que algumas webcams consomem muita CPU por si só, deixando pouco para os aplicativos Velogic realizarem seu trabalho. Tente desconectar sua webcam e, se o desempenho melhorar significativamente, use outra webcam.

### Use o Process Explorer para encontrar o gargalo

Process Explorer é uma ferramenta gratuita da Microsoft (parte do conjunto de ferramentas Sysinternals gratuito).

Você pode baixar ou executar diretamente a partir da [página do Process Explorer](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer). Simplesmente encontre o processo do Velogic na lista de processos, então clique com o botão direito e escolha "Propriedades". Deixe isso rodando 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](/files/a973c0bb4005230867738cf19ce171676a409775)

Você pode observar:

* Uso da CPU - o uso da CPU estar baixo é bom. (Alto uso de CPU não é necessariamente ruim, a menos que você esteja insatisfeito com o desempenho geral do aplicativo)
* "Bytes Privados" - isso é o uso de memória e deve permanecer relativamente constante em torno de 500-700MB. Se estiver subindo continuamente e rapidamente, você pode estar enfrentando um vazamento de memória - por favor entre em contato e envie uma cópia do seu gráfico (você pode capturar a tela com a combinação de teclas \[Shift]-\[Windows]-\[s])
* E/S - os picos de E/S ocorrem durante o período de Captura, quando o app está escrevendo vídeo no disco. A E/S é baixa fora desse período. O pico de CPU durante o período de Captura é bastante pequeno, então a CPU não está trabalhando excessivamente para codificar os vídeos.

Ficamos felizes em ajudar a diagnosticar quaisquer problemas de desempenho que você esteja tendo com nosso software. Por favor entre em contato com o máximo de informações que você tiver - idealmente incluindo uma captura de tela do Process Explorer.

### Enviar dados de desempenho para analisarmos

Construímos uma ferramenta no Velogic Studio que você pode usar para enviar dados detalhados de desempenho. Veja [este artigo](/pt-br/secao-01-comecando/submitting-performance-data.md) para detalhes.

### Enviando-nos informações do sistema

O Windows possui uma ferramenta embutida para coletar informações detalhadas sobre o hardware e o sistema operacional do seu sistema. Isso pode ser útil para nos ajudar a diagnosticar problemas. Se solicitarmos isso:

* Clique no menu Windows e digite "Informações do Sistema", então execute o aplicativo:

  ![Pesquisa do menu Iniciar do Windows mostrando o aplicativo Informações do Sistema](/files/2f8441a8ff25dd436c6ffbedbe2887687da82400)
*
* Clique em Arquivo -> Exportar, salve o arquivo em algum lugar (por exemplo sua área de trabalho) e então envie o arquivo por e-mail para nós - <support@velogicfit.com>