Recursos Opcionais: baixando componentes de captura de movimento

A partir do Swing Catalyst 26.2, os modelos de captura de movimento e os arquivos de Aceleração GPU não fazem mais parte do instalador. Você os baixa uma vez, de dentro do aplicativo, na página de configurações Recursos Opcionais. Isso mantém o instalador pequeno e nos permite atualizar os modelos sem lançar uma nova versão do aplicativo.

Este artigo explica o que são os downloads, onde encontrar a página e o que fazer quando um download falha.

Os quatro grupos de componentes

A página Recursos Opcionais tem quatro grupos. Cada grupo é um conjunto de arquivos que um recurso precisa.

Grupo	O que faz	Tamanho aproximado
Captura de Movimento	Rastreia o movimento do corpo em seus vídeos. Necessário para todos os recursos de captura de movimento.	300 MB
Rastreamento do Clube de Golfe	Rastreia o taco de golfe e a bola em vídeos de golfe.	340 MB
Rastreamento de Placas de Força	Encontra placas de força em seus vídeos automaticamente.	70 MB
Aceleração GPU	Processamento mais rápido em computadores com placa de vídeo NVIDIA. Não é necessário em outros computadores.	4.1 GB

Os tamanhos mudam entre versões. A página sempre mostra o tamanho de download atual ao lado de cada grupo.

Os arquivos são armazenados em C:\ProgramData\Swing Catalyst\components. A página mostra a pasta exata ao lado de Pasta de Componentes, e Abrir Pasta a abre no Windows Explorer.

Onde encontrar a página

Há três formas de chegar até ela:

Configurações > Recursos Opcionais. Esta é a forma principal.
Ajuda > Abrir Gerenciador de Componentes. Isso funciona também na tela inicial, antes de você abrir uma sessão.
Na página de configurações Captura de Movimento. Se faltarem componentes, um aviso amarelo no topo informa quantos são necessários. Baixar tudo o necessário os baixa. Gerenciar Componentes… abre a página Recursos Opcionais.

Você também pode ver um aviso ao iniciar um recurso que precisa de componentes. Ele diz Download necessário e lista o que está faltando. Escolha Baixar para começar, Agora não para pular, ou Abrir Recursos Opcionais para ver os detalhes primeiro.

Como baixar

Abra Configurações > Recursos Opcionais.
Clique em Baixar em um grupo, ou em Baixar Tudo que Falta no topo para buscar tudo.
Observe o status à direita de cada grupo. Ele muda de Não Instalado para Baixando… 45% até Instalado.

Você pode continuar usando o aplicativo enquanto os arquivos baixam. O progresso também aparece na lista de tarefas na parte inferior da janela. Quando um download termina, uma mensagem diz Modelos de ML baixados ou Componentes de runtime baixados.

Enquanto um grupo está baixando, você pode:

Clicar em Pausa e, mais tarde, em Retomar. Ao retomar, o arquivo atual recomeça do início, portanto pausar um arquivo grande custa algum tempo.
Clicar em Cancelar. Nada permanece na pasta de componentes. Um arquivo só é movido para lá depois de concluído e verificado.

Se você iniciou o download a partir de um recurso que precisava dele, uma mensagem diz baixado. Tente a ação novamente quando ele terminar. Em seguida, execute o recurso mais uma vez.

Rótulos de status

Status	Significado
Instalado	Todos os arquivos do grupo estão presentes e verificados.
Não Instalado	Nada deste grupo está no disco ainda.
2 de 4 instalados	Alguns arquivos estão presentes. Clique em Baixar para buscar o restante.
Precisa de reparo	Um arquivo está danificado ou incompleto. Clique em Reparar. O aplicativo apaga o arquivo com problema e o baixa novamente.
Baixando… 45%	Um download está em andamento.

Uso de disco, no topo da página, mostra dois números. Um é o espaço que os arquivos instalados ocupam. O outro é o espaço que os arquivos ausentes ocupariam.

Requisitos

Acesso à internet para api.swingcatalyst.com e para o armazenamento do Microsoft Azure. Se sua rede bloquear downloads, peça ao seu departamento de TI para liberá-los.
Uma licença que inclua captura de movimento: a página verifica sua licença antes de começar. Se sua licença não cobrir um grupo, o download para com uma mensagem sobre a licença.
Espaço livre em disco igual ao tamanho do download. O aplicativo verifica isso antes de começar e informa quanto é necessário.
Uma placa de vídeo NVIDIA para o grupo Aceleração GPU. Em outros computadores, a captura de movimento continua funcionando. Ela usa o mecanismo DirectML, que não precisa de download extra.

Quando um download falha

O grupo mostra uma mensagem curta abaixo do status. Corrija a causa e clique em Baixar novamente. Um arquivo que falhou é buscado novamente desde o início.

Mensagem	O que fazer
verifique sua conexão com a internet	O aplicativo não conseguiu acessar o servidor. Verifique sua conexão, VPN e firewall, depois tente novamente.
servidor temporariamente indisponível	O servidor de download não respondeu. Aguarde alguns minutos e tente novamente.
Sua licença não tem acesso a estes modelos	Sua licença não inclui este recurso. Entre em contato com o suporte se achar que deveria incluir.
espaço em disco insuficiente	Libere a quantidade de espaço mostrada e tente novamente.
arquivo não encontrado no servidor	O arquivo está ausente do nosso lado. Entre em contato com o suporte e inclua o diagnóstico (veja abaixo).
falha na verificação	O arquivo foi danificado durante o download. Clique em Reparar ou Baixar para buscá-lo novamente.
não foi possível salvar no disco	O aplicativo não conseguiu gravar na pasta de componentes. Verifique se um antivírus ou permissões de pasta não estão bloqueando `C:\ProgramData\Swing Catalyst\components`.

Se o mesmo erro continuar aparecendo, envie o diagnóstico para nós.

Diagnóstico para o suporte

Abra Configurações > Recursos Opcionais.
Clique em Copiar Diagnóstico. Isso copia um resumo em texto de cada componente, sua versão, seu status e a pasta de componentes.
Cole no seu e-mail de suporte.

Para mais detalhes, clique em Mostrar detalhes técnicos na parte inferior da página. Cada grupo então lista seus arquivos individuais, com versão, tamanho, caminho do arquivo e checksum. O suporte pode pedir uma captura de tela dessa visualização.

Removendo os arquivos

Para liberar espaço em disco, feche o Swing Catalyst e apague a pasta de componentes. Na próxima vez que você abrir o aplicativo, todos os grupos mostrarão Não Instalado e você poderá baixar novamente.