# Migracion de ExoPlayer 2.x a Media3

## Objetivo
Migrar StreamPlayer de ExoPlayer 2.18.7 a AndroidX Media3 1.5.0 para obtener:
- Soporte activo y actualizaciones de seguridad
- Mejor integracion con Android TV/Leanback
- MediaSession integrado para controles del sistema

## Version objetivo
- **Media3**: 1.5.0
- **Nueva version app**: 10.1.0 (versionCode: 100100)

---

# PASO 1: Actualizar build.gradle

## Archivo: `app/build.gradle`

### 1.1 Cambiar dependencias

**ELIMINAR estas lineas (51-55):**
```gradle
// ExoPlayer para reproducción de video
implementation 'com.google.android.exoplayer:exoplayer:2.18.7'
implementation 'com.google.android.exoplayer:extension-okhttp:2.18.7'
implementation 'com.squareup.okhttp3:okhttp:4.12.0'
implementation 'com.squareup.okhttp3:okhttp-dnsoverhttps:4.12.0'
```

**AGREGAR estas lineas en su lugar:**
```gradle
// Media3 para reproduccion de video (Android TV optimizado)
implementation 'androidx.media3:media3-exoplayer:1.5.0'
implementation 'androidx.media3:media3-exoplayer-hls:1.5.0'
implementation 'androidx.media3:media3-datasource-okhttp:1.5.0'
implementation 'androidx.media3:media3-ui:1.5.0'
implementation 'androidx.media3:media3-ui-leanback:1.5.0'
implementation 'androidx.media3:media3-session:1.5.0'

// OkHttp con DNS over HTTPS
implementation 'com.squareup.okhttp3:okhttp:4.12.0'
implementation 'com.squareup.okhttp3:okhttp-dnsoverhttps:4.12.0'
```

### 1.2 Actualizar version

**CAMBIAR (lineas 11-12):**
```gradle
versionCode 100100
versionName "10.1.0"
```

### 1.3 Actualizar compileSdk (opcional pero recomendado)

**CAMBIAR (linea 5):**
```gradle
compileSdk 34
```

**CAMBIAR (linea 10):**
```gradle
targetSdk 34
```

---

# PASO 2: Actualizar PlayerActivity.java

## Archivo: `app/src/main/java/com/streamplayer/PlayerActivity.java`

### 2.1 Cambiar TODOS los imports

**ELIMINAR estos imports (lineas 14-24):**
```java
import com.google.android.exoplayer2.ExoPlayer;
import com.google.android.exoplayer2.MediaItem;
import com.google.android.exoplayer2.PlaybackException;
import com.google.android.exoplayer2.Player;
import com.google.android.exoplayer2.DefaultRenderersFactory;
import com.google.android.exoplayer2.trackselection.DefaultTrackSelector;
import com.google.android.exoplayer2.ext.okhttp.OkHttpDataSource;
import com.google.android.exoplayer2.source.MediaSource;
import com.google.android.exoplayer2.source.hls.HlsMediaSource;
import com.google.android.exoplayer2.ui.PlayerView;
import com.google.android.exoplayer2.util.Util;
```

**AGREGAR estos imports en su lugar:**
```java
import androidx.media3.exoplayer.ExoPlayer;
import androidx.media3.common.MediaItem;
import androidx.media3.common.PlaybackException;
import androidx.media3.common.Player;
import androidx.media3.exoplayer.DefaultRenderersFactory;
import androidx.media3.exoplayer.trackselection.DefaultTrackSelector;
import androidx.media3.datasource.okhttp.OkHttpDataSource;
import androidx.media3.exoplayer.source.MediaSource;
import androidx.media3.exoplayer.hls.HlsMediaSource;
import androidx.media3.ui.PlayerView;
import androidx.media3.common.util.Util;
import androidx.annotation.OptIn;
import androidx.media3.common.util.UnstableApi;
```

### 2.2 Agregar anotacion @OptIn a la clase

**ANTES de la declaracion de clase (linea 37), AGREGAR:**
```java
@OptIn(markerClass = UnstableApi.class)
public class PlayerActivity extends AppCompatActivity {
```

Esto es necesario porque algunas APIs de Media3 estan marcadas como "unstable" pero son perfectamente funcionales.

### 2.3 Cambiar metodo buildMediaSource

**El metodo buildMediaSource (lineas 188-200) debe quedar asi:**

```java
private MediaSource buildMediaSource(MediaItem mediaItem) {
    Map<String, String> headers = new HashMap<>();
    headers.put("Referer", channelUrl);
    headers.put("Origin", "https://streamtpcloud.com");
    headers.put("Accept", "*/*");
    headers.put("Connection", "keep-alive");

    String userAgent = Util.getUserAgent(this, "StreamPlayer");

    OkHttpDataSource.Factory factory = new OkHttpDataSource.Factory(provideOkHttpClient())
            .setUserAgent(userAgent)
            .setDefaultRequestProperties(headers);
    return new HlsMediaSource.Factory(factory).createMediaSource(mediaItem);
}
```

**NOTA**: El codigo es casi identico, solo cambian los imports. Verificar que compile.

### 2.4 Verificar compatibilidad de DefaultTrackSelector

El metodo `setForceHighestSupportedBitrate(true)` sigue existiendo en Media3, no requiere cambios.

---

# PASO 3: Actualizar activity_player.xml

## Archivo: `app/src/main/res/layout/activity_player.xml`

### 3.1 Cambiar el namespace del PlayerView

**CAMBIAR (linea 10):**
```xml
<com.google.android.exoplayer2.ui.PlayerView
```

**POR:**
```xml
<androidx.media3.ui.PlayerView
```

El resto de atributos (`app:resize_mode`, `app:use_controller`) siguen funcionando igual.

---

# PASO 4: Sincronizar y Compilar

### 4.1 Sync Gradle
Ejecutar:
```bash
./gradlew --refresh-dependencies
```

### 4.2 Limpiar y compilar
```bash
./gradlew clean assembleDebug
```

### 4.3 Verificar errores
Si hay errores de compilacion, revisar:
1. Que todos los imports esten actualizados
2. Que la anotacion `@OptIn` este presente
3. Que el namespace en XML este correcto

---

# PASO 5: Testing

### 5.1 Probar en Android TV
- Instalar APK en dispositivo Android TV
- Verificar que los canales cargan correctamente
- Verificar que la calidad se mantiene en maxima
- Verificar navegacion con D-pad

### 5.2 Verificar funcionalidades
- [ ] Reproduccion de streams HLS
- [ ] Overlay de controles
- [ ] Boton "Elegir otro"
- [ ] Manejo de errores
- [ ] Reconexion tras perdida de conexion

---

# PASO 6: Commit y Release

### 6.1 Copiar APK
```bash
cp app/build/outputs/apk/debug/app-debug.apk ./StreamPlayer-v10.1.0-debug.apk
```

### 6.2 Commit
```bash
git add -A
git commit -m "Migracion de ExoPlayer 2.x a Media3 1.5.0 (v10.1.0)"
git tag v10.1.0
git push origin main
git push origin v10.1.0
```

### 6.3 Crear release en Gitea
```bash
curl -s -u renato97:wlillidan1 -X POST \
  "https://gitea.cbcren.online/api/v1/repos/renato97/app/releases" \
  -H "Content-Type: application/json" \
  -d '{
    "tag_name": "v10.1.0",
    "name": "StreamPlayer v10.1.0 - Media3",
    "body": "## Cambios\n- Migracion completa de ExoPlayer 2.x a AndroidX Media3 1.5.0\n- Mejor soporte para Android TV\n- Actualizaciones de seguridad y rendimiento",
    "prerelease": false
  }'
```

### 6.4 Subir APK
```bash
# Reemplazar {RELEASE_ID} con el ID devuelto
curl -s -u renato97:wlillidan1 -X POST \
  "https://gitea.cbcren.online/api/v1/repos/renato97/app/releases/{RELEASE_ID}/assets?name=StreamPlayer-v10.1.0.apk" \
  --data-binary @./StreamPlayer-v10.1.0-debug.apk \
  -H "Content-Type: application/vnd.android.package-archive"
```

---

# Tabla de Mapeo de Imports

| ExoPlayer 2.x | Media3 |
|---------------|--------|
| `com.google.android.exoplayer2.ExoPlayer` | `androidx.media3.exoplayer.ExoPlayer` |
| `com.google.android.exoplayer2.MediaItem` | `androidx.media3.common.MediaItem` |
| `com.google.android.exoplayer2.Player` | `androidx.media3.common.Player` |
| `com.google.android.exoplayer2.PlaybackException` | `androidx.media3.common.PlaybackException` |
| `com.google.android.exoplayer2.DefaultRenderersFactory` | `androidx.media3.exoplayer.DefaultRenderersFactory` |
| `com.google.android.exoplayer2.trackselection.DefaultTrackSelector` | `androidx.media3.exoplayer.trackselection.DefaultTrackSelector` |
| `com.google.android.exoplayer2.source.MediaSource` | `androidx.media3.exoplayer.source.MediaSource` |
| `com.google.android.exoplayer2.source.hls.HlsMediaSource` | `androidx.media3.exoplayer.hls.HlsMediaSource` |
| `com.google.android.exoplayer2.ext.okhttp.OkHttpDataSource` | `androidx.media3.datasource.okhttp.OkHttpDataSource` |
| `com.google.android.exoplayer2.ui.PlayerView` | `androidx.media3.ui.PlayerView` |
| `com.google.android.exoplayer2.util.Util` | `androidx.media3.common.util.Util` |

---

# Notas Importantes

1. **@OptIn es obligatorio**: Media3 marca algunas APIs como `@UnstableApi`. Agregar `@OptIn(markerClass = UnstableApi.class)` a la clase o metodos que usen estas APIs.

2. **No hay cambios en la logica**: La API de Media3 es casi identica a ExoPlayer 2.x. Solo cambian los packages.

3. **Leanback UI**: Agregamos `media3-ui-leanback` para futuras mejoras de Android TV, aunque por ahora usamos el PlayerView standard.

4. **MediaSession**: Agregamos `media3-session` para integracion con controles del sistema (play/pause desde el launcher de Android TV). Esto se puede implementar despues.

5. **Compatibilidad**: Media3 1.5.0 requiere minSdk 21 (igual que antes), no hay cambios de compatibilidad.

---

# Errores Comunes y Soluciones

## Error: "Cannot find symbol: class PlayerView"
**Causa**: El import o el XML tienen el namespace incorrecto.
**Solucion**: Verificar que sea `androidx.media3.ui.PlayerView` en Java y XML.

## Error: "This declaration is opt-in"
**Causa**: Falta la anotacion @OptIn.
**Solucion**: Agregar `@OptIn(markerClass = UnstableApi.class)` antes de la clase.

## Error: "Cannot resolve symbol 'HlsMediaSource'"
**Causa**: Falta la dependencia `media3-exoplayer-hls`.
**Solucion**: Verificar que `implementation 'androidx.media3:media3-exoplayer-hls:1.5.0'` este en build.gradle.

## Error: "Cannot resolve symbol 'OkHttpDataSource'"
**Causa**: Falta la dependencia `media3-datasource-okhttp`.
**Solucion**: Verificar que `implementation 'androidx.media3:media3-datasource-okhttp:1.5.0'` este en build.gradle.

---

# Checklist Final

- [ ] build.gradle: Dependencias actualizadas a Media3 1.5.0
- [ ] build.gradle: Version actualizada a 10.1.0
- [ ] PlayerActivity.java: Imports actualizados
- [ ] PlayerActivity.java: @OptIn agregado
- [ ] activity_player.xml: PlayerView namespace actualizado
- [ ] Compilacion exitosa sin errores
- [ ] Testing en dispositivo Android TV
- [ ] Commit y push realizados
- [ ] Release creado en Gitea
- [ ] APK subido al release