Metodo MediaCollection.add

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo add aggiunge un nuovo elemento multimediale o una playlist alla libreria.

Sintassi

retVal = MediaCollection.add(
  path
)

Parametri

path [in]

Stringa contenente il percorso.

Valore restituito

Questo metodo restituisce un oggetto Media .

Commenti

Questo metodo carica un elemento multimediale o una playlist esistente nella raccolta, dato un percorso a un file. Questo metodo non sposta o modifica il file. Questo metodo ha esito negativo se viene specificato un percorso locale non valido, ma i file multimediali digitali non vengono verificati per la validità prima che vengano aggiunti alla libreria.

Questo metodo accetta sia file statici che auto playlist. PlaylistCollection. Il metodo importPlaylist può essere usato anche per aggiungere una playlist statica alla libreria.

Per usare questo metodo, è necessario l'accesso completo alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

Nell'esempio seguente di Microsoft JScript vengono aggiunti tre oggetti multimediali alla raccolta di supporti Lettore multimediale Windows. L'oggetto Player è stato creato con 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");

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Gestione delle playlist

Oggetto Media

Oggetto MediaCollection

MediaCollection.remove

PlaylistCollection.importPlaylist

Settings.mediaAccessRights

Settings.requestMediaAccessRights