# 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.