62 lines
2.7 KiB
Markdown
62 lines
2.7 KiB
Markdown
# YouTube Personal — Baseline protégée 18.7.5
|
|
|
|
## Statut
|
|
|
|
Cette version est la référence fonctionnelle validée pour le démarrage vidéo Windows.
|
|
Elle ne doit pas être remplacée par une réécriture du pipeline de démarrage sans test comparatif et possibilité de retour arrière.
|
|
|
|
## Fichiers protégés
|
|
|
|
- `lib/screens/video_player_page.dart`
|
|
- `lib/services/windows_hd_service.dart`
|
|
|
|
## Comportement à préserver
|
|
|
|
1. Au clic sur une vidéo sous Windows, tenter d'abord le démarrage rapide 360p muxé.
|
|
2. Ne pas bloquer le premier affichage sur le téléchargement complet de la vidéo et de l'audio.
|
|
3. En cas d'échec du chemin rapide, conserver un fallback yt-dlp robuste.
|
|
4. Si la qualité cible est supérieure à 360p, préparer la HD en arrière-plan puis basculer à la position courante.
|
|
5. Si 360p est explicitement sélectionné, ne pas lancer de préparation HD inutile.
|
|
6. Une bascule de qualité ne doit pas incrémenter le compteur personnel de vues.
|
|
7. Ne pas réintroduire le relais Range `yt-dlp HttpFD` de la 18.7.4 comme chemin principal : il a provoqué des HTTP 403 et des timeouts de 30 s.
|
|
|
|
## Règles obligatoires pour les évolutions futures
|
|
|
|
Avant toute modification touchant le lecteur Windows :
|
|
|
|
1. Conserver cette archive intacte comme point de retour arrière.
|
|
2. Faire une modification minimale et localisée.
|
|
3. Ne pas réécrire `WindowsHdService` ou le démarrage du `VideoPlayerPage` si l'évolution demandée ne concerne pas directement le pipeline vidéo.
|
|
4. Vérifier le diff contre cette baseline avant livraison.
|
|
5. Tester au minimum une vidéo non mise en cache.
|
|
6. Vérifier que la première image apparaît avant de valider la modification.
|
|
7. Vérifier les logs `[HD-WINDOWS]`, `[HD-PROGRESSIVE]` et `[YT-PLAYER]` en cas de changement du pipeline.
|
|
8. Si une régression apparaît, restaurer immédiatement cette baseline avant de poursuivre.
|
|
9. Toute livraison doit contenir uniquement les fichiers modifiés/ajoutés avec chemins relatifs au projet.
|
|
|
|
## Régressions connues à ne pas réintroduire
|
|
|
|
### 18.7.2 / ancien chemin lent
|
|
Le lecteur pouvait attendre le téléchargement complet d'environ 20 MiB de vidéo + 10 MiB d'audio avant de commencer la lecture 360p.
|
|
|
|
### 18.7.4
|
|
Le relais Range basé sur `yt-dlp HttpFD` a produit :
|
|
|
|
```text
|
|
HTTP Error 403: Forbidden
|
|
0 octet fourni
|
|
Timeout 30 secondes
|
|
```
|
|
|
|
Ce chemin ne doit pas redevenir le démarrage principal.
|
|
|
|
## Restauration
|
|
|
|
Depuis le dossier extrait de cette baseline :
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File .\restore_18_7_5.ps1 -ProjectPath "D:\07-Logiciels\23-youtube_personal"
|
|
```
|
|
|
|
Le script crée d'abord une sauvegarde des fichiers actuels avant de remettre les deux fichiers protégés.
|