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: consulte 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 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

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

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 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 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, 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 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

• 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 (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

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

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

Visualizador de Eventos com Logs do Windows e seção Aplicativo destacadas

• 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 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

• 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 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

• Envie um e-mail com esse arquivo em anexo para [email protected]

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

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

• 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 (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

• 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 [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

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

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 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
• 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]