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