📋 プロジェクト概要
🎯 目的
スマートフォンのHealthアプリ(iOS HealthKit / Android Health Connect)と連携し、歩数データを自動取得してリハビリ進捗を記録するアプリです。
主な機能
- Health連携: iOS/AndroidのHealthアプリから歩数データを自動取得
- 自動同期: 5分ごとに自動で歩数データを同期
- 目標設定: 1日の歩数目標を設定(デフォルト8000歩)
- 進捗確認: 日次・週次の歩数グラフで視覚化
- エラーハンドリング: 連携失敗時の適切な通知とリトライ
- フォールバック: Health非対応時はセンサーベース歩数計を使用
対応プラットフォーム
Android 8.0+ (API 26+)
iOS 12.0+
📥 アプリのダウンロード
Android版
Android 8.0以上対応
QRコードを読み取って
ダウンロード
バージョン: 1.0.2 (Build 3)
サイズ: 55.5MB
更新日: 2025年12月
サイズ: 55.5MB
更新日: 2025年12月
📋 Android版インストール手順
-
APKファイルをダウンロード
上記のQRコードを読み取るか、「今すぐダウンロード」ボタンをタップ -
提供元不明のアプリを許可
設定 → セキュリティ → 「提供元不明のアプリ」を有効化
※Android 8.0以降は、インストール時に自動で許可画面が表示されます -
APKをインストール
ダウンロードしたAPKファイルをタップしてインストール -
アプリを起動
ホーム画面から「リハビリモニタリング」を起動
⚠️ 重要
初回起動時に各種権限(位置情報、身体活動など)の許可が求められます。すべて「許可」を選択してください。
💡 ヒント
QRコードでダウンロードする場合:
- スマホのカメラアプリを起動
- QRコードにカメラを向ける
- 表示されたリンクをタップ
- APKファイルのダウンロードが開始されます
🔗 Health連携の設定方法
✅ Health連携の重要性
Health連携は患者の歩数同期において最も重要な機能です。スマホのHealthアプリと連携することで、正確な歩数データを自動的に取得できます。
Android版 - Health Connectとの連携
-
Health Connectアプリのインストール
Google Playストアから「Health Connect」をインストール(Android 14以降) -
アプリでHealth連携を設定
プロフィール設定画面で「Health連携を設定」をタップ -
権限の許可
Health Connectの権限画面で以下を許可:- 歩数データの読み取り
- 距離データの読み取り
- 消費カロリーの読み取り
-
連携完了
「Health連携: 有効」と表示されれば成功
ℹ️ Android 13以下の場合
Google Fit APIを使用します。Google Playストアから「Google Fit」アプリをインストールし、同様の手順で連携してください。
iOS版 - HealthKitとの連携
-
ヘルスケアアプリの確認
iOSに標準搭載されている「ヘルスケア」アプリを確認 -
アプリでHealth連携を設定
プロフィール設定画面で「Health連携を設定」をタップ -
権限の許可
ヘルスケアの権限画面で「歩数」へのアクセスを許可 -
連携完了
「Health連携: 有効」と表示されれば成功
自動同期の仕組み
🔄 5分ごとの自動同期
アプリがバックグラウンドで動作している限り、5分ごとにHealthアプリから最新の歩数データを自動取得します。
- 権限あり → Healthから歩数取得(推奨)
- 権限なし → センサーベース歩数計を使用
⚠️ 注意事項
- Health連携を行わない場合、センサーベースの歩数計になります
- センサーベースはスマホを携帯している時のみカウント
- 正確な記録のため、Health連携を強く推奨します
💡 使い方
初回設定
-
アカウント登録
メールアドレスとパスワードでアカウントを作成 -
プロフィール設定
名前、年齢、目標歩数を入力 -
Health連携(推奨)
「Health連携を設定」をタップして権限を許可 -
完了
ホーム画面が表示されます
日常の使い方
📊 ホーム画面
- 今日の歩数: リアルタイムで更新される歩数
- 目標達成率: 目標に対する進捗を%で表示
- 週間グラフ: 過去7日間の歩数推移
⚙️ 設定画面
- プロフィール編集: 名前・年齢・目標歩数の変更
- Health連携: 連携の有効化・無効化
- アバター変更: プロフィール画像の設定
🔧 トラブルシューティング
歩数が更新されない場合
| 問題 | 解決策 |
|---|---|
| Health連携が無効 | 設定画面から「Health連携を設定」をタップして権限を許可 |
| Healthアプリに歩数がない | Health ConnectまたはGoogle Fitに歩数データが記録されているか確認 |
| バックグラウンド動作が停止 | スマホの省電力モードを解除、またはアプリをバッテリー最適化から除外 |
| 同期エラー | アプリを再起動、またはHealth連携を一度無効→有効に切り替え |
エラーメッセージが表示される場合
⚠️ 対処法
- 「権限が必要です」 → 設定から各種権限を許可
- 「Health APIエラー」 → Health ConnectまたはHealthアプリを最新版に更新
- 「ネットワークエラー」 → インターネット接続を確認
- 「認証エラー」 → 再ログインを試行
🛠️ 技術仕様
| 項目 | 詳細 |
|---|---|
| 開発フレームワーク | Flutter 3.x (Dart) |
| バックエンド | Firebase (Authentication, Firestore, Storage) |
| Health連携 | health パッケージ v13.2.1 |
| Android最小SDK | API 26 (Android 8.0) |
| iOS最小バージョン | iOS 12.0+ |
| APKサイズ | 約55.5MB |
| データ保存 | Cloud Firestore (暗号化済み) |
使用パッケージ
firebase_core/firebase_auth- Firebase連携cloud_firestore- データベースfirebase_storage- 画像保存health- Health API連携permission_handler- 権限管理pedometer- センサーベース歩数計(フォールバック)fl_chart- グラフ表示image_picker- 画像選択
🔒 セキュリティとプライバシー
✅ データ保護
すべての患者データは以下の方法で保護されています:
- Firebase Authenticationによるユーザー認証
- Firestore Security Rulesによるアクセス制御
- HTTPS通信による通信の暗号化
- 個人情報の最小化: 必要最小限のデータのみ保存
取得する情報
- メールアドレス(認証用)
- 名前・年齢(プロフィール)
- 歩数データ(Healthアプリから)
- プロフィール画像(任意)
データの利用目的
- リハビリテーション進捗の記録
- セラピストによる患者モニタリング(患者が担当セラピストを登録した場合のみ)
- 統計分析(匿名化済み)
⚠️ 重要
本アプリは医療機器ではありません。診断・治療の目的では使用しないでください。
📞 サポート
お問い合わせ
ℹ️ 連絡先
アプリの使い方やトラブルに関するお問い合わせは、担当セラピストまたはプロジェクト管理者にご連絡ください。
バージョン履歴
- v1.0.2 (2025年12月): Health連携機能の追加、エラーハンドリング強化
- v1.0.1: 初回リリース、基本機能実装