Lecteur multimédia Windows convention de travail BITS

  • Article

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Lecteur multimédia Windows pouvez télécharger et ajouter automatiquement des éléments multimédias numériques à la bibliothèque si vous utilisez le service BITS (Background Intelligent Transfer Service). Pour tirer parti de cette fonctionnalité, vous devez ajouter votre travail à la file d’attente de transfert BITS et appeler IBackgroundCopyJob::SetDescription, en fournissant une chaîne de description qui utilise le format approprié.

Notes

Cette section décrit les fonctionnalités conçues pour être utilisées par les magasins en ligne. L’utilisation de cette fonctionnalité en dehors du contexte d’un magasin en ligne n’est pas prise en charge.

 

Syntaxe

::WMP_JOB:1:serviceId:Provider:AlbumArtist:AlbumTitle:TrackNumber:Title:Duration:Rating

Paramètres

serviceId

Valeur 32 bits générée de manière aléatoire que Lecteur multimédia Windows utilise pour identifier le service.

Fournisseur

Nom du fournisseur. Cette valeur doit correspondre à un nom de clé de magasin en ligne valide.

AlbumArtist

Nom de l’artiste principal de l’album.

AlbumTitle

Titre de l’album.

TrackNumber

Numéro de piste du CD.

Titre

Titre du contenu.

Durée

Durée du contenu.

Évaluation

Évaluation du contenu.

Notes

Lorsque Lecteur multimédia Windows 10 ou version ultérieure utilise BITS pour télécharger du contenu, il énumère les travaux dans la file d’attente de transfert et inspecte la chaîne de description pour chaque travail. Si la chaîne de description correspond à la convention attendue, Lecteur multimédia Windows télécharge le contenu.

Vous ne devez ajouter qu’un seul fichier multimédia numérique à télécharger à chaque travail BITS.

Après avoir démarré un travail BITS à l’aide de cette convention, vous devez laisser Lecteur multimédia Windows terminer le travail. Lecteur multimédia Windows supprime également le travail de la file d’attente BITS, déplace le fichier téléchargé vers l’emplacement d’enregistrement de la musique extraite et ajoute le fichier téléchargé à la bibliothèque.

Le paramètre serviceId doit contenir une valeur 32 bits différente de zéro. Nous vous recommandons d’utiliser la fonction CryptGenRandom pour créer cette valeur.

Le nom de fichier que vous spécifiez à l’aide du paramètre localName de IBackgroundCopyJob::AddFile doit avoir une extension de nom de fichier .wma, .wmv, .mp3 ou .asf.

Les paramètres restants sont conçus pour contenir des valeurs de métadonnées liées au contenu. Vous pouvez récupérer ces valeurs à partir de la page web de votre magasin en ligne à l’aide de DownloadItem.getItemInfo. Vous pouvez récupérer la collection de téléchargement correcte en appelant DownloadManager.getDownloadCollection et en fournissant serviceId comme paramètre collectionId .

Lecteur multimédia Windows inspecte régulièrement la file d’attente BITS pendant l’exécution du lecteur. Pour vous assurer que Lecteur multimédia Windows recherche des travaux de téléchargement dans la file d’attente BITS, vous devez créer une valeur dans la sous-clé de Registre suivante :

HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services

La valeur doit être créée comme suit.

Name Type Description
ActualiserTélécharger DWORD Spécifie si Lecteur multimédia Windows devez inspecter la file d’attente BITS pour les travaux de téléchargement. Si la valeur est égale à zéro, le Lecteur n’inspecte pas la file d’attente BITS. Le Lecteur doit inspecter la file d’attente si la valeur est différente de zéro.

 

Vous pouvez utiliser la syntaxe alternative suivante pour ajouter des travaux BITS qui Lecteur multimédia Windows ne se terminent pas, mais pour lesquels il affiche simplement status informations :

::WMP_STATUS:1:serviceId:Provider:AlbumArtist:AlbumTitle:TrackNumber:Title:Duration:Rating

Lorsque vous utilisez la syntaxe précédente, vous devez écrire du code pour terminer le téléchargement BITS, organiser le contenu sur l’ordinateur de l’utilisateur et ajouter le contenu à la bibliothèque, si vous le souhaitez.

CryptGenRandom

DownloadItem.getItemInfo

DownloadManager.getDownloadCollection

Référence pour les magasins en ligne de type 2