# 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](https://docs.velogicfit.com/pt-br/secao-01-primeiros-passos/pc-system-requirements) e [guia de solução de problemas da câmera Kinect](https://docs.velogicfit.com/pt-br/secao-01-primeiros-passos/kinect-troubleshooting) 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](https://docs.velogicfit.com/pt-br/secao-02-usando-o-velogic-studio/troubleshooting-marker-detection)

## 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](https://docs.velogicfit.com/pt-br/secao-01-primeiros-passos/lighting-environment)

## 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](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 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](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 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 então em "Pasta"

![Diálogo de adicionar exclusão com opção Pasta selecionada para excluir o diretório de dados de fit](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 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](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ê 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](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 então em "Aplicativo"

![Visualizador de Eventos com Logs do Windows e seção Aplicativo destacadas](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 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](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 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](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 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](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 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](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 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](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 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](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 despejo"

![Menu de contexto ao clicar com o botão direito no processo mostrando opção Criar arquivo de despejo](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 de criação de arquivo de despejo mostrando geração de 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 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](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, 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](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 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](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 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](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 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](https://docs.velogicfit.com/pt-br/secao-01-primeiros-passos/submitting-performance-data) 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](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 sua área de trabalho) e então envie o arquivo por e-mail para nós - <support@velogicfit.com>