Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

👣 StepMate Front

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_back API 서버
  • Google OAuth 클라이언트 설정

현재 프로젝트의 Dart SDK 요구 버전은 pubspec.yaml의 environment 항목에서 확인할 수 있습니다.


▶️ 시작하기

flutter pub get
flutter run

연결 가능한 기기가 여러 개인 경우 다음 명령으로 대상을 확인하고 지정할 수 있습니다.

flutter devices
flutter run -d <device-id>

BLE 기능은 실제 모바일 기기에서 테스트하는 것을 권장합니다.


🌐 API 서버 설정

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 로그인 설정

Google Cloud Console에서 Android OAuth 클라이언트를 생성하고 다음 값을 등록해야 합니다.

  • Android 패키지 이름: com.foothaha.stepmate_front
  • 개발 또는 배포용 인증서의 SHA-1

백엔드에도 같은 프로젝트에서 발급받은 OAuth 클라이언트 ID가 등록되어 있어야 합니다. 자세한 설정 과정은 GOOGLE_SIGNIN_SETUP.md를 참고하세요.


📡 BLE 규격

항목 값
왼쪽 기기 이름 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

👥 Contributors


mainsprout

🌱

hym7196

🎨

dusal1111

🎨

🔗 연관 저장소

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages