Files
iptv-android-tv-hermes/README_INSTALLATION_YOUTUBE_MINIPLAYER.md
T

67 lines
3.0 KiB
Markdown

# Patch HERMES Android TV — Mini lecteur YouTube discret
Ce ZIP contient uniquement les fichiers ajoutés/modifiés pour ajouter un mini lecteur YouTube visible au-dessus du lecteur TV existant.
## Fichiers ajoutés/modifiés
### Version principale du projet
- `12-IPTV Andoid TV HERMES/app/src/main/java/ma/tkgraph/xtreamtv/ui/components/YoutubeMiniPlayer.kt`
- `12-IPTV Andoid TV HERMES/app/src/main/java/ma/tkgraph/xtreamtv/ui/screens/PlayerScreen.kt`
### Copie miroir incluse dans ton ZIP d'origine
Le ZIP d'origine contenait aussi une copie interne du projet dans `app/app/`. Pour éviter le grand cirque Android Studio, les mêmes fichiers sont aussi fournis ici :
- `12-IPTV Andoid TV HERMES/app/app/src/main/java/ma/tkgraph/xtreamtv/ui/components/YoutubeMiniPlayer.kt`
- `12-IPTV Andoid TV HERMES/app/app/src/main/java/ma/tkgraph/xtreamtv/ui/screens/PlayerScreen.kt`
Si ton projet est ouvert depuis le dossier racine `12-IPTV Andoid TV HERMES`, la version importante est `app/src/...`.
Si ton projet est ouvert depuis `12-IPTV Andoid TV HERMES/app`, la version importante peut être `app/app/src/...`.
## Fonctionnement
Dans l'écran de lecture TV :
- `▲` ouvre le mini lecteur YouTube.
- La TV reste affichée mais son volume passe à `0`.
- Colle un lien YouTube dans le champ puis clique sur `Charger`.
- `OK` met YouTube en pause/lecture.
- `◀` recule YouTube de 10 secondes.
- `▶` avance YouTube de 10 secondes.
- `Retour` ferme le mini lecteur YouTube et remet le son TV.
## Types de liens supportés
Support propre avec commandes JavaScript :
- `https://www.youtube.com/watch?v=VIDEO_ID`
- `https://youtu.be/VIDEO_ID`
- `https://www.youtube.com/live/VIDEO_ID`
- `https://www.youtube.com/shorts/VIDEO_ID`
- liens avec playlist `list=...`
Les liens de chaîne type `@chaine/live` ou certaines pages YouTube peuvent s'ouvrir dans le WebView, mais les commandes avance/recul peuvent être limitées. YouTube adore compliquer ce qui devrait être simple, visiblement.
## Notes techniques
- Aucun changement Gradle ajouté.
- Aucun changement Manifest ajouté : la permission `INTERNET` existe déjà.
- Le mini lecteur utilise `WebView` + YouTube IFrame API.
- Le lecteur TV existant reste basé sur ExoPlayer / Media3.
- Le mini lecteur reste visible pour éviter le mode audio YouTube caché, qui peut poser problème avec les règles YouTube.
## Vérification
J'ai tenté une compilation Gradle dans l'environnement disponible, mais le wrapper Gradle voulait télécharger `gradle-9.1.0-bin.zip` et l'environnement n'avait pas accès à `services.gradle.org`.
Commande tentée :
```bash
./gradlew :app:compileDebugKotlin --no-daemon --stacktrace
```
Erreur rencontrée :
```text
java.net.UnknownHostException: services.gradle.org
```
Le patch a donc été préparé avec vérification statique des chemins et du code, mais il doit être compilé/testé dans ton environnement Android Studio ou sur ta machine Windows où Gradle fonctionne déjà. Comme toujours, la compilation Android choisit le moment parfait pour réclamer Internet, parce que la civilisation était trop calme.