Funzionalità opzionali: scaricare i componenti di Motion Cattura

A partire da Swing Catalyst 26.2, i modelli di Motion Cattura e i file di Accelerazione GPU non fanno più parte del programma di installazione. Li scarichi una sola volta, direttamente dall’app, nella pagina delle impostazioni Optional Features. Questo mantiene piccolo il programma di installazione e ci permette di aggiornare i modelli senza una nuova versione dell’app.

Questo articolo spiega cosa sono questi download, dove trovare la pagina e cosa fare quando un download fallisce.

I quattro gruppi di componenti

La pagina Optional Features ha quattro gruppi. Ogni gruppo è un insieme di file necessari a una funzionalità.

Gruppo	Cosa fa	Dimensione approssimativa
Motion Cattura	Traccia il movimento del corpo nei tuoi video. Necessario per tutte le funzionalità di Motion Cattura.	300 MB
Tracciamento bastone da golf	Traccia il bastone da golf e la palla nei video di golf.	340 MB
Tracciamento Pedana di Forza	Trova automaticamente le pedane di forza nei tuoi video.	70 MB
Accelerazione GPU	Elaborazione più veloce sui computer con scheda grafica NVIDIA. Non necessario sugli altri computer.	4.1 GB

Le dimensioni cambiano da una versione all’altra. La pagina mostra sempre la dimensione di download attuale accanto a ogni gruppo.

I file vengono salvati in C:\ProgramData\Swing Catalyst\components. La pagina mostra la cartella esatta accanto a Components Folder, e Open Folder la apre in Esplora risorse di Windows.

Dove trovare la pagina

Ci sono tre modi per raggiungerla:

Settings > Optional Features. Questo è il modo principale.
Help > Open Component Manager. Funziona anche dalla schermata iniziale, prima di aprire una sessione.
Dalla pagina delle impostazioni Motion Cattura. Se mancano dei componenti, un banner giallo in alto indica quanti ne servono. Download all needed li scarica. Manage Components… apre la pagina Optional Features.

Potresti anche vedere una richiesta quando avvii una funzionalità che necessita di componenti. Indica Download required ed elenca cosa manca. Scegli Download per iniziare, Not now per saltare, oppure Open Optional Features per vedere prima i dettagli.

Come scaricare

Apri Settings > Optional Features.
Fai clic su Download su un gruppo, oppure su Download All Missing in alto per ottenere tutto.
Osserva lo stato a destra di ogni gruppo. Passa da Not Installed a Downloading… 45% a Installed.

Puoi continuare a usare l’app mentre i file vengono scaricati. L’avanzamento è visibile anche nell’elenco delle attività in fondo alla finestra. Al termine di un download, un messaggio indica ML models downloaded oppure Runtime components downloaded.

Mentre un gruppo è in fase di download puoi:

Metterlo in Pausa e farlo Resume più tardi. Dopo un Resume, il file corrente riparte da zero, quindi una pausa su un file di grandi dimensioni fa perdere tempo.
Cancel il download. Nella cartella dei componenti non resta nulla. Un file viene spostato lì solo dopo essere completo e verificato.

Se hai avviato il download da una funzionalità che ne aveva bisogno, un messaggio indica downloaded. Try the action again quando è terminato. A quel punto esegui di nuovo la funzionalità.

Etichette di stato

Stato	Significato
Installed	Ogni file del gruppo è presente e verificato.
Not Installed	Nessun file di questo gruppo è ancora presente su disco.
2 of 4 installed	Alcuni file sono presenti. Fai clic su Download per ottenere il resto.
Needs repair	Un file è danneggiato o incompleto. Fai clic su Repair. L’app elimina il file danneggiato e lo scarica di nuovo.
Downloading… 45%	Un download è in corso.

Disk usage in cima alla pagina mostra due numeri. Uno è lo spazio occupato dai file installati. L’altro è lo spazio che occuperebbero i file mancanti.

Requisiti

Accesso a Internet verso api.swingcatalyst.com e verso l’archiviazione Microsoft Azure. Se la tua rete blocca i download, chiedi al reparto IT di consentirli.
Una licenza che include Motion Cattura: la pagina verifica la tua licenza prima di iniziare. Se la licenza non copre un gruppo, il download si interrompe con un messaggio relativo alla licenza.
Spazio libero su disco pari alla dimensione del download. L’app lo verifica prima di iniziare e indica quanto ne serve.
Una scheda grafica NVIDIA per il gruppo Accelerazione GPU. Sugli altri computer, Motion Cattura funziona comunque. Utilizza il motore DirectML, che non richiede download aggiuntivi.

Quando un download fallisce

Il gruppo mostra un breve messaggio sotto il suo stato. Risolvi la causa e fai di nuovo clic su Download. Un file non riuscito viene scaricato di nuovo dall’inizio.

Messaggio	Cosa fare
check your internet connection	L’app non è riuscita a raggiungere il server. Controlla connessione, VPN e firewall, poi riprova.
server temporarily unavailable	Il server di download non ha risposto. Attendi qualche minuto e riprova.
Your license does not have access to these models	La tua licenza non include questa funzionalità. Contatta l’assistenza se ritieni che dovrebbe includerla.
insufficient disk space	Libera lo spazio indicato, poi riprova.
file not found on server	Il file manca dal nostro lato. Contatta l’assistenza e allega la diagnostica (vedi sotto).
verification failed	Il file è stato danneggiato durante il download. Fai clic su Repair o su Download per ottenerlo di nuovo.
could not be saved to disk	L’app non è riuscita a scrivere nella cartella dei componenti. Verifica che un antivirus o i permessi della cartella non blocchino `C:\ProgramData\Swing Catalyst\components`.

Se lo stesso errore continua a ripresentarsi, inviaci la diagnostica.

Diagnostica per l’assistenza

Apri Settings > Optional Features.
Fai clic su Copy Diagnostics. Questo copia un riepilogo testuale di ogni componente, la sua versione, il suo stato e la cartella dei componenti.
Incollalo nella tua email all’assistenza.

Per maggiori dettagli, fai clic su Show technical details in fondo alla pagina. Ogni gruppo elenca quindi i singoli file, con versione, dimensione, percorso del file e checksum. L’assistenza potrebbe chiederti uno screenshot di questa vista.

Rimuovere i file

Per liberare spazio su disco, chiudi Swing Catalyst ed elimina la cartella dei componenti. La volta successiva che apri l’app, ogni gruppo mostra Not Installed e puoi scaricare di nuovo.