b23042andClaude Fable 5
ca591ce58c
- station_lookahead(route.json): 배지 전방 오프셋 — 미설정/0=드론 연직(기존), N=진행방향 +N(m), "auto"=짐벌 피치·AGL 기반 자동. 연속 모델(유효 주시거리 = N − 노선이격 초과분)로 접근 구간에서 멈춤·점프 없이 측점값 연속 진행 - 노선밖 판정도 시선 기준: 화면이 노선을 비추기 시작하면 배지가 측점값으로 조기 전환, '노선밖 ○m' 도 시선 지점 기준 - 시점·시설물 마크와 배지 기준 통일(viewChain): 오프셋 활성 시 물리(드론 연직) 폴백 금지 — 구간 밖 시설물은 해당 세그먼트 바에 미표시(귀덕천교 사례), 세그먼트별 진단 로그(표본 Δ) 추가 - 스테이션바 1km(1+000) 단위 측점 마크: 측점값 라벨만 표시(이름 라벨·그룹핑 제외), 기존 마크와 겹침 시 생략 + 양끝 100m 내 시설물 없으면 시작/끝 스테이션 표시 - 팬(회전) 지연 이질감 보정: 프레임 동기 데이터의 POI 라벨 화면 EMA 우회(즉시 투영) + 자세 선행(attLeadSec) 파라미터 — 짐벌 로그 기록 지연 상쇄(위치는 유지, 자세만 앞선 시점 참조), 카메라 패널 슬라이더(-1~+1s) - 배지 시선 중심 자동 모드: AGL/tan|짐벌피치| 전방 주시거리(상한 350m), 진행방향 = 카메라 yaw·노선 접선 내적 - 기타: sen H 최대 100mm, F2 개발자 모드 토글(직전 커밋 누락분 아님 — 이번 범위) - 데이터 작업(코드 외): 경로 1-2/1-3/2 카메라·화면설정 산출 적용(yawOffset 실측, 경로표고 중앙값) 및 1-3 기존 시각보정 복원 — docs/history 참조 - docs/history: 작업 이력 15건 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
abcvideo
2GB 이상 대용량 동영상을 웹 브라우저에서 안정적으로 재생하는 특화 기능 탑재 플레이어.
기능
- 2GB+ 동영상 안정 재생 (로컬 파일 직접 재생 + 서버 Range Request/HLS)
- 프레임 단위 추출 (Canvas 즉시 미리보기)
- 키보드 단축키로 프레임/초/장면 단위 이동
- 자막형 / 메모형 텍스트 오버레이 + VTT/SRT/JSON/CSV 내보내기
- HLS 자동 변환 (FFmpeg 설치 시)
사전 요구사항
- Node.js 20+ LTS
- FFmpeg (HLS 변환 및 프레임 정확 추출 시 필요)
- Windows: https://ffmpeg.org/download.html 에서 다운로드 후 PATH 등록
- macOS:
brew install ffmpeg - Ubuntu:
sudo apt install ffmpeg
설치 및 실행
# 1. 의존성 설치
npm install
# 2. 환경변수 설정
cp server/.env.example server/.env
# 3. 개발 서버 실행 (클라이언트 + 서버 동시)
npm run dev
브라우저에서 http://localhost:5173 접속
개발 서버 포트
| 서비스 | 포트 |
|---|---|
| 클라이언트 (Vite) | 5173 |
| 백엔드 API | 3001 |
키보드 단축키
| 키 | 동작 |
|---|---|
| Space | 재생 / 일시정지 |
| ← / → | 5초 뒤로 / 앞으로 |
| J / L | 10초 뒤로 / 앞으로 |
| , / . | 이전 / 다음 프레임 (일시정지 시) |
| [ / ] | ±30초 이동 |
| 0 ~ 9 | 10% 단위 탐색 |
| F | 전체화면 |
| M | 음소거 |
| + / - | 재생속도 조절 |
| Shift+S | 프레임 캡처 |
| Shift+M | 메모 추가 |
| ? | 단축키 도움말 |
프로젝트 구조
abcvideo/
├── client/ # React 18 + Video.js 8 프론트엔드
├── server/ # Node.js + Express 백엔드
├── shared/ # 공유 TypeScript 타입
└── storage/ # 런타임 생성 (영상, HLS, 프레임)
환경변수 (server/.env)
| 변수 | 기본값 | 설명 |
|---|---|---|
| PORT | 3001 | 서버 포트 |
| FFMPEG_PATH | ffmpeg | FFmpeg 실행 경로 |
| MAX_UPLOAD_SIZE | 21474836480 | 최대 업로드 크기 (20GB) |
| HLS_SEGMENT_TIME | 6 | HLS 세그먼트 길이 (초) |