StepMate 스마트 인솔과 연동되는 Flutter 모바일 애플리케이션입니다. 좌·우 인솔의 압력 및 IMU 센서 데이터를 BLE로 수신하고, 보행 기록과 분석 결과를 확인하거나 센서 데이터를 활용한 게임을 즐길 수 있습니다.
- Google 계정 로그인
- 좌·우 스마트 인솔 BLE 검색, 연결 및 자동 재연결
- 실시간 압력·IMU 센서 데이터 수신
- 러닝 세션 시작 및 종료
- 일별·월별 운동 기록과 보행 분석 조회
- 목표 및 연속 운동 기록 관리
- 리듬 게임, 코인 런, 보물찾기 게임
- 게임 점수 저장 및 랭킹 조회
- Flutter / Dart
- Provider
- flutter_blue_plus
- Google Sign-In
- Flame
- HTTP
- Flutter SDK
- Android Studio 또는 Xcode
- BLE를 지원하는 실제 모바일 기기
- 실행 중인
stepmate_backAPI 서버 - Google OAuth 클라이언트 설정
현재 프로젝트의 Dart SDK 요구 버전은 pubspec.yaml의 environment 항목에서 확인할 수 있습니다.
flutter pub get
flutter run연결 가능한 기기가 여러 개인 경우 다음 명령으로 대상을 확인하고 지정할 수 있습니다.
flutter devices
flutter run -d <device-id>BLE 기능은 실제 모바일 기기에서 테스트하는 것을 권장합니다.
API 기본 주소는 lib/core/constants/api_config.dart에서 결정됩니다. 실행 시 API_BASE_URL을 전달하면 코드 수정 없이 서버 주소를 변경할 수 있습니다.
flutter run --dart-define=API_BASE_URL=http://192.168.0.10:8080- Android 에뮬레이터에서 PC의 로컬 서버에 접근할 때:
http://10.0.2.2:8080 - iOS 시뮬레이터에서 로컬 서버에 접근할 때:
http://localhost:8080 - 실제 기기에서 접근할 때: 같은 네트워크에 있는 PC의 LAN IP 사용
운영 및 개발 서버 주소는 저장소에 직접 작성하기보다 --dart-define으로 주입하는 것을 권장합니다.
Google Cloud Console에서 Android OAuth 클라이언트를 생성하고 다음 값을 등록해야 합니다.
- Android 패키지 이름:
com.foothaha.stepmate_front - 개발 또는 배포용 인증서의 SHA-1
백엔드에도 같은 프로젝트에서 발급받은 OAuth 클라이언트 ID가 등록되어 있어야 합니다. 자세한 설정 과정은 GOOGLE_SIGNIN_SETUP.md를 참고하세요.
| 항목 | 값 |
|---|---|
| 왼쪽 기기 이름 | StepMate-Left |
| 오른쪽 기기 이름 | StepMate-Right |
| Service UUID | 19B10000-E8F2-537E-4F6C-D104768A1214 |
| Characteristic UUID | 19B10001-E8F2-537E-4F6C-D104768A1214 |
| 데이터 수신 방식 | Notify |
펌웨어가 보내는 센서 데이터는 다음 순서의 CSV 문자열입니다.
p1,p2,p3,p4,p5,ax,ay,az,gx,gy,gz,mx,my,mz
lib/
├─ core/ # API 주소, 상수, 테마
├─ game/ # Flame 게임 및 컴포넌트
├─ models/ # 사용자, 운동, 센서 데이터 모델
├─ providers/ # 인증, 보행, 목표 상태 관리
├─ screens/ # 앱 화면
├─ services/ # API, 인증, BLE, 센서 서비스
└─ widgets/ # 공통 위젯
flutter analyze
flutter test
flutter clean|
mainsprout 🌱 |
hym7196 🎨 |
dusal1111 🎨 |
- Backend: FootHaHa/stepmate_back
- Board: FootHaHa/stepmate_board