Lecteur Windows Media Convention de travail BITS
Lecteur Windows Media pouvez télécharger et ajouter automatiquement des éléments multimédias numériques à la bibliothèque si vous utilisez Service de transfert intelligent en arrière-plan (BITS). Pour tirer parti de cette fonctionnalité, vous devez ajouter votre travail à la file d’attente de transfert BITS et appeler méthode ibackgroundcopyjob :: SetDescription, en fournissant une chaîne de description qui utilise le format correct.
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 Windows Media utilise pour identifier le service.
-
Moteur
-
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.
-
Bonhomme
-
Titre du contenu.
-
Macauley
-
Durée du contenu.
-
Audience
-
Évaluation du contenu.
Remarques
lorsque Lecteur Windows Media 10 ou une version ultérieure utilise le service 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 de chaque travail. si la chaîne de description correspond à la convention attendue, Lecteur Windows Media télécharge le contenu.
Vous devez ajouter un seul fichier multimédia numérique à télécharger pour chaque travail BITS.
une fois que vous avez démarré une tâche BITS à l’aide de cette convention, vous devez laisser Lecteur Windows Media terminer la tâche. Lecteur Windows Media supprime également la tâche de la file d’attente BITS, déplace le fichier téléchargé vers l’emplacement où l’extraction de musique est enregistrée et ajoute le fichier téléchargé à la bibliothèque.
Le paramètre ServiceId doit contenir une valeur différente de zéro 32 bits. 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 méthode 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 relatives au contenu. Vous pouvez récupérer ces valeurs à partir de votre page Web de boutique en ligne à l’aide de DownloadItem. getItemInfo. Vous pouvez récupérer la collection de téléchargements appropriée en appelant downloadmanager. getDownloadCollection et en fournissant ServiceId comme paramètre de l’ensemble.
Lecteur Windows Media inspecte la file d’attente BITS régulièrement pendant que le lecteur est en cours d’exécution. pour vous assurer que Lecteur Windows Media vérifie la file d’attente BITS pour les travaux de téléchargement, 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 |
|---|---|---|
| RefreshDownload | DWORD | spécifie si Lecteur Windows Media doit 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 joueur 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 tâches BITS qui Lecteur Windows Media ne se termine pas, mais pour lesquelles il affiche simplement des informations d’état :
::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.