Conectar ao Strava
O VeloLoop grava suas pedaladas como arquivos FIT padrão que o Strava aceita. Você pode enviar pedaladas manualmente pelo site do Strava a qualquer momento. O VeloLoop também inclui integração nativa com o Strava para envios automáticos e com um clique, disponível após o proprietário do projeto configurar a conexão com a API do Strava.
Enviar para o Strava (manual)
A forma mais rápida de colocar sua pedalada no Strava — funciona para todos, sem configuração necessária:
- 1Abra o Strava no navegador e vá para a página de envio (strava.com/upload/select)
- 2Clique em "Escolher Arquivos" e selecione seu arquivo FIT em Documents/VeloLoop/Rides
- 3Defina o tipo de atividade como "Pedalada Virtual"
- 4Adicione um título e quaisquer observações
- 5Clique em Enviar
Quando a distância virtual está ativada, o VeloLoop inclui distância e velocidade estimadas no arquivo FIT, então o Strava exibirá esses valores para sua pedalada.
Integração nativa com o Strava
Nota: A integração nativa com o Strava está implementada no VeloLoop, mas requer configuração única pelo proprietário do projeto (implantação do proxy de autenticação e registro de um aplicativo na API do Strava). Quando não configurada, os recursos do Strava ficam ocultos no aplicativo. O envio completo ainda não foi verificado contra a API real do Strava.
- O VeloLoop inclui integração nativa com o Strava com autenticação OAuth 2.0, envio automático e controles de envio manual
- Este recurso requer configuração única pelo proprietário do projeto: implantação do proxy Cloudflare Worker e registro de um aplicativo na API do Strava
- Uma vez configurado, um botão "Conectar ao Strava" aparece no aplicativo após sua pedalada
- Após conectar, você pode enviar pedaladas manualmente por um botão no painel pós-pedalada, ou ativar o envio automático para que as pedaladas sejam enviadas ao Strava quando você finalizar
- O envio automático é desativado por padrão — você escolhe se deseja ativá-lo nas Configurações
- As credenciais do Strava são armazenadas com segurança no gerenciador de credenciais do seu sistema operacional (Gerenciador de Credenciais do Windows ou Chaves do macOS) — nunca em arquivo de texto
- Para desconectar: clique em Desconectar na seção Strava das Configurações — o VeloLoop revoga o acesso e remove as credenciais armazenadas
- Seus arquivos FIT são sempre mantidos localmente em Documents/VeloLoop/Rides, mesmo após o envio
- O VeloLoop rastreia envios localmente para evitar envios duplicados ao Strava
Como a conexão funciona
Uma vez que a integração com o Strava esteja habilitada na sua versão, o fluxo de conexão é:
- 1Abra o VeloLoop e finalize ou pule uma pedalada para que o painel pós-pedalada fique visível
- 2Clique em "Conectar ao Strava"
- 3Seu navegador abre a página de autorização do Strava
- 4Aprove o VeloLoop — apenas a permissão "Enviar atividades" é solicitada
- 5O navegador mostra uma página de confirmação — você pode fechá-la e voltar ao VeloLoop
- 6O VeloLoop mostra o status da conexão com o Strava e os controles de envio
Tipo de atividade
- O VeloLoop define o tipo de esporte como "VirtualRide" em todos os arquivos FIT
- Para envios manuais, escolha "Pedalada Virtual" para que o Strava trate os dados indoor corretamente
- Quando a distância virtual está ativada, o VeloLoop inclui distância e velocidade estimadas calculadas a partir dos seus dados de potência — o Strava exibirá esses valores junto com potência, cadência e frequência cardíaca
- Nenhuma coordenada GPS ou dados de elevação são gravados — isso é normal para ciclismo indoor
Problemas comuns
Atividade duplicada rejeitada
O Strava rejeita arquivos que já recebeu. Se você ver esse erro no envio manual, a pedalada já está no Strava. A integração nativa rastreia envios localmente para evitar duplicatas automaticamente.
Distância ou velocidade diferente do esperado
O VeloLoop inclui distância virtual estimada e velocidade derivada da potência usando um modelo físico de terreno plano (quando ativado nas configurações de pedalada). São estimativas, não medições GPS. O Strava pode exibir valores ligeiramente diferentes se aplicar seus próprios cálculos.
Envio travado em processamento
O Strava processa envios de forma assíncrona. O VeloLoop consulta atualizações de status (enviando, processando, sucesso ou erro). Se o status não atualizar em um minuto, verifique sua página de atividades no Strava — o envio geralmente é bem-sucedido.
Opção Strava não visível no aplicativo
A integração nativa com o Strava só fica visível quando o proprietário do projeto configurou as credenciais da API do Strava. Se você não vê a opção Strava, a integração não foi habilitada na sua versão. Você sempre pode enviar arquivos FIT manualmente pelo site do Strava.
Privacidade
- O VeloLoop solicita apenas a permissão "activity:write" — ele não lê seus dados, seguidores, rotas ou informações pessoais do Strava
- As credenciais do Strava são armazenadas com segurança no gerenciador de credenciais do seu sistema operacional (Gerenciador de Credenciais do Windows ou Chaves do macOS) — nunca em arquivo de texto
- Segredos do cliente nunca são embutidos no aplicativo — a autenticação é delegada a um proxy no servidor
- Você pode desconectar e revogar o acesso a qualquer momento pelas Configurações do VeloLoop ou pela página de aplicativos conectados do Strava