Player (objeto)

[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 objeto Player es el objeto raíz del control Reproductor multimedia de Windows. Admite las propiedades, los métodos y los eventos enumerados en las tablas siguientes.

El objeto Player admite las siguientes propiedades. Las propiedades marcadas con un asterisco (*) no son accesibles para las máscaras.

Propiedad	Descripción
cdromCollection	Recupera el objeto CdromCollection .
closedCaption	Recupera el objeto ClosedCaption .
Controles	Recupera el objeto Controls .
currentMedia	Especifica o recupera el objeto Media actual.
currentPlaylist	Especifica o recupera el objeto Lista de reproducción actual.
Dvd	Recupera el objeto DVD .
enableContextMenu *	Especifica o recupera un valor que indica si se va a habilitar el menú contextual, que aparece cuando se hace clic en el botón derecho del mouse.
Habilitado *	Especifica o recupera un valor que indica si el control Reproductor multimedia de Windows está habilitado.
error	Recupera el objeto Error .
Fullscreen *	Especifica o recupera un valor que indica si el contenido de vídeo se reproduce en modo de pantalla completa.
isOnline	Recupera un valor que indica si el usuario está conectado a una red.
isRemote *	Recupera un valor que indica si el control Reproductor multimedia de Windows se ejecuta en modo remoto.
mediaCollection	Recupera el objeto MediaCollection .
network	Recupera el objeto Network .
openState	Recupera un valor que indica el estado del origen de contenido.
playerApplication *	Recupera el objeto PlayerApplication cuando se ejecuta un control de Reproductor multimedia de Windows remoto.
playlistCollection	Recupera el objeto PlaylistCollection .
playState	Recupera un valor que indica el estado de la operación de Reproductor multimedia de Windows.
settings	Recupera el objeto Settings .
status	Recupera un valor que indica el estado actual de Reproductor multimedia de Windows.
stretchToFit *	Especifica o recupera un valor que indica si el vídeo se ajustará para ajustar el tamaño de la pantalla de vídeo de control de Reproductor multimedia de Windows.
uiMode *	Especifica o recupera un valor que indica qué controles se muestran en la interfaz de usuario cuando Reproductor multimedia de Windows está incrustado en una página web.
URL	Especifica o recupera el nombre del clip que se va a reproducir.
versionInfo	Recupera un valor de tipo String que especifica la versión del Reproductor multimedia de Windows.
windowlessVideo *	Especifica o recupera un valor que indica si el control Reproductor multimedia de Windows representa el vídeo en modo sin ventanas.

 

* No es accesible para las pieles.

El objeto Player admite los métodos siguientes.

Método	Descripción
close	Libera Reproductor multimedia de Windows recursos.
launchURL	Envía una dirección URL al explorador predeterminado del usuario que se va a representar.
newMedia	Crea un nuevo objeto Media .
newPlaylist	Crea un nuevo objeto Playlist .
openPlayer	Abre Reproductor multimedia de Windows mediante la dirección URL especificada.

 

El objeto Player admite los siguientes eventos. Los eventos marcados con un asterisco (*) no son accesibles para las máscaras. Para obtener información sobre cómo controlar eventos de mouse y teclado en máscaras, vea Eventos externos.

Evento	Descripción
AudioLanguageChange	Se produce cuando cambia el idioma de audio actual.
de respuesta	Se produce cuando el control Reproductor multimedia de Windows comienza o finaliza el almacenamiento en búfer.
CdromMediaChange	Se produce cuando se inserta o expulsa un CD o DVD desde una unidad de CD o DVD.
Haga clic *	Se produce cuando el usuario hace clic en un botón del mouse.
CurrentItemChange	Se produce cuando controles. currentItem cambia.
CurrentMediaItemAvailable	Se produce cuando un elemento de metadatos gráficos del elemento multimedia actual está disponible.
CurrentPlaylistChange	Se produce cuando cambia algo dentro de la lista de reproducción actual.
CurrentPlaylistItemAvailable	Se produce cuando el elemento de lista de reproducción actual está disponible.
Desconexión	Reservado para uso futuro.
DomainChange	Se produce cuando cambia el dominio de DVD.
Doubleclick *	Se produce cuando el usuario hace doble clic en un botón del mouse.
DurationUnitChange	Reservado para uso futuro.
EndOfStream	Reservado para uso futuro.
Error	Se produce cuando el control Reproductor multimedia de Windows tiene una condición de error.
Keydown *	Se produce cuando se presiona una tecla.
Keypress *	Se produce cuando se presiona una tecla y, a continuación, se libera.
Keyup *	Se produce cuando se suelta una tecla.
MarkerHit	Se produce cuando se alcanza un marcador.
MediaChange	Se produce cuando cambia un elemento multimedia.
MediaCollectionAttributeStringAdded	Se produce cuando se agrega un valor de atributo a la biblioteca.
MediaCollectionAttributeStringChanged	Se produce cuando se cambia un valor de atributo en la biblioteca.
MediaCollectionAttributeStringRemoved	Se produce cuando se quita un valor de atributo de la biblioteca.
MediaCollectionChange	Se produce cuando cambia la colección de medios.
MediaCollectionMediaAdded	Se produce cuando se agrega un elemento multimedia a la biblioteca local.
MediaCollectionMediaRemoved	Se produce cuando se quita un elemento multimedia de la biblioteca local.
MediaError	Se produce cuando el objeto Media tiene una condición de error.
ModeChange	Se produce cuando se cambia un modo de Reproductor multimedia de Windows.
Mousedown *	Se produce cuando se presiona un botón del mouse.
Mousemove *	Se produce cuando se mueve el puntero del mouse.
MouseUp *	Se produce cuando se suelta un botón del mouse.
NewStream	Reservado para uso futuro.
OpenPlaylistSwitch	Se produce cuando un título en un DVD comienza a reproducirse.
OpenStateChange	Se produce cuando el control Reproductor multimedia de Windows cambia el estado.
PlaylistChange	Se produce cuando cambia una lista de reproducción.
PlaylistCollectionChange	Se produce cuando cambia algo en la colección de listas de reproducción.
PlaylistCollectionPlaylistAdded	Se produce cuando se agrega una lista de reproducción a la colección de listas de reproducción.
PlaylistCollectionPlaylistRemoved	Se produce cuando se quita una lista de reproducción de la colección de listas de reproducción.
PlaylistCollectionPlaylistSetAsDeleted	Reservado para uso futuro.
PlayStateChange	Se produce cuando cambia el estado de reproducción del Reproductor multimedia de Windows control.
PositionChange	Se produce cuando se ha cambiado la posición actual del elemento multimedia.
ScriptCommand	Se produce cuando se recibe un comando o una dirección URL sincronizados.
StatusChange	Se produce cuando cambia el valor de la propiedad status .
StringCollectionChange	Se produce cuando cambia una colección de cadenas.
Warning (ADVERTENCIA)	Reservado para uso futuro.

 

* No es accesible para las pieles. Para obtener información sobre cómo controlar eventos de mouse y teclado en máscaras, vea Controladores de eventos de ambiente.

Cuando se inserta en una página web, se puede acceder al objeto Player mediante el valor de identificador especificado en la etiqueta OBJECT. Dentro de un archivo de definición de máscara, se obtiene acceso mediante el atributo global del reproductor . Con fines ilustrativos, el reproductor se usará como identificador de objeto en las secciones de sintaxis de referencia.

Consulte también

Referencia del modelo de objetos para scripting