Connetti a Strava

VeloLoop registra le tue pedalate come file FIT standard accettati da Strava. Puoi caricare le pedalate manualmente tramite il sito web di Strava in qualsiasi momento. VeloLoop include anche un'integrazione Strava per caricamenti automatici e con un solo clic, disponibile una volta che il proprietario del progetto ha configurato la connessione API Strava.

Caricamento su Strava (manuale)

Il modo più rapido per portare la tua pedalata su Strava — funziona per tutti, nessuna configurazione necessaria:

  1. 1Apri Strava nel browser e vai alla pagina Caricamento (strava.com/upload/select)
  2. 2Clicca "Scegli File" e seleziona il tuo file FIT da Documenti/VeloLoop/Rides
  3. 3Imposta il tipo di attività su "Virtual Ride"
  4. 4Aggiungi un titolo e le eventuali note
  5. 5Clicca Carica

Quando la distanza virtuale è abilitata, VeloLoop include distanza e velocità stimate nel file FIT, così Strava mostrerà questi valori per la tua pedalata.

Integrazione Strava integrata

Nota: L'integrazione Strava è implementata in VeloLoop ma richiede una configurazione iniziale da parte del proprietario del progetto (deploy del proxy di autenticazione e registrazione di un'applicazione API Strava). Se non configurata, le funzioni Strava sono nascoste nell'app. Il caricamento end-to-end non è stato ancora verificato con l'API Strava live.

  • VeloLoop include un'integrazione Strava con autenticazione OAuth 2.0, caricamento automatico e controlli per il caricamento manuale
  • Questa funzione richiede una configurazione iniziale da parte del proprietario del progetto: il deploy del worker proxy Cloudflare e la registrazione di un'applicazione API Strava
  • Una volta configurato, il pulsante "Connetti a Strava" appare nell'app desktop dopo la pedalata
  • Dopo la connessione, puoi caricare le pedalate manualmente tramite un pulsante nel pannello post-pedalata, oppure abilitare il caricamento automatico per inviarle a Strava quando finisci
  • Il caricamento automatico è disattivato per impostazione predefinita — scegli tu se abilitarlo nelle Impostazioni
  • Le credenziali Strava vengono archiviate in modo sicuro nel gestore credenziali del tuo sistema operativo (Gestione credenziali di Windows o Portachiavi macOS) — mai in un file di testo in chiaro
  • Per disconnetterti: clicca Disconnetti nella sezione Strava delle Impostazioni — VeloLoop revoca il proprio accesso e rimuove le credenziali archiviate
  • I tuoi file FIT vengono sempre conservati localmente in Documenti/VeloLoop/Rides, anche dopo il caricamento
  • VeloLoop tiene traccia dei caricamenti localmente per evitare invii duplicati a Strava

Come funziona la connessione

Una volta abilitata l'integrazione Strava nella tua build, il flusso di connessione è:

  1. 1Apri VeloLoop e termina o salta una pedalata in modo che il pannello post-pedalata sia visibile
  2. 2Clicca "Connetti a Strava"
  3. 3Il tuo browser apre la pagina di autorizzazione Strava
  4. 4Approva VeloLoop — viene richiesto solo il permesso "Carica attività"
  5. 5Il browser mostra una pagina di conferma — puoi chiuderla e tornare a VeloLoop
  6. 6VeloLoop mostra lo stato della connessione Strava e i controlli di caricamento

Tipo di attività

  • VeloLoop imposta il tipo di sport su "VirtualRide" in tutti i file FIT
  • Per i caricamenti manuali, scegli "Virtual Ride" affinché Strava gestisca correttamente i dati indoor
  • Quando la distanza virtuale è abilitata, VeloLoop include distanza e velocità stimate calcolate dai tuoi dati di potenza — Strava le mostrerà insieme a potenza, cadenza e frequenza cardiaca
  • Non vengono registrate coordinate GPS né dati altimetrici — è normale per il ciclismo indoor

Problemi comuni

Attività duplicata rifiutata

Strava rifiuta i file che ha già ricevuto. Se vedi questo errore durante il caricamento manuale, la pedalata è già su Strava. L'integrazione tiene traccia dei caricamenti localmente per evitare duplicati automaticamente.

Distanza o velocità diversa dal previsto

VeloLoop include distanza e velocità virtuali stimate derivate dalla potenza usando un modello fisico su strada pianeggiante (quando abilitato nelle impostazioni di pedalata). Si tratta di stime, non di misurazioni GPS. Strava potrebbe mostrare valori leggermente diversi se applica i propri calcoli.

Caricamento bloccato sull'elaborazione

Strava elabora i caricamenti in modo asincrono. VeloLoop verifica gli aggiornamenti di stato (caricamento, elaborazione, completato o errore). Se lo stato non si aggiorna entro un minuto, controlla la pagina delle tue attività Strava — il caricamento di solito va a buon fine.

Opzione Strava non visibile nell'app

L'integrazione Strava è visibile solo quando il proprietario del progetto ha configurato le credenziali API Strava. Se non vedi l'opzione Strava, l'integrazione non è stata abilitata per la tua build. Puoi sempre caricare i file FIT manualmente tramite il sito web di Strava.

Privacy

  • VeloLoop richiede solo il permesso "activity:write" — non legge i tuoi dati Strava, i follower, i percorsi o le informazioni personali
  • Le credenziali Strava vengono archiviate in modo sicuro nel gestore credenziali del tuo sistema operativo (Gestione credenziali di Windows o Portachiavi macOS) — mai in un file di testo in chiaro
  • I client secret non vengono mai incorporati nell'app desktop — l'autenticazione è delegata a un proxy lato server
  • Puoi disconnetterti e revocare l'accesso in qualsiasi momento dalle Impostazioni di VeloLoop o dalla pagina delle app connesse su Strava