Método MediaCollection.add

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método add agrega un nuevo elemento multimedia o lista de reproducción a la biblioteca.

Sintaxis

retVal = MediaCollection.add(
  path
)

Parámetros

ruta de acceso [in]

Cadena que contiene la ruta de acceso.

Valor devuelto

Este método devuelve un objeto Media .

Observaciones

Este método carga un elemento multimedia existente o una lista de reproducción en la biblioteca, dada una ruta de acceso a un archivo. Este método no mueve ni cambia el archivo. Este método produce un error si se proporciona una ruta de acceso local no válida, pero los archivos multimedia digitales no se comprueban si son válidos antes de agregarlos a la biblioteca.

Este método acepta archivos estáticos y automáticos de lista de reproducción. PlaylistCollection. El método importPlaylist también se puede usar para agregar una lista de reproducción estática a la biblioteca.

Para usar este método, se requiere acceso completo a la biblioteca. Para obtener más información, vea Acceso a bibliotecas.

Ejemplos

En el siguiente ejemplo de Microsoft JScript se agregan tres objetos multimedia a la colección de medios Reproductor multimedia de Windows. El objeto Player se creó 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");

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Administrar listas de reproducción

Objeto Media

Objeto MediaCollection

MediaCollection.remove

PlaylistCollection.importPlaylist

Settings.mediaAccessRights

Settings.requestMediaAccessRights