ScriptCommand (evento) del objeto AxWindowsMediaPlayer

[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 evento ScriptCommand se produce cuando se recibe un comando sincronizado o una dirección URL.

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

Datos del evento

El controlador asociado a este evento es de tipo AxWMPLib._WMPOCXEvents_ScriptCommandEventHandler. Este controlador recibe un argumento de tipo AxWMPLib._WMPOCXEvents_ScriptCommandEvent, que contiene las siguientes propiedades relacionadas con este evento.

Propiedad	Descripción
scType	System.StringSpecifies el tipo de comando de script.
param	System.StringSpecifies el comando script.

Observaciones

Los comandos se pueden incrustar entre los sonidos e imágenes de un archivo o secuencia de Windows Media. Los comandos son un par de cadenas Unicode asociadas a una hora designada en la secuencia. Cuando la secuencia alcanza la hora asociada al comando, el control Reproductor multimedia de Windows envía un evento ScriptCommand con dos parámetros. Un parámetro especifica el tipo de comando que se envía y el otro parámetro especifica el comando. El tipo de parámetro se usa para determinar cómo se procesa el parámetro de comando. Cualquier tipo de comando se puede incrustar en un archivo o secuencia para que lo controle el evento ScriptCommand .

En la tabla siguiente se enumeran los tipos de comandos de script procesados automáticamente por Reproductor multimedia de Windows.

Tipo	Descripción
CAPTION	El control muestra el texto asociado en el elemento HTML especificado por IWMPClosedCaption. captioningId.
EVENTO	El control ejecuta instrucciones definidas para el evento especificado.
NOMBRE	El control restablece su propiedad URL , intenta abrir el archivo especificado y comienza a reproducir la nueva secuencia inmediatamente.
OPENEVENT	Almacena en búfer el comando de tipo EVENT asociado para la ejecución oportuna del script EVENT.
SYNCHRONIZEDLYRICLYRIC	El parámetro param contiene el texto líric sincronizado. Reproductor multimedia de Windows muestra el texto de la letra en el área de subtítulo cerrada de la característica Reproducción ahora.
TEXT	El control muestra el texto asociado en el elemento HTML especificado por IWMPClosedCaption. captioningId.
URL	El control abre automáticamente la dirección URL especificada con el explorador de Internet predeterminado si IWMPSettings. La propiedad invokeURLs se establece en true.

Puede insertar cualquier otro tipo de comando siempre que proporcione código para controlar el comando. Aunque el control Reproductor multimedia de Windows omite los comandos desconocidos, todavía se entregan al evento ScriptCommand.

No se llama al evento ScriptCommand si el archivo se examina en modo de reenvío rápido o rebobinado.

Los comandos URL recibidos por el control Reproductor multimedia de Windows se invocan automáticamente en el explorador web predeterminado si IWMPSettings.La propiedad invokeURLs se establece en true. Puede usar IWMPSettings. defaultFrame propiedad para especificar el marco de destino en el que aparece la página web.

La dirección URL enviada a Reproductor multimedia de Windows se procesa en relación con la dirección URL base especificada por IWMPSettings.propiedad baseURL. La dirección URL base se concatena con la dirección URL relativa, lo que da como resultado una dirección URL totalmente especificada que el evento ScriptCommand pasa como parámetro de comando.

El control Reproductor multimedia de Windows siempre procesa los comandos de dirección URL entrantes de la siguiente manera:

1. Se recibe un comando de tipo URL.
2. IWMPSettings. baseURL se usa para crear una dirección URL completa a partir de la dirección URL relativa especificada en el comando de script.
3. Se llama a ScriptCommand .
4. Después de que ScriptCommand vuelva, IWMPSettings. invokeURLs está activado.
5. Si IWMPSettings. invokeURLs es true y el comando es un comando URL, se invoca la dirección URL especificada. Si IWMPSettings. invokeURLs es false o si el comando no es un comando url, se omite el comando.

Al crear un archivo de Windows Media, puede especificar en qué marco se muestra la nueva dirección URL mediante la concatenación de dos y el nombre del marco en el campo de parámetro. En el ejemplo siguiente se muestran los parámetros típicos scriptCommand . Especifica que la dirección URL mypage debe iniciarse en el marco myframe .

scType = "URL"
Param = https://myweb/mypage.html&&myframe

No se llama al evento ScriptCommand si el archivo se está examinando (reenviado rápido o rewound).

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres	AxWMPLib
Ensamblado	AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

Consulte también

Objeto AxWindowsMediaPlayer (VB y C#)

AxWindowsMediaPlayer.URL (VB y C#)

IWMPClosedCaption.captioningId (VB y C#)

IWMPSettings.baseURL (VB y C#)

IWMPSettings.defaultFrame (VB y C#)

IWMPSettings.invokeURLs (VB y C#)