feat: 暂停显示选集、亮度音量手势调节、播放进度续播

docs/superpowers/plans/2026-05-27-player-enhancements.md

@@ -0,0 +1,85 @@
+# Player Enhancements Implementation Plan
+
+> **Goal:** Add pause-to-show-controls, brightness/volume gestures, and playback position resume to PlayerActivity.
+
+**Architecture:** Touch gesture detection on playerView, ExoPlayer listener for pause state, PlayHistory entity extension for position, AudioManager for volume, Window attributes for brightness.
+
+**Tech Stack:** Kotlin, Android, ExoPlayer Media3, Room, AudioManager
+
+---
+
+### Task 1: Add playbackPosition to PlayHistory entity and DAO
+
+**Files:**
+- Modify: `app/src/main/java/com/videoapp/tv/data/PlayHistory.kt`
+- Modify: `app/src/main/java/com/videoapp/tv/data/PlayHistoryDao.kt`
+
+- [ ] **Step 1: Add playbackPosition field to PlayHistory entity**
+
+Add `val playbackPosition: Long? = null` to the data class. Since the DB is `fallbackToDestructiveMigration()`, no migration needed.
+
+- [ ] **Step 2: Add updatePosition method to PlayHistoryDao**
+
+```kotlin
+@Query("UPDATE play_history SET playbackPosition = :position WHERE id = :id")
+suspend fun updatePosition(id: Long, position: Long)
+```
+
+### Task 2: Save and resume playback position in PlayerActivity
+
+**Files:**
+- Modify: `app/src/main/java/com/videoapp/tv/PlayerActivity.kt`
+- Modify: `app/src/main/java/com/videoapp/tv/ui/SearchFragment.kt`
+
+- [ ] **Step 1: Add fields and read resume position**
+
+Add `resumePosition: Long?` field, read from intent `"resume_position"`.
+
+- [ ] **Step 2: Modify playWithExoPlayer to seek to saved position**
+
+After `prepare()`, add a listener to seek to `resumePosition` when ready, then clear `resumePosition`.
+
+- [ ] **Step 3: Add periodic position saving**
+
+Add a `positionSaveHandler` and `positionSaveRunnable` that saves current position every 5 seconds.
+
+- [ ] **Step 4: Save position on pause/destroy**
+
+In `onPause` and `onDestroy`, save current playback position before releasing player.
+
+- [ ] **Step 5: Pass playbackPosition from SearchFragment**
+
+In `openPlayerFromHistory`, pass `playHistory.playbackPosition` as `"resume_position"`.
+
+### Task 3: Pause shows controls
+
+**Files:**
+- Modify: `app/src/main/java/com/videoapp/tv/PlayerActivity.kt`
+
+- [ ] **Step 1: Add ExoPlayer Listener for playWhenReady changes**
+
+In `initExoPlayer`, add a `Player.Listener` that calls `showControls()` on pause and restarts auto-hide on play.
+
+### Task 4: Brightness/Volume touch gestures
+
+**Files:**
+- Modify: `app/src/main/java/com/videoapp/tv/PlayerActivity.kt`
+- Modify: `app/src/main/res/layout/activity_player.xml`
+
+- [ ] **Step 1: Replace click listener with touch listener on playerView**
+
+Replace `OnClickListener` with `OnTouchListener`. Track `startY`, `isAdjusting`, `isBrightnessMode`, `startBrightness`, `startVolume`.
+
+- [ ] **Step 2: Handle ACTION_DOWN / MOVE / UP**
+
+- DOWN: record startY, check x < width/2 for brightness mode
+- MOVE: calculate delta, adjust brightness or volume, show indicator
+- UP: if delta < threshold (20px), treat as click → toggleControls
+
+- [ ] **Step 3: Add floating indicator overlay TextView in layout**
+
+Add a `brightness_volume_indicator` TextView to activity_player.xml, centered, initially GONE.
+
+- [ ] **Step 4: Implement showIndicator method**
+
+Show the indicator with current brightness/volume percentage for 1 second after adjustment stops.