Méthode MediaCollection.add

  • 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 méthode add ajoute un nouvel élément multimédia ou une playlist à la bibliothèque.

Syntaxe

retVal = MediaCollection.add(
  path
)

Paramètres

path [in]

Chaîne contenant le chemin d’accès.

Valeur retournée

Cette méthode renvoie un objet Media .

Notes

Cette méthode charge un élément multimédia ou une playlist existant dans la bibliothèque, en fonction d’un chemin d’accès à un fichier. Cette méthode ne déplace pas ou ne modifie pas le fichier. Cette méthode échoue si un chemin d’accès local non valide est fourni, mais la validité des fichiers multimédias numériques n’est pas vérifiée avant leur ajout à la bibliothèque.

Cette méthode accepte les fichiers de sélection statique et automatique. PlaylistCollection. La méthode importPlaylist peut également être utilisée pour ajouter une playlist statique à la bibliothèque.

Pour utiliser cette méthode, un accès complet à la bibliothèque est requis. Pour plus d’informations, consultez Accès à la bibliothèque.

Exemples

L’exemple Microsoft JScript suivant ajoute trois objets multimédias à la collection de supports Lecteur multimédia Windows. L’objet Player a été créé avec ID="Player ».

// Adding a media object using a website.
Player.mediaCollection.add("https://www.proseware.com/Media/Laure.wma");

// Adding a media object from a local network.
// You must add an escape sequence of a backslash for 
// every original backslash.
Player.mediaCollection.add("\\\\yourservername\\Public\\Jeanne.wma");

// Adding a media object from a file on a local drive.
// Be sure to add appropriate escape sequences.
Player.mediaCollection.add("C:\\WMSDK\\WMPSDK\\docs\\samples\\media\\house.wma");

Configuration requise

Condition requise Valeur
Version
 Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

Gestion des playlists

Objet Media

Objet MediaCollection

MediaCollection.remove

PlaylistCollection.importPlaylist

Settings.mediaAccessRights

Settings.requestMediaAccessRights