Solução de problemas do Velogic Studio

Guia abrangente de solução de problemas para problemas comuns do Velogic Studio, incluindo desempenho, travamentos e problemas de vídeo

Se você não consegue obter nenhuma informação do Kinect, ou o Kinect está desconectando: confira nosso guia de compatibilidade de hardware e guia de solução de problemas da câmera Kinect 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 exibindo 29-30 FPS), este guia ajudará a solucionar problemas do aplicativo.

A malha de arame não aparece automaticamente

Veja: Solução de problemas de detecção de marcadores

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 para verificar.

  • Se esta for a primeira vez que você executa o Velogic Studio, ou você acabou de atualizar para uma nova versão - o Windows ainda pode 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 visão do Kinect, levarão a uma taxa de quadros pior 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 apenas iluminação superior. Qualquer situação de iluminação que crie um gradiente no ciclista (ex.: claro na parte superior e escuro na parte inferior) ou pontos quentes (incidindo diretamente em um dos marcadores) prejudicará a pontuação de iluminação.

Veja também: Iluminação e ambiente

Visualização ao vivo não é 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 é corrigido. Você deve ser capaz de fazer isso com o 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 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 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 desativada (pois força sua CPU a fazer trabalhos que deveriam ser feitos pela GPU), mas ativá-la contornará o problema do driver.

Falhas aleatórias ocasionais

O Velogic Studio é um aplicativo muito estável, mas se você experimentar falhas ocasionais, leia a seguir 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 tiverem bugs, isso pode causar instabilidade no Velogic Studio.

Siga este guia da Microsoft, mas no Gerenciador de Dispositivos escolha "Adaptador de vídeo" em vez do exemplo dado no artigo:

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 embutido que verifica cada arquivo salvo no disco. Às vezes achamos que ele identifica erroneamente um vídeo sendo salvo como um vírus, e interrompe 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, instruindo o Windows a 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 Proteção contra vírus e ameaças com botão Gerenciar configurações
  • 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
  • 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
  • Escolha a pasta onde o Velogic Studio salva os dados de fit (geralmente será "Documentos\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

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

  • Pressione a tecla do 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
  • Clique em "Logs do Windows" e então em "Aplicativo"

Visualizador de Eventos com Logs do Windows e seção Aplicativo destacados
  • 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
  • Na janela pop-up Filtrar, defina as opções: Nível de evento = Erro, Fontes 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
  • 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
  • Na caixa Salvar, dê um nome ao arquivo (por exemplo seu nome) e salve-o em algum lugar onde 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

Carregar arquivos de despejo

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

Quando ele 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 despejo de falha do Velogic Studio com botão Enviar na parte inferior da janela

Esses arquivos de despejo 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, por favor clique no botão "Enviar". O Velogic Studio compactará o(s) arquivo(s) de despejo e os enviará para nossa equipe de suporte.

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

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

Enviando-nos um arquivo de despejo manual

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 todas juntas)

  • Encontre o Velogic Studio e clique no expansor ao lado dele

Gerenciador de Tarefas mostrando processo Velogic Studio com visualização expandida de subprocessos
  • 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
  • Você verá uma mensagem como esta:

    Diálogo de progresso de criação de arquivo de despejo mostrando geração de arquivo em andamento

    ... 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
  • 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
  • Navegue até o caminho do passo anterior (ex.: 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"

Formulário de upload de arquivo com campos de nome e botão Enviar para enviar o arquivo de despejo
  • 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 em uma internet cara, por favor entre em contato conosco para garantir que este seja o melhor procedimento para você.

  • Por favor, também envie um e-mail para [email protected], 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

O aplicativo geralmente parece lento, vídeos estão com atraso

Os aplicativos Velogic devem sempre parecer "rápidos" 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 de que algumas webcams consomem muita CPU por conta própria, deixando pouco para os aplicativos Velogic fazerem seu trabalho. Tente desconectar sua webcam e, se o desempenho melhorar consideravelmente, use uma webcam diferente.

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. Simplesmente encontre o processo 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 da CPU, memória e estatísticas de E/S

Você pode observar:

  • Uso da CPU - o uso da CPU baixo é bom. (Alto uso de CPU não é necessariamente ruim, a menos que você esteja insatisfeito com o desempenho geral do aplicativo)

  • "Private Bytes" - 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 conosco e envie uma cópia do seu gráfico (você pode fazer uma captura de 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 aplicativo está gravando 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 muito para codificar os vídeos.

Ficamos felizes em ajudar a diagnosticar qualquer problema de desempenho que você tenha 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 para detalhes.

Enviando-nos informações do sistema

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

  • Clique no menu do 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
  • 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 - [email protected]

Last updated