Administrar elementos multimedia

  • Artículo

[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.

Un objeto Media representa un elemento multimedia. Tiene propiedades y métodos que puede usar para recuperar información y mostrarla al usuario, o para realizar diferentes acciones en función del valor que recupere.

Gran parte del trabajo con objetos Media implica metadatos sobre el contenido del elemento multimedia, denominados atributos. En el tema Atributos de elemento multimedia se describe cómo leer y cambiar los valores de atributo. Además de este tema, consulte las Directrices de uso de metadatos de Windows Media en el sitio web de Microsoft para obtener más información sobre los atributos y su uso.

El objeto Media tiene propiedades y métodos que recuperan algunos atributos directamente, como el nombre o la duración del elemento. En el caso de los elementos de vídeo, puede recuperar el alto y el ancho de la imagen, y puede recuperar información de marcador en función del nombre o índice de un marcador. También puede determinar si un elemento multimedia determinado se incluye en una lista de reproducción determinada.

Recuperar un objeto multimedia

Puede acceder rápidamente al elemento multimedia actual mediante el Reproductor. currentMedia , propiedad.

En este tema, el objeto Player se definió de la siguiente manera:

AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;

En el siguiente ejemplo de C# se recupera un objeto Media que representa el elemento actual.

IWMPMedia media;
media = Player.currentMedia;

Puede crear un nuevo elemento multimedia a partir de un archivo multimedia digital mediante el Reproductor. método newMedia . El método pasa la ruta de acceso url a un archivo multimedia digital y devuelve una referencia al nuevo objeto Media . El método no agrega el nuevo objeto a la biblioteca directamente. Sin embargo, puede pasar el objeto a la lista de reproducción. Método appendItem o lista de reproducción. Método insertItem .

En el ejemplo de C# siguiente se crea un objeto Media basado en uno de los ejemplos de medios digitales instalados con el SDK de Reproductor multimedia de Windows.

IWMPMedia media;
media = Player.newMedia("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

Nota:

Debe incluir dos caracteres de barra diagonal inversa (\) (o usar el carácter @ en C#) en una cadena para representar un carácter de barra diagonal inversa real. Esto se debe a que C# usa un solo carácter de barra diagonal inversa para definir una secuencia de escape.

 

Puede crear un nuevo elemento multimedia a partir de un archivo multimedia digital y agregarlo a la biblioteca en un paso mediante MediaCollection. método add . Como el Jugador. newMedia , el método add toma una ruta de acceso a un archivo multimedia digital.

En el ejemplo de C# siguiente se crea un objeto Media basado en uno de los archivos de ejemplo del SDK y se agrega ese objeto a la biblioteca.

IWMPMedia media;
media = Player.mediaCollection.add("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

Puede recuperar un objeto Media que representa un elemento multimedia en una lista de reproducción mediante la lista de reproducción. método item . En el siguiente ejemplo de C# se recupera el sexto elemento multimedia de la lista de reproducción actual.

IWMPMedia media;
media = Player.currentPlaylist.get_Item(5);

Controls.currentItem

Administración de listas de reproducción

Media (objeto)

MediaCollection.add

Player.currentMedia

Player.newMedia

Playlist.item

Trabajar con la biblioteca