정리 #45
이태훈이(가) 약 한달 전에 변경
h1. BBPlayer 개발 작업 보고 (2026-03-24 ~ 2026-03-25)
---
h2. 개요
|_.항목 |_.내용 | _.항목 | _.내용 |
|=.프로젝트 | =.프로젝트 | BBPlayer |
|=.작업 | =.작업 기간 | 2026-03-24 ~ 2026-03-25 |
|=.담당자 | =.담당자 | 페후 (이태훈) |
|=.문서 | =.문서 버전 | v3.7 → v4.13 |
|=.대상 | =.대상 플랫폼 | Android (주), Windows (보조) |
---
h2. 완료된 기능 구현
h3. 1. Android 터치 제스처 제어 (v3.8)
- *단일 탭*: 컨트롤 표시/숨김 토글
- *더블탭 좌*: -10초 탐색
- *더블탭 우*: +10초 탐색
- *수직 스와이프 좌반부*: 화면 밝기 조절 (@screen_brightness@ 패키지)
- *수직 스와이프 우반부*: 볼륨 조절
- *수평 스와이프*: 영상 탐색 (화면 가로 100% = 180초)
- 제스처 중 화면 중앙 아이콘+수치 오버레이 표시 (2초 자동 소멸)
---
h3. 2. Android 외부 앱에서 동영상 열기 — 인텐트 처리 (v3.9, v4.4)
- @AndroidManifest.xml@ intent-filter 추가
- @content://@ scheme 명시 + @BROWSABLE@ 카테고리
- @file://@ scheme
- @http://@ / @https://@ scheme (DS File 등 NAS 스트리밍 앱 대응)
- @MainActivity@에 @MethodChannel@ (초기 실행 URI) + @EventChannel@ (실행 중 수신) 구현
- @content://@ URI → MediaStore 경로 변환 처리
---
h3. 3. 비디오 프레임 캡처 (v4.0)
- @player.screenshot()@으로 UI 없이 순수 영상 프레임 추출
- Android/macOS: @gal@ 패키지로 갤러리 저장 (BBPlayer 앨범)
- Windows: @Pictures\BBPlayer\@ 폴더 저장
- 상단 바 카메라 버튼 / @C@ 단축키
- 저장 성공/실패 피드백 오버레이 2초 표시
- @pubspec.yaml@에 @gal: ^1.2.0@ 추가, @WRITE_EXTERNAL_STORAGE@ 권한 추가 (maxSdkVersion=29)
---
h3. 4. PIP (Picture in Picture) (v4.1, v4.2)
- @AndroidManifest.xml@에 @supportsPictureInPicture="true"@ 추가
- @MainActivity@에 PIP MethodChannel + 상태 EventChannel 구현
- 영상 실제 비율(@VideoParams.w/h@)로 @PictureInPictureParams.Rational@ 전달
- PIP 진입 시 컨트롤 전체 숨김, 해제 시 자동 복원
- *홈 버튼 자동 PIP*: 영상 재생 중일 때만 진입 (@setPlaying@ MethodChannel로 재생 상태 공유)
---
h3. 5. 재생 에러 오버레이 (v4.11)
- @player.stream.error@ 구독
- *조건부 표시*: 500ms 후에도 @duration == 0@인 경우만 표시 (파일 로드 실패)
- 재생 중 발생하는 mpv 경고성 메시지는 무시
- 에러 메시지 + 닫기 버튼 UI
---
h3. 6. 빌드 환경 개선 (v4.3, v4.5)
- *Kotlin 증분 컴파일 비활성화*: @gradle.properties@에 @kotlin.incremental=false@ 추가
- C:/D: 드라이브 경로 충돌로 발생하는 Kotlin 데몬 캐시 오류 영구 해결
- *빌드 스크립트*:
- @build_android.bat@: 빌드 후 @BBPlayer.apk@로 자동 복사 (@call flutter@ 방식)
- @build_windows.bat@: Windows 빌드 래퍼
- @CMakeLists.txt@ @BINARY_NAME@ → @BBPlayer@ 변경 (Windows EXE 파일명)
---
h3. 7. Android UI — 세로 모드 레이아웃 개선 (v4.6)
- @MediaQuery.orientation@ 감지로 세로/가로 자동 전환
- *세로 모드*: 하단 컨트롤 2줄 분리
- 1줄: 이전/±10초/재생/±10초/다음 (중앙 정렬)
- 2줄: 시간 표시 + 반복/셔플/속도 + 음소거 (볼륨 슬라이더 제거 — 제스처로 대체)
- *가로 모드*: 기존 단일 행 유지
---
h3. 8. 시스템 UI Inset 적용 (v4.7)
- 상단/하단/좌우 @MediaQuery.of(context).padding@ 반영
- 네비게이션 바, 노치, 카메라 컷아웃에 의한 버튼 가림 현상 해결
- 가로/세로 모드 모두 자동 대응
---
h3. 9. 수평 스와이프 실시간 영상 프리뷰 (v4.8, v4.12, v4.13)
- 드래그 중 @_player.seek()@ 실시간 호출 → 영상 프레임 이동
- 드래그 시작 시 플레이어 @pause()@ (오디오 완전 차단)
- 드래그 종료 시 재생 중이었던 경우만 @play()@ 재개
- *볼륨 소실 버그 수정*: @setVolume(0)@ 호출 시 @stream.volume@이 @_volume@을 덮어쓰는 문제 → @_horizDragSavedVolume@에 사전 저장 방식으로 해결
---
h3. 10. 방향키 탐색 진행바 즉각 반영 (v4.9)
- @_seekPreviewPos@ 상태 변수 추가
- 방향키 입력 시 진행바 즉시 이동 (디바운스 400ms 완료 이전에도 시각 반영)
- 실제 @seek()@ 완료 후 @_seekPreviewPos = null@ 초기화
---
h3. 11. 컨트롤 숨김 시 터치 차단 (v4.10)
- @AnimatedOpacity@를 @IgnorePointer@로 래핑
- 컨트롤 비표시 상태에서 진행바·버튼 터치 이벤트 완전 차단
- 비디오 영역 탭(컨트롤 재표시)은 @GestureDetector@가 상위 레이어에 있어 정상 동작 유지
---
h2. 버그 수정
|_.#|_.증상|_.원인|_.해결| | _.# | _.증상 | _.원인 | _.해결 |
|=.1| | =.1 | 빌드 오류: @VideoParams.width@ not found | media_kit 실제 필드명은 @w@/@h@ | @params.w@, @params.h@로 수정 |
|=.2| | =.2 | 빌드 오류: @Gal.putImageBytes name:@ not found | gal 1.9.1 API에 @name@ 파라미터 없음 | @name:@ 제거, @album:@ 만 사용 |
|=.3| | =.3 | 빌드 오류: Kotlin 데몬 캐시 충돌 | C:/D: 드라이브 다른 루트 경로 충돌 | @kotlin.incremental=false@ |
|=.4| | =.4 | BBPlayer가 연결앱 목록에 미표시 | scheme 미명시, BROWSABLE 누락 | intent-filter 전면 재작성 |
|=.5| | =.5 | DS File에서 BBPlayer 미표시 | http/https scheme intent-filter 없음 | http/https intent-filter 추가 |
|=.6| | =.6 | 스와이프 후 소리가 사라짐 | @setVolume(0)@ 시 @_volume@ 상태 덮어쓰기 | @_horizDragSavedVolume@ 사전 저장 |
|=.7| | =.7 | 스와이프 중 빠른 오디오 재생 | seek 사이 버퍼 오디오 재생 | pause/resume 방식으로 전환 |
|=.8| | =.8 | 컨트롤 숨김 상태에서 진행바 터치됨 | @AnimatedOpacity@는 터치 미차단 | @IgnorePointer@ 래핑 |
|=.9| | =.9 | 정상 재생 중 에러 오버레이 표시 | @stream.error@ 경고 메시지도 표시 | @duration==0@ 조건 추가 |
|=.10| | =.10 | 버튼이 시스템 UI에 가려짐 | 고정 padding 사용 | @MediaQuery.padding@ 동적 반영 |
|=.11| | =.11 | @build_android.bat@ 중간 종료 | @flutter@가 @.bat@이므로 @call@ 필요 | @call flutter@ 로 수정 |
---
h2. 변경된 파일 목록
|_.파일|_.변경 내용| | _.파일 | _.변경 내용 |
| @lib/screens/player_screen.dart@ | 터치 제스처, PIP, 캡처, 에러 오버레이, 세로 UI, inset, 프리뷰 seek, IgnorePointer 등 |
| @lib/screens/home_screen.dart@ | 인텐트 수신 처리 (MethodChannel + EventChannel) |
| @android/app/src/main/AndroidManifest.xml@ | intent-filter, PIP, 권한 추가 |
| @android/app/src/main/kotlin/.../MainActivity.kt@ | PIP 채널, 인텐트 채널 전면 재작성 |
| @android/app/build.gradle.kts@ | Java/Kotlin 버전 11 설정 |
| @android/gradle.properties@ | @kotlin.incremental=false@ 추가 |
| @windows/CMakeLists.txt@ | @BINARY_NAME@ → @BBPlayer@ |
| @pubspec.yaml@ | @screen_brightness@, @gal@ 패키지 추가 |
| @build_android.bat@ | 신규 생성 |
| @build_windows.bat@ | 신규 생성 |
| @개발계획서.md@ | v4.13으로 업데이트 |
뒤로