User Guide
AceCoach AI
사용 가이드
앱 설치부터 스윙 분석까지, 처음이라도 5분이면 충분합니다.
01 앱 & 웹
어디서든 분석하세요
iOS · Android 앱과 Web 대시보드를 모두 제공합니다. 모바일 앱에서 스윙을 촬영하고, 웹에서 통계를 확인하세요.
Web 대시보드
로그인 후 브라우저에서 분석 이력, 통계 차트, 커뮤니티 랭킹을 확인할 수 있습니다.
별도 설치 없이 바로 사용 가능합니다.
별도 설치 없이 바로 사용 가능합니다.
iOS 앱
iOS 16.0 이상 권장
- MediaPipe Pose Landmarker 기반 33개 관절 감지
- AVFoundation 실시간 카메라 처리
- 스켈레톤 오버레이 녹화 후 합성
- TTS 음성 피드백 (AVSpeechSynthesizer)
- 자동 줌 · 자동 로그인 지원
- Apple Watch 연동 — 워치에서 녹화 원격 제어 및 실시간 상태 확인
Android 앱
Android 8.0 (API 26) 이상 권장
- MediaPipe Pose Landmarker 기반 33개 관절 감지
- CameraX 실시간 카메라 처리
- MediaCodec 실시간 스켈레톤 합성
- TTS 음성 피드백 (TextToSpeech)
- 자동 줌 · 자동 로그인 지원
02 시작하기
계정 없이도 바로 체험
회원가입 없이 비회원 모드로 먼저 체험하고, 결과를 저장하려면 무료로 가입하세요.
1
비회원 모드 체험
앱 시작 화면에서 비회원모드 체험하기를 탭하면 로그인 없이 스윙 분석을 즉시 사용할 수 있습니다. 분석 결과는 기기에 임시 저장됩니다.
TIP 분석 결과를 영구 저장하려면 회원 전환이 필요합니다.
2
무료 회원가입
이메일 + 비밀번호로 10초 만에 가입할 수 있습니다. 비회원으로 분석한 기록도 가입 후 한 번에 내 계정으로 옮길 수 있습니다.
3
카메라 권한 허용
스윙 분석을 위해 카메라 접근 권한이 필요합니다. 앱 첫 실행 시 권한 요청 팝업이 표시되면 허용을 선택하세요.
주의 권한을 거부하면 분석 기능을 사용할 수 없습니다. 설정 앱에서 다시 허용할 수 있습니다.
03 분석 절차
스윙 분석 5단계
앱에서 스윙을 촬영하는 것부터 결과를 확인하는 것까지 전체 흐름입니다.
1
스윙 타입 선택
홈 화면에서 분석할 스윙 종류를 선택합니다.
포핸드 / 백핸드 / 서브 중 하나를 선택하면 해당 타입에 최적화된 기준값으로 분석이 진행됩니다.
포핸드 / 백핸드 / 서브 중 하나를 선택하면 해당 타입에 최적화된 기준값으로 분석이 진행됩니다.
2
촬영 위치 설정
스마트폰을 삼각대 또는 지면에 고정하고 전신이 모두 보이도록 맞추세요. 카메라로부터 2~4m 거리, 허리~가슴 높이에서 수평으로 두는 것이 최적입니다.
카메라는 공이 날아가는 방향과 직각인 측면, 스윙하는 쪽에 두세요. 오른손잡이 기준 포핸드·서브는 오른쪽, 백핸드는 왼쪽입니다(왼손잡이는 반대). 대각선으로 촬영한다면 측면에서 30° 이내로 두세요.
기록을 비교하려면 매번 같은 위치·거리에서 촬영하고, 역광이나 어두운 환경을 피하면 더 정확하게 감지됩니다.
카메라는 공이 날아가는 방향과 직각인 측면, 스윙하는 쪽에 두세요. 오른손잡이 기준 포핸드·서브는 오른쪽, 백핸드는 왼쪽입니다(왼손잡이는 반대). 대각선으로 촬영한다면 측면에서 30° 이내로 두세요.
기록을 비교하려면 매번 같은 위치·거리에서 촬영하고, 역광이나 어두운 환경을 피하면 더 정확하게 감지됩니다.
TIP 실외 촬영 시 태양을 등지면 화면이 밝아져 인식률이 높아집니다.
3
자동 줌 & 녹화 시작
카메라가 스켈레톤을 인식하면 자동으로 줌을 조절하여 신체가 화면의 30~80% 범위에 들어오도록 맞춥니다. 범위에 들어오면 분석 시작 버튼이 활성화됩니다. 버튼을 누른 후 자연스럽게 스윙하세요. 팔꿈치·무릎·손목 각도가 기준 임계값을 넘으면 스윙으로 자동 인식됩니다.
자동줌 너무 멀거나 가까우면 카메라가 자동으로 줌을 조절합니다. 별도 조작 불필요.
4
AI 분석 처리
녹화 완료 후 자동으로 AI 분석이 시작됩니다. MediaPipe / Vision 프레임워크가 각 프레임의 관절 좌표를 추출하고, 스윙 피크 프레임에서 각도를 측정하여 종합 점수를 산출합니다.
소요시간 일반적으로 10~30초 내에 완료됩니다.
5
결과 확인 및 저장
분석 결과 화면에서 종합 점수, 관절별 각도, AI 피드백을 확인할 수 있습니다. 스켈레톤이 합성된 영상도 함께 제공됩니다.
로그인 사용자는 분석 저장 버튼으로 결과를 내 이력에 영구 저장할 수 있습니다.
로그인 사용자는 분석 저장 버튼으로 결과를 내 이력에 영구 저장할 수 있습니다.
TIP 저장된 결과는 Web 대시보드에서도 확인할 수 있습니다.
04 분석 항목
무엇을 측정하나요?
스윙 피크 프레임(임팩트 순간)에서 3개 관절 각도와 종합 점수를 산출합니다.
팔꿈치 각도 (Elbow Angle)
어깨·팔꿈치·손목 세 점을 연결한 각도입니다. 임팩트 시 팔이 얼마나 펴지는지, 또는 굽혀지는지를 측정합니다.
포핸드 권장: 150° ~ 170°
무릎 각도 (Knee Angle)
엉덩이·무릎·발목 세 점을 연결한 각도입니다. 하체 굴곡과 체중 이동의 적절성을 나타냅니다.
일반 권장: 130° ~ 160°
손목 각도 (Wrist Angle)
팔꿈치·손목·손가락 끝 세 점을 연결한 각도입니다. 임팩트 순간 손목의 스냅과 라켓 면 각도를 반영합니다.
포핸드 권장: 160° ~ 175°
종합 자세 점수 (Score)
3개 관절 각도의 기준값 대비 편차를 가중 평균하여 0~100점으로 환산합니다. 높을수록 이상적인 폼입니다.
목표: 80점 이상
05 스윙 타입
4가지 스윙을 분석합니다
각 스윙 타입마다 최적 각도 기준값이 다르게 적용됩니다. 백핸드는 양손·한손을 별도로 선택할 수 있습니다.
| 스윙 타입 | 팔꿈치 권장 | 무릎 권장 | 손목 권장 | 특징 |
|---|---|---|---|---|
| FOREHAND | 150° ~ 170° | 130° ~ 160° | 160° ~ 175° | 임팩트 시 팔 신전, 하체 안정성 중요 |
| TWO_HANDED_BACKHAND | 155° ~ 175° | 130° ~ 155° | 155° ~ 170° | 양손 백핸드, 어깨 회전 및 양팔 협력 중요 |
| ONE_HANDED_BACKHAND | 155° ~ 178° | 130° ~ 155° | 150° ~ 168° | 한손 백핸드, 팔 신전 및 손목 안정성 중요 |
| SERVE | 160° ~ 180° | 120° ~ 150° | 140° ~ 165° | 트로피 포지션→임팩트 구간 분석, 무릎 굴곡 큼 |
06 점수 기준
점수는 어떻게 해석하나요?
0~100점 사이로 산출되며, 각도 편차가 작을수록 높은 점수를 받습니다.
점수 산출 방식
각 관절(팔꿈치·무릎·손목)의 측정값이 권장 범위 중앙값과 얼마나 가까운지 계산합니다.
편차가 클수록 감점이 증가하며, 3개 관절 점수를 가중 평균(팔꿈치 40% · 무릎 30% · 손목 30%)하여 최종 점수를 산출합니다.
관절 감지 신뢰도가 낮을 경우 해당 관절은 점수 계산에서 제외될 수 있습니다.
편차가 클수록 감점이 증가하며, 3개 관절 점수를 가중 평균(팔꿈치 40% · 무릎 30% · 손목 30%)하여 최종 점수를 산출합니다.
관절 감지 신뢰도가 낮을 경우 해당 관절은 점수 계산에서 제외될 수 있습니다.
07 Apple Watch
워치로 원격 제어하세요
iPhone과 페어링된 Apple Watch로 분석 녹화를 원격 시작·종료하고 실시간 상태를 손목에서 확인할 수 있습니다.
1
Watch 앱 설치 & 연결 확인
iPhone의 Apple Watch 앱에서 AceCoach Watch 앱을 설치합니다. iPhone과 Apple Watch가 같은 Wi-Fi 또는 Bluetooth 근거리에 있어야 합니다. 워치 앱을 열면 상단에 연결됨 상태가 초록 점으로 표시됩니다.
요구사항 iPhone이 AceCoach 분석 화면에 열려 있어야 연동이 활성화됩니다.
2
워치에서 녹화 시작
Apple Watch 화면에서 위치 안내와 현재 신체 커버리지(%)를 실시간으로 확인합니다. 준비가 되면 ▶ 시작 버튼을 탭하면 iPhone이 즉시 녹화를 시작합니다. 워치 화면에 iPhone 카메라 프리뷰가 1fps로 스트리밍됩니다.
자동 복구 워치 앱이 백그라운드였다면 열리는 순간 최신 상태를 자동 수신합니다.
3
실시간 상태 모니터링
녹화 중 워치 화면 우측 상단에 빨간 점 + 경과 시간이 표시됩니다. 분석 단계(대기·녹화·처리 중 등)가 Phase 뱃지로 실시간 업데이트됩니다.
4
워치에서 녹화 종료
워치 화면 하단의 ■ 종료 버튼을 탭하면 iPhone이 녹화를 마치고 AI 분석을 자동 시작합니다. 분석 완료 결과는 iPhone에서 확인합니다.
오프라인 전달 워치와 iPhone이 일시적으로 연결이 끊겨도 명령은 자동으로 재전달됩니다.
08 이력 & 통계
성장을 추적하세요
저장된 분석 결과로 다양한 통계를 확인할 수 있습니다. Web 대시보드 또는 앱의 이력 화면에서 확인하세요.
분석 이력
저장된 모든 분석 결과를 날짜순으로 확인합니다. 스윙 타입·최소 점수 필터로 원하는 기록만 골라볼 수 있습니다. 앱에서도 영상을 바로 재생할 수 있으며, 더 상세한 분석은 웹(acecoach.weare.kr/history)에서 확인하세요.
스윙 속도 분석
분석 상세 화면에서 손목 관절의 프레임 간 이동 속도를 기반으로 산출된 스윙 속도 지표를 확인할 수 있습니다. 최근 5회 스윙의 속도 트렌드를 차트로 시각화하여 파워 변화를 추적하세요.
측정방법 손목(index 15/16) 랜드마크의 정규화 속도를 기준으로 산출합니다.
주간 · 월별 통계
최근 7일 일별 평균 점수, 최근 6개월 월별 추이를 인터랙티브 차트(Chart.js)로 시각화합니다. 성장세와 슬럼프를 한눈에 파악하세요.
커뮤니티 랭킹
전체 회원의 최고 점수 기반 순위를 확인합니다. 랭킹은 최고 점수 → 평균 점수 순으로 집계됩니다. 비로그인 상태에서도 전체 순위 조회가 가능합니다.
10 자주 묻는 질문
FAQ
사용 중 궁금한 점을 확인하세요.
스윙이 감지되지 않는다고 나옵니다. 어떻게 해야 하나요?
전신이 화면에 들어오도록 카메라 거리를 조정하세요. 어두운 환경이나 복잡한 배경에서는 관절 감지 정확도가 낮아질 수 있습니다. 밝은 곳에서 단색 배경 앞에 서서 다시 시도해보세요. 감지 실패 시 화면에 오류 메시지와 함께 다시 시도 버튼이 표시됩니다.
어느 각도에서 촬영해야 가장 정확한가요?
스윙하는 쪽 측면이 가장 정확합니다(오른손잡이 기준 포핸드·서브는 오른쪽, 백핸드는 왼쪽). AI는 화면에 보이는 모습으로 관절 각도를 재기 때문에, 정면이나 정면 대각선에서 찍으면 무릎·팔이 실제보다 펴진 것처럼 측정됩니다. 예를 들어 정면에서 30° 위치에서는 실제 140°인 무릎이 약 159°로 측정됩니다. 반대쪽 측면에서 찍으면 스윙하는 팔이 몸에 가려 측정되지 않습니다. 대각선으로 찍는다면 측면에서 30° 이내로 두세요.
비회원으로 분석한 기록을 나중에 가입 후 옮길 수 있나요?
네, 가능합니다. 비회원 모드 사용 시 기기에 게스트 세션 ID가 발급됩니다. 회원가입 또는 로그인 후 데이터 귀속 기능을 사용하면 해당 세션의 분석 기록이 내 계정으로 이전됩니다.
분석 영상은 어디에 저장되나요?
스켈레톤이 합성된 분석 영상은 AceCoach 서버에 안전하게 저장됩니다. 웹 루트 외부 경로에 UUID로 난수화된 파일명으로 보관되어 직접 URL 접근이 차단됩니다. 분석 결과를 삭제하면 영상도 함께 삭제됩니다.
iOS와 Android 점수가 다르게 나올 수 있나요?
iOS와 Android 모두 MediaPipe Pose Landmarker(33개 관절)를 사용하므로 동일한 알고리즘으로 분석됩니다. 카메라 화질, 촬영 각도, 조명 등 촬영 환경 차이로 미세한 점수 차이가 발생할 수 있으나, 동일 환경에서는 결과가 일관됩니다.
자동 줌이 작동하지 않습니다.
자동 줌은 스켈레톤이 감지된 경우에만 작동합니다. 전신이 카메라에 보이도록 거리를 조정하고, 밝은 환경에서 단색 배경 앞에 서면 감지율이 높아집니다. 감지가 잘 되는 상태에서 신체가 화면의 30~80% 범위에 들어오면 분석 시작 버튼이 자동으로 활성화됩니다.
Apple Watch 앱에서 "연결 안됨"이 표시됩니다.
iPhone에서 AceCoach 앱이 실행 중이어야 하며, iPhone과 Apple Watch가 Bluetooth 또는 Wi-Fi로 근거리에 있어야 합니다. iPhone 앱의 스윙 분석 화면을 먼저 열고 워치 앱을 다시 시작해보세요. 잠시 후에도 연결이 안 된다면 두 기기 모두 Bluetooth를 껐다가 켜세요.
워치에서 시작 버튼을 눌렀는데 iPhone이 반응하지 않습니다.
iPhone 앱이 백그라운드에 있거나 스윙 분석 화면이 닫혀 있으면 잠깐 지연될 수 있습니다. WatchConnectivity가 자동으로 명령을 재전달하므로 iPhone 화면을 열면 즉시 녹화가 시작됩니다. iPhone을 포그라운드로 전환 후 다시 시도해보세요.
비밀번호를 잊어버렸습니다.
로그인 화면 하단의 비밀번호 찾기를 클릭하고 가입 이메일을 입력하면 임시 비밀번호가 발송됩니다. 로그인 후 설정 페이지에서 비밀번호를 변경하세요.
업로드 가능한 파일 크기와 형식은 무엇인가요?
허용 형식은 MP4, MOV, AVI, M4V이며 최대 크기는 200MB입니다. 파일 확장자, Content-Type, 실제 파일 시그니처(매직 바이트)를 모두 검사하므로 위조된 파일은 업로드되지 않습니다.