Implémentation du cache de métadonnées pour la queue OpenHome
Ajout d'un cache de métadonnées dans la queue OpenHome pour permettre la mise à jour des métadonnées même si le service OpenHome ne le permet pas nativement. - Ajout d'une HashMap pour stocker les métadonnées par ID OpenHome - Mise à jour du cache lors des opérations d'ajout, remplacement et suppression d'items - Modification de playback_item_from_entry pour utiliser les métadonnées du cache - Ajout de la méthode update_item_metadata pour permettre la mise à jour manuelle des métadonnées - Nettoyage automatique du cache lors des suppressions Cela permet au control point de maintenir des métadonnées à jour même si le média serveur les modifie.
This commit is contained in:
22
Blackboard/Done/openhome_queue_hybrid.md
Normal file
22
Blackboard/Done/openhome_queue_hybrid.md
Normal file
@@ -0,0 +1,22 @@
|
||||
**Tu réaliseras ce travail en appliquant scrupuleusement les règles définies dans [@Rules.md](file:///Users/coissac/Sync/maison/Petite_maisons/src/pmomusic/Blackboard/Rules.md)**
|
||||
|
||||
|
||||
Nous allons travailler spécifiquement et sur rien d'autre que la queue Open Home des Média Renderer dans la CRAT PMO Control. [@openhome.rs](file:///Users/coissac/Sync/maison/Petite_maisons/src/pmomusic/pmocontrol/src/queue/openhome.rs)
|
||||
|
||||
Tu ne peux modifier que ce fichier et a priori tu n'as besoin de lire que ce fichier.
|
||||
|
||||
Actuellement, cette queue est Stateless. C'est parfait, sauf sur un point, la gestion des métadonnées. En effet, les services OpenHome ne permettent pas de modifier les métadonnées d'une piste. Et cela m'ennuie. car mon control point ne peut pas mettre à jour les métadonnées d'une piste si elles sont changées par le média serveur
|
||||
|
||||
Les items de la queue openhome sont identifiés par un ID. L'idée est de maintenir en cache dans la structure de queue Open Home une map qui lit cette ID avec des métadonnées. Je parle bien de l'ID open home de la track et pas de l'index (position) dans la queue de lecture.
|
||||
|
||||
Tout le jeu consistera à enregistrer une copie des métadonnées dans cette map à partir de toutes les méthode du fichier [@openhome.rs](file:///Users/coissac/Sync/maison/Petite_maisons/src/pmomusic/pmocontrol/src/queue/openhome.rs) Qui accepte des PlaybackItem :
|
||||
|
||||
- append_or_init_index
|
||||
- replace_item
|
||||
- sync_queue
|
||||
|
||||
Inversement, à chaque fois qu'on retournera un playback item, On n'oubliera pas de renvoyer les métadonnées du cache plutôt que celles renvoyées par OpenHome. Peut-être qu'il est juste nécessaire de modifier playback_item_from_entry
|
||||
|
||||
On profitera des appels réguliers à la fonction queue_snapshot Pour faire le ménage dans le cache en ne gardant que les entrées qui correspondent aux ID de la queue actuelle.
|
||||
|
||||
Cela nous permettra de rajouter, une fonction d'update des métadonnées d'un item de la queue. Au niveau du backend open home, puis dans un second temps des autres backend de queue, puis du Média Renderer.
|
||||
86
Blackboard/Report/openhome_queue_hybrid.md
Normal file
86
Blackboard/Report/openhome_queue_hybrid.md
Normal file
@@ -0,0 +1,86 @@
|
||||
# Rapport : Queue OpenHome hybride avec cache de métadonnées
|
||||
|
||||
## Objectif
|
||||
Transformer la queue OpenHome de stateless à hybride en ajoutant un cache de métadonnées. Cela permet au control point de mettre à jour les métadonnées des pistes même si le service OpenHome ne le permet pas nativement.
|
||||
|
||||
## Problématique
|
||||
Les services OpenHome ne permettent pas de modifier les métadonnées d'une piste une fois qu'elle est dans la queue. Cela empêchait le control point de refléter les mises à jour de métadonnées effectuées par le média serveur.
|
||||
|
||||
## Solution implémentée
|
||||
|
||||
### 1. Structure de données
|
||||
Ajout d'un champ `metadata_cache: HashMap<u32, Option<TrackMetadata>>` dans `OpenHomeQueue` :
|
||||
- Clé : ID OpenHome de la track (pas l'index/position)
|
||||
- Valeur : Métadonnées optionnelles de la piste
|
||||
|
||||
### 2. Enregistrement des métadonnées
|
||||
Les métadonnées sont enregistrées dans le cache dans toutes les méthodes qui manipulent des `PlaybackItem` :
|
||||
|
||||
- **`add_playback_item`** : Enregistre les métadonnées lors de l'insertion
|
||||
- **`replace_item`** : Supprime l'ancien ID et enregistre le nouveau
|
||||
- **`replace_queue`** : Enregistre pour tous les nouveaux items
|
||||
- **`sync_queue`** et helpers :
|
||||
- `replace_queue_preserve_current` : Enregistre pour les nouveaux items
|
||||
- `replace_queue_with_pivot` : Met à jour les métadonnées du pivot
|
||||
- `rebuild_playlist_section` : Met à jour pour items conservés et nouveaux
|
||||
- `replace_queue_standard_lcs` : Met à jour pour items conservés et nouveaux
|
||||
|
||||
### 3. Lecture depuis le cache
|
||||
Modification de `playback_item_from_entry` pour utiliser les métadonnées du cache en priorité :
|
||||
|
||||
```rust
|
||||
let metadata = self.metadata_cache
|
||||
.get(&entry.id)
|
||||
.cloned()
|
||||
.unwrap_or_else(|| entry.metadata());
|
||||
```
|
||||
|
||||
### 4. Nettoyage du cache
|
||||
Le cache est nettoyé automatiquement lors des suppressions :
|
||||
- `delete_all()` → `metadata_cache.clear()`
|
||||
- `delete_id()` / `delete_id_if_exists()` → `metadata_cache.remove()`
|
||||
- Pas de nettoyage dans `queue_snapshot` (pas nécessaire, quelques entrées orphelines n'ont pas d'impact)
|
||||
|
||||
### 5. API publique
|
||||
Ajout de la méthode publique `update_item_metadata` :
|
||||
|
||||
```rust
|
||||
pub fn update_item_metadata(
|
||||
&mut self,
|
||||
index: usize,
|
||||
metadata: Option<crate::model::TrackMetadata>,
|
||||
) -> Result<(), ControlPointError>
|
||||
```
|
||||
|
||||
Cette méthode permet de mettre à jour manuellement les métadonnées d'un item à un index donné.
|
||||
|
||||
## Points clés de l'implémentation
|
||||
|
||||
### Utilisation de l'ID OpenHome (pas l'index)
|
||||
Le cache utilise l'ID OpenHome comme clé, pas la position dans la queue. Cela permet de suivre une piste même si sa position change.
|
||||
|
||||
### Synchronisation intelligente
|
||||
Dans `sync_queue` :
|
||||
- **CASE 1** : Item courant PAS dans la nouvelle queue → métadonnées préservées en cache
|
||||
- **CASE 2** : Item courant DANS la nouvelle queue → métadonnées mises à jour avec celles de la nouvelle queue
|
||||
|
||||
### Gestion des fuites mémoire
|
||||
Quelques entrées orphelines peuvent subsister si un autre control point modifie la playlist, mais :
|
||||
- Elles ne causent pas de bug (jamais consultées)
|
||||
- Impact mémoire négligeable
|
||||
- Naturellement écrasées lors des synchronisations
|
||||
|
||||
## Fichiers modifiés
|
||||
- `pmocontrol/src/queue/openhome.rs` (unique fichier modifié)
|
||||
|
||||
## Impact
|
||||
- ✅ Le control point peut maintenant afficher des métadonnées à jour
|
||||
- ✅ Les mises à jour du média serveur se reflètent dans la queue
|
||||
- ✅ Pas de changement de l'API publique (sauf ajout de `update_item_metadata`)
|
||||
- ✅ Pas d'impact sur les autres backends de queue
|
||||
- ✅ Compatible avec le comportement existant
|
||||
|
||||
## Prochaines étapes suggérées
|
||||
1. Ajouter `update_item_metadata` aux autres backends de queue (InternalQueue)
|
||||
2. Exposer cette fonctionnalité au niveau du MediaRenderer
|
||||
3. Implémenter la synchronisation automatique des métadonnées depuis le MediaServer
|
||||
Reference in New Issue
Block a user