Utilisation du modèle objet Lecteur multimédia Windows 7 ou version ultérieure

  • 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.]

La plupart des tâches que vous avez effectuées à l’aide du modèle objet de contrôle ActiveX Lecteur multimédia Windows 6.4 nécessitent une nouvelle approche. Dans de nombreux cas, les noms des propriétés, des méthodes et des événements ont changé dans le modèle objet Lecteur multimédia Windows 7 ou ultérieur. Par instance, pour spécifier le chemin du fichier dans le modèle objet version 6.4, vous définissez la propriété Player6.FileName :

WMP64.FileName = "https://www.microsoft.com/somefile.wmv";

Lorsque vous utilisez le modèle objet Lecteur multimédia Windows 7 ou version ultérieure, vous devez définir la propriété Player.URL :

WMP9.URL = "https://www.microsoft.com/somefile.wmv";

Vous pouvez également utiliser le modèle objet 10 pour obtenir un objet Media à partir de la bibliothèque, puis définir la propriété Player.currentMedia :

// Get the first media object in the media collection.
var MyMediaItem = WMP9.mediaCollection.getAll().item(0)

// Make the MyMediaItem object the current media.
WMP9.currentMedia = MyMediaItem;

La plupart des fonctionnalités du modèle objet Lecteur multimédia Windows 7 ou version ultérieure sont accessibles via la hiérarchie d’objets. Comme l’a montré l’exemple précédent, vous pouvez obtenir un objet Playlist à l’aide de la méthode getAll de l’objet mediaCollection , accessible via l’objet Player racine. Vous pouvez ensuite obtenir un objet Media particulier à partir de l’objet Playlist à l’aide de la méthode item de l’objet Playlist . Il existe cinq méthodes supplémentaires accessibles via l’objet mediaCollection qui retournent un objet Playlist ; chaque méthode vous permet de récupérer l’objet en fonction de critères spécifiques, comme le genre ou l’album.

La structure hiérarchique du modèle objet de contrôle ActiveX Lecteur multimédia Windows 7 ou version ultérieure fournit une approche plus logique de l’organisation des propriétés, des méthodes et des événements disponibles pour votre utilisation. Toutes les fonctionnalités des contrôles Player sont contenues dans l’objet Controls , toutes les fonctionnalités de la connexion réseau Player sont contenues dans l’objet Network , et ainsi de suite. Par exemple, pour démarrer la lecture de contenu à l’aide du modèle objet version 6.4, vous utilisez la méthode Player6.Play :

WMP64.Play();

Lorsque vous utilisez le modèle objet Lecteur multimédia Windows 7 ou version ultérieure, vous devez accéder à la méthode Play à l’aide de l’objet Controls :

WMP9.controls.play();

Toutefois, la profondeur du modèle objet peut entraîner des instructions de script très longues :

WMP9.currentPlaylist.appendItem(WMP9.mediaCollection.getByName("MySong").item(0));

Les instructions comme la précédente peuvent être rendues beaucoup plus simples et plus lisibles en travaillant avec des objets nommés individuels. L’exemple suivant remplace l’instruction de code précédente par la syntaxe à l’aide de variables objet distinctes :

// Store the current playlist object.
var pl = WMP9.currentPlaylist;

// Get a playlist from the media collection that contains
// one media item named "MySong".
var temp = WMP9.mediaCollection.getByName("MySong");

// Get the individual media item from the temp playlist.
var song = temp.item(0);

// Append the media item to the current playlist.
pl.appendItem(song);

Ce style de codage nécessite plus de lignes de script, mais il est beaucoup plus facile à suivre, en particulier avec les commentaires ajoutés. Il existe un autre avantage : l’objet currentPlaylist est facile à réutiliser, car il est stocké dans la variable pl.

La plupart des propriétés, méthodes et événements du modèle objet Lecteur multimédia Windows 7 ou version ultérieure définissent ou récupèrent des valeurs différentes, ou retournent des valeurs d’un type ou d’un nombre différent, par rapport aux fonctionnalités correspondantes dans le modèle objet version 6.4. Par instance, lorsque Player6.openState récupère 2, cette valeur correspond à la constante Visual Basic nsLoadingNSC, ce qui signifie que le Lecteur charge un fichier station avec une extension de nom de fichier .nsc. Mais lorsque la propriété player.openState du modèle objet Lecteur multimédia Windows 7 ou version ultérieure récupère 2, cette valeur correspond à l’état PlaylistLocating, ce qui signifie Lecteur multimédia Windows tente de localiser une playlist. En outre, la propriété Player6.openState peut récupérer sept valeurs différentes, tandis que la propriété Player.openState Lecteur multimédia Windows 7 ou version ultérieure peut récupérer 22 valeurs différentes. Veillez à faire référence à la section Référence du modèle objet pour les scripts du KIT de développement logiciel (SDK) Lecteur multimédia Windows lors de la révision du code afin d’utiliser une autre version du modèle objet.

À propos du modèle objet player

Référence du modèle objet pour les scripts

Guide de migration du modèle objet