Stravaに接続

Stravaへのアップロード（手動）

ライドをStravaに取り込む最も簡単な方法です — 設定不要で誰でも利用できます：

1. 1ブラウザでStravaを開き、アップロードページ（strava.com/upload/select）に移動します
2. 2「ファイルを選択」をクリックし、Documents/VeloLoop/RidesからFITファイルを選択します
3. 3アクティビティタイプを「Virtual Ride」に設定します
4. 4タイトルとメモを追加します
5. 5「アップロード」をクリックします

仮想距離が有効な場合、VeloLoopはFITファイルに推定距離と速度を含めるため、Stravaにこれらの値が表示されます。

内蔵Strava連携

注意： 内蔵Strava連携はVeloLoopに実装済みですが、プロジェクトオーナーによる初回セットアップ（認証プロキシのデプロイとStrava APIアプリケーションの登録）が必要です。未設定の場合、Strava機能はアプリ内で非表示になります。ライブStrava APIに対するエンドツーエンドのアップロードはまだ検証されていません。

• VeloLoopにはOAuth 2.0認証、自動アップロード、手動アップロード機能を備えた内蔵Strava連携が含まれます
• この機能を使用するには、プロジェクトオーナーによるCloudflareワーカープロキシのデプロイとStrava APIアプリケーションの登録が必要です（初回のみ）
• 設定が完了すると、ライド後にデスクトップアプリに「Stravaに接続」ボタンが表示されます
• 接続後、ライド後パネルのボタンから手動でアップロードするか、自動アップロードを有効にしてライド終了時にStravaへ自動送信できます
• 自動アップロードはデフォルトでオフです — 設定で有効にするかはご自身で選択できます
• Stravaの認証情報はOS標準の資格情報マネージャー（Windows資格情報マネージャーまたはmacOSキーチェーン）に安全に保存されます — テキストファイルには保存されません
• 接続を解除するには：設定のStravaセクションで「接続解除」をクリックしてください。VeloLoopがアクセスを取り消し、保存された認証情報を削除します
• FITファイルはアップロード後もDocuments/VeloLoop/Ridesにローカル保存されます
• VeloLoopはアップロード履歴をローカルで追跡し、Stravaへの重複送信を防止します

接続の仕組み

ビルドでStrava連携が有効になっている場合、接続フローは以下の通りです：

1. 1VeloLoopを開き、ライドを終了またはスキップしてライド後パネルを表示します
2. 2「Stravaに接続」をクリックします
3. 3ブラウザでStravaの認証ページが開きます
4. 4VeloLoopを承認します — リクエストされるのは「アクティビティのアップロード」権限のみです
5. 5ブラウザに確認ページが表示されます — ブラウザを閉じてVeloLoopに戻れます
6. 6VeloLoopにStravaの接続状態とアップロードコントロールが表示されます

アクティビティタイプ

• VeloLoopはすべてのFITファイルでスポーツタイプを「VirtualRide」に設定します
• 手動アップロードの場合は「Virtual Ride」を選択すると、Stravaがインドアデータを正しく処理します
• 仮想距離が有効な場合、VeloLoopはパワーデータから算出された推定距離と速度を含めます — Stravaではパワー、ケイデンス、心拍数と合わせて表示されます
• GPS座標や標高データは記録されません — インドアサイクリングでは通常の動作です

よくある問題