MediaPlayer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- 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.
- 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. |