Aller au contenu principal
Version: 15.x

UMS UPnP Service

UMS fournit un service UPnP étendu qui permet aux points de contrôle externes d'interagir avec des fonctionnalités supplémentaires du système.

Utilisation :​

Le service est exposé dans l'espace de noms schemas-upnp-org avec le type de service UmsExtendedServices.

Pour les points de contrôle Java en utilisant JUPnP, appelez findService sur l'UMS RemoteDevice:

Service à distance umsServicesService = remoteDevice.findService(
nouveau type de service("schemas-upnp-org", "UmsExtendedServices"));

Les actions suivantes sont disponibles via cette interface de service.

Interactions avec ma musique​

Les albums aimés peuvent être parcourus en utilisant l'objet ID MYMUSIC$ en tant que lien profond ou en naviguant vers My Albums dans le dossier racine.

Le maintien des favoris est particulièrement utile dans les grandes collections d'albums, où la navigation manuelle dans la bibliothèque complète peut prendre du temps. Une liste d'albums préférés organisée permet aux utilisateurs de revenir rapidement au contenu pertinent sans avoir à répéter des recherches étendues ou une navigation profonde dans les dossiers.

Dans la pratique, les favoris offrent les avantages suivants :

  • Accès plus rapide aux albums fréquemment joués, même dans de très grandes bibliothèques.
  • Meilleure navigation quotidienne en séparant le contenu préféré du catalogue complet.
  • Des flux de travail de lecture plus cohérents pour les clients et les automations qui dépendent des sélections d'albums stables.

Paramètres d'entrée​

Toutes les actions de cette section nécessitent un paramètre d'entrée. L'album doit être identifié par un ID MusicBrainz ou un ID de sortie Discogs. Au moins un ID est requis ; sinon, aucune action n'est effectuée.

Exemple pour la version de Madonna Like a Virgin:

AttributsTypeExemple de valeur :
Identifiant du cerveau de la musiqueTexteb69580b9-7050-3994-b544-4407a22c097a
DiscogsIdUnsignedIntegerFourBytes1069538
attention

Si les deux paramètres (MusicBrainzId et DiscogsId) ont été fournis lors de l'ajout d'un album à vos favoris, ils doivent également être fournis lorsque vous le retirez de vos favoris.

J'aime l'album​

Marque un album de musique comme aimé.

Je n'aime pas cet album​

Supprime le statut aimé d'un album de musique.

L'album est-il apprécié ?​

Vérifie si un album est actuellement marqué comme aimé. Si les identifiants MusicBrainz et Discogs sont tous deux fournis, la méthode renvoie « true » si au moins l'un des identifiants est marqué comme « aimé ».

Sauvegarde des actions​

Le service fournit des actions de sauvegarde et de restauration.

info

Une sauvegarde doit être créée avant de pouvoir effectuer une restauration.

Sauvegarde audio​

Crée une sauvegarde de la table des albums audio « appréciés », identifiés par leurs identifiants MusicBrainz ou Discogs.

Restaurer les mentions « J'aime » audio​

Restaure la table des albums favoris. Appelez Sauvegarder les mentions « J'aime » audio avant d'exécuter cette action.

Notes de sauvegarde​

Écrit les données de notation audio dans un fichier de sauvegarde contenant le hachage du fichier et la valeur de notation.

Rétablir les évaluations​

Restaure les informations d'évaluation à partir d'une sauvegarde créée avec Notes de sauvegarde.

Interactions de la bibliothèque​

Réanalyser la boutique Rescan Media​

Reporte toute la bibliothèque musicale.

Réanalyser le dossier de stockage multimédia​

Réanalyse un dossier spécifique sans récursivité. Le paramètre d'entrée doit être Identifiant d'objet du dossier.