MediaPlayer Clase

Definición

Proporciona acceso a la funcionalidad de reproducción multimedia, como reproducir, pausar, avanzar rápido, rebobinar y volumen.

public ref class MediaPlayer sealed
public ref class MediaPlayer sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlayer final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlayer final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaPlayer
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable
function MediaPlayer()
Public NotInheritable Class MediaPlayer
Public NotInheritable Class MediaPlayer
Implements IDisposable
Herencia
Object Platform::Object IInspectable MediaPlayer
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La sección Reproducción multimedia de la documentación contiene artículos de procedimientos que proporcionan instrucciones detalladas para agregar características de reproducción multimedia a la aplicación. En la tabla siguiente se enumeran algunos de los artículos disponibles.

Tema Descripción
Reproducir audio y vídeo con MediaPlayer Muestra cómo aprovechar las nuevas características y mejoras del sistema de reproducción multimedia para aplicaciones para UWP.
Elementos multimedia, listas de reproducción y pistas Muestra cómo usar la clase MediaSource , que proporciona una manera común de hacer referencia y reproducir elementos multimedia desde diferentes orígenes, como archivos locales o remotos, y expone un modelo común para acceder a los datos multimedia, independientemente del formato multimedia subyacente.
Integrar con los controles de transporte de contenido multimedia del sistema Muestra cómo integrar la aplicación con los controles de transporte multimedia del sistema (SMTC).
Indicaciones de metadatos temporizados admitidos por el sistema Describe cómo aprovechar varios formatos de metadatos cronomeados que se pueden incrustar en archivos multimedia o secuencias.
Crear, programar y administrar interrupciones multimedia Muestra cómo crear, programar y administrar interrupciones multimedia en la aplicación de reproducción multimedia.
Reproducir elementos multimedia en segundo plano Muestra cómo configurar la aplicación para que los medios sigan reproduciéndose cuando la aplicación pase del primer plano al fondo.
Streaming adaptable Describe cómo agregar la reproducción de contenido multimedia de streaming adaptable a una Plataforma universal de Windows (UWP).
Transmitir contenido multimedia Muestra cómo convertir elementos multimedia en dispositivos remotos desde una aplicación universal de Windows.
DRM de PlayReady Describe cómo agregar contenido multimedia protegido de PlayReady a la aplicación Plataforma universal de Windows (UWP).

Muestras de SDK de reproducción de contenido multimedia

Las siguientes muestras de SDK presentan las características de reproducción de contenido multimedia disponibles para las aplicaciones para UWP en Windows 10. Usa estas muestras para ver las API de reproducción de contenido multimedia que se usan en contexto o como punto de partida para tu propia aplicación.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1511 10586 AddAudioEffect
1511 10586 RemoveAllEffects
1607 14393 AddVideoEffect
1607 14393 AudioBalance
1607 14393 AudioDevice
1607 14393 BreakManager
1607 14393 CommandManager
1607 14393 GetAsCastingSource
1607 14393 GetSurface
1607 14393 IsMutedChanged
1607 14393 PlaybackSession
1607 14393 RealTimePlayback
1607 14393 SetSurfaceSize
1607 14393 SourceChanged
1607 14393 StepBackwardOneFrame
1607 14393 StepForwardOneFrame
1607 14393 StereoscopicVideoRenderMode
1607 14393 TimelineController
1607 14393 TimelineControllerPositionOffset
1703 15063 CopyFrameToStereoscopicVideoSurfaces
1703 15063 CopyFrameToVideoSurface(IDirect3DSurface)
1703 15063 CopyFrameToVideoSurface(IDirect3DSurface,Rect)
1703 15063 IsVideoFrameServerEnabled
1703 15063 VideoFrameAvailable
1709 16299 RenderSubtitlesToSurface(IDirect3DSurface)
1709 16299 RenderSubtitlesToSurface(IDirect3DSurface,Rect)
1709 16299 SubtitleFrameChanged
1803 17134 AudioStateMonitor

Constructores

MediaPlayer()

Inicializa una nueva instancia del objeto MediaPlayer .

Propiedades

AudioBalance

Obtiene o establece una proporción de volumen entre altavoces estéreo.

AudioCategory

Obtiene o establece el tipo de audio que se está reproduciéndose actualmente.

AudioDevice

Obtiene o establece el objeto DeviceInformation que representa el dispositivo de audio utilizado por MediaPlayer para representar audio.

AudioDeviceType

Obtiene o establece un valor que describe el uso principal del dispositivo que se usa para reproducir audio.

AudioStateMonitor

Obtiene un objeto AudioStateMonitor que permite a una aplicación para UWP determinar si alguna de las secuencias de audio de la aplicación se está silenciando o si el sistema reduce su volumen.

AutoPlay

Obtiene o establece un valor booleano que indica si la reproducción se inicia automáticamente después de cargar el medio.

BreakManager

Obtiene el MediaBreakManager asociado a MediaPlayer, que proporciona información y control sobre las interrupciones multimedia del reproductor.

BufferingProgress

Obtiene la cantidad de almacenamiento en búfer que se completa para el contenido multimedia, expresado como porcentaje.

Nota

MediaPlayer.BufferingProgress puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.BufferingProgress .

CanPause

Obtiene un valor booleano que indica si el medio se puede pausar.

Nota

MediaPlayer.CanPause puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.CanPause .

CanSeek

Obtiene un valor booleano que indica si el medio admite la búsqueda de una posición específica.

Nota

MediaPlayer.CanSeek puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.CanSeek .

CommandManager

Obtiene el MediaPlaybackCommandManager asociado a MediaPlayer, que especifica el comportamiento de y recibe eventos de los controles de transporte multimedia del sistema.

CurrentState

Obtiene el estado actual de la reproducción multimedia.

Nota

MediaPlayer.CurrentState puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.PlaybackState .

IsLoopingEnabled

Obtiene o establece un valor booleano que indica si el medio se reproducirá en un bucle repetido.

IsMuted

Obtiene o establece un valor booleano que indica si el audio está silenciado.

IsProtected

Obtiene un valor booleano que indica si el contenido está protegido por un sistema de administración de derechos digitales.

Nota

MediaPlayer.IsProtected puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad IsProtected .

IsVideoFrameServerEnabled

Obtiene un valor que indica si el modo de servidor de fotogramas de vídeo está habilitado para la instancia de MediaPlayer .

NaturalDuration

Obtiene la duración real del medio sin aplicar playbackRate.

Nota

MediaPlayer.NaturalDuration puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.NaturalDuration .

PlaybackMediaMarkers

Obtiene la colección de marcadores de escala de tiempo para el medio.

Nota

MediaPlayer.PlaybackMediaMarkers puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, use MediaPlaybackItem.TimedMetadataTracks para administrar datos o indicaciones de texto. Para obtener más información, vea Reproducción multimedia con MediaSource.

PlaybackRate

Obtiene o establece la velocidad de reproducción, expresada como una relación.

Nota

MediaPlayer.PlaybackRate puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.PlaybackRate .

PlaybackSession

Obtiene la clase MediaPlaybackSession asociada a MediaPlayer, que proporciona información sobre el estado de la sesión de reproducción actual y proporciona eventos para responder a los cambios en el estado de sesión de reproducción.

Position

Obtiene o establece la posición de reproducción dentro del medio.

Nota

MediaPlayer.Position puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa la propiedad MediaPlaybackSession.Position .

ProtectionManager

Obtiene o establece el administrador de protección de contenido para el medio.

RealTimePlayback

Obtiene o establece un valor que configura MediaPlayer para escenarios en tiempo real, como el streaming en vivo de vídeo.

Source

Establece el origen de reproducción del reproductor multimedia.

StereoscopicVideoRenderMode

Obtiene o establece un valor que indica el modo de representación estereoscópico actual.

SystemMediaTransportControls

Obtiene una instancia de la clase SystemMediaTransportControls para habilitar el control de usuario de la reproducción de MediaPlayer y para permitir que la aplicación muestre información sobre el contenido que se está reproduciendo actualmente en la interfaz de usuario del sistema.

TimelineController

Obtiene o establece el objeto MediaTimelineController asociado a MediaPlayer. Utilice esta propiedad para manipular varias instancias de MediaPlayer con un único control de escala de tiempo.

TimelineControllerPositionOffset

Obtiene o establece el desplazamiento aplicado a la posición de MediaTimelineController asociado a MediaPlayer.

Volume

Obtiene o establece el volumen de audio para la reproducción multimedia.

Métodos

AddAudioEffect(String, Boolean, IPropertySet)

Agrega un efecto de audio a la secuencia de reproducción de MediaPlayer.

AddVideoEffect(String, Boolean, IPropertySet)

Aplica un efecto de vídeo a la reproducción multimedia.

Close()

Cierra MediaPlayer y elimina los recursos asociados.

CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface)

Copia el fotograma de vídeo mostrado actualmente por mediaPlayer en los dos objetos IDirect3DSurface proporcionados que representan el ojo izquierdo y el contenido del ojo derecho de un fotograma de vídeo estereoscópico.

CopyFrameToVideoSurface(IDirect3DSurface)

Copia el fotograma de vídeo actual de MediaPlayer en el IDirect3DSurface proporcionado.

CopyFrameToVideoSurface(IDirect3DSurface, Rect)

Copia el fotograma de vídeo actual de MediaPlayer en el rectángulo de destino especificado dentro del IDirect3DSurface proporcionado.

Dispose()

Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.

GetAsCastingSource()

Obtiene un Objeto CastingSource que representa mediaPlayer, que permite que su contenido multimedia se convierta en otros dispositivos.

GetSurface(Compositor)

Obtiene un objeto MediaPlayerSurface para MediaPlayer, que permite representar el contenido del reproductor mediante un compositor sin depender del marco XAML.

Pause()

Pausa la reproducción multimedia.

Play()

Inicia la reproducción multimedia.

RemoveAllEffects()

Quita todos los efectos de la secuencia de reproducción de MediaPlayer.

RenderSubtitlesToSurface(IDirect3DSurface)

Solicita al sistema que represente el texto del subtítulo actual en el IDirect3DSurface proporcionado.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Solicita al sistema que represente el texto del subtítulo actual en el rectángulo de destino especificado dentro del IDirect3DSurface proporcionado.

SetFileSource(IStorageFile)

Establezca el origen multimedia en un archivo.

Nota

MediaPlayer.SetFileSource puede modificarse o no estar disponible después de Windows 10. En su lugar, usa MediaPlayer.Source .

SetMediaSource(IMediaSource)

Establece el origen multimedia para la reproducción.

Nota

MediaPlayer.SetMediaSource puede modificarse o no estar disponible después de Windows 10. En su lugar, usa MediaPlayer.Source .

SetStreamSource(IRandomAccessStream)

Establece el origen multimedia en una secuencia.

Nota

MediaPlayer.SetMediaSource puede modificarse o no estar disponible después de Windows 10. En su lugar, usa MediaPlayer.Source .

SetSurfaceSize(Size)

Establece el tamaño de la superficie de composición devuelta por GetSurface.

SetUriSource(Uri)

Establece la ruta de acceso al medio.

Nota

MediaPlayer.SetUriSource puede modificarse o no estar disponible después de Windows 10. En su lugar, usa MediaPlayer.Source .

StepBackwardOneFrame()

Hace que la posición de reproducción de MediaPlayer se mueva hacia atrás en .042 segundos, que corresponde a un fotograma a 24 fps, independientemente de la velocidad de fotogramas real del contenido que se reproduce.

StepForwardOneFrame()

Hace que MediaPlayer avance en el medio actual en un fotograma.

Eventos

BufferingEnded

Se produce cuando ha finalizado el almacenamiento en búfer.

Nota

MediaPlayer.BufferingEnded puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa el evento MediaPlaybackSession.BufferingEnded .

BufferingStarted

Se produce cuando se ha iniciado el almacenamiento en búfer.

Nota

MediaPlayer.BufferingStarted puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa el evento MediaPlaybackSession.BufferingStarted .

CurrentStateChanged

Se produce cuando el estado del reproductor multimedia ha cambiado.

Nota

MediaPlayer.CurrentStateChanged puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa el evento MediaPlaybackSession.PlaybackStateChanged .

IsMutedChanged

Se produce cuando cambia el estado silenciado actual de MediaPlayer .

MediaEnded

Se produce cuando finaliza la reproducción de elementos multimedia.

MediaFailed

Se produce cuando se encuentra un error.

MediaOpened

Se produce cuando se abren elementos multimedia.

MediaPlayerRateChanged

Se produce cuando ha cambiado la velocidad de reproducción multimedia.

Nota

MediaPlayer.MediaPlayerRateChanged puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa el evento MediaPlaybackSession.PlaybackRateChanged .

PlaybackMediaMarkerReached

Se produce cuando se ha alcanzado un marcador multimedia durante la reproducción.

Nota

MediaPlayer.PlaybackMediaMarkerReached puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, use MediaPlaybackItem.TimedMetadataTracks para administrar datos o indicaciones de texto. Para obtener más información, vea Reproducción multimedia con MediaSource.

SeekCompleted

Se produce cuando ha finalizado una operación de búsqueda.

Nota

MediaPlayer.SeekCompleted puede modificarse o no estar disponible después de Windows 10, versión 1607. En su lugar, usa la propiedad MediaPlayer.PlaybackSession para obtener un objeto MediaPlaybackSession y, a continuación, usa el evento MediaPlaybackSession.SeekCompleted .

SourceChanged

Se produce cuando cambia el origen multimedia de MediaPlayer .

SubtitleFrameChanged

Se produce cuando el contenido del subtítulo actual ha cambiado mientras mediaPlayer está en modo de servidor de fotogramas.

VideoFrameAvailable

Se produce cuando IsVideoFrameServerEnabled se establece en true y hay disponible un nuevo fotograma de vídeo para su procesamiento.

VolumeChanged

Se produce cuando el volumen del audio ha cambiado.

Se aplica a