MediaPlayer Clase

Definición

Espacio de nombres:

Windows.Media.Playback

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

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)]
/// [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)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable

function MediaPlayer()

Public NotInheritable Class MediaPlayer
Implements IDisposable

Herencia

Object Platform::Object IInspectable MediaPlayer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

Implementaciones

IClosable IDisposable

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.

• Muestra de streaming adaptable
• Muestra de audio en segundo plano
• Ejemplo de transporte multimedia del sistema
• Muestra de reproducción de vídeo de 360 grados
• Ejemplo de reproducción multimedia en segundo plano
• Ejemplo de sincronización de reproducción de vídeo

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.