MediaCollection. Add, méthode

La méthode Add ajoute un nouvel élément multimédia ou une nouvelle sélection à la bibliothèque.

Syntaxe

retVal = MediaCollection.add(
  path
)

Paramètres

chemin d’accès [ dans]

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

Valeur de retour

Cette méthode retourne un objet multimédia .

Notes

Cette méthode charge un élément multimédia existant ou une sélection 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 le chemin d’accès local n’est pas valide, mais que la validité des fichiers multimédias numériques n’est pas vérifiée avant leur ajout à la bibliothèque.

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

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

Exemples

l’exemple de JScript Microsoft suivant ajoute trois objets multimédias à la collection de supports Lecteur Windows Media. 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 Windows Media version 7,0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

Gestion des sélections

Objet Media

Objet MediaCollection

MediaCollection. Remove

PlaylistCollection.importPlaylist

Paramètres. mediaAccessRights

Paramètres. requestMediaAccessRights