Evento Player.ScriptCommand

[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.

Sintaxis

Player.ScriptCommand(
  scType,
  Param
)

Parámetros

scType

Cadena que especifica el tipo de comando de script.

Param

Cadena que especifica el comando script.

Valor devuelto

Este evento no devuelve un valor.

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 el tiempo asociado 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 una secuencia que controlará 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 DIV especificado por ClosedCaption. captioningID.
EVENTO	Indica al control que ejecute 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 lyric sincronizado. Reproductor multimedia de Windows muestra el texto líric en el área cerrada subtítulo de la característica Reproducción ahora.
TEXT	El control muestra el texto asociado en el DIV especificado por ClosedCaption. captioningID.
URL	El control abre automáticamente la dirección URL especificada mediante el explorador de Internet predeterminado si la configuración. La propiedad invokeURLs se establece en true.

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

Los comandos de dirección URL recibidos por el control Reproductor multimedia de Windows se invocan automáticamente en el explorador web predeterminado si la configuración.La propiedad invokeURLs se establece en true. Puede usar la configuración. propiedad defaultFrame 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 la configuración.propiedad baseURL. La dirección URL base se concatena con la dirección URL relativamente especificada, 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 tipo URL entrantes de la siguiente manera:

1. Se recibe un comando de tipo URL.
2. Configuración. baseURL se usa para crear una dirección URL completa a partir de la dirección URL relativa especificada en el comando script.
3. Se llama a ScriptCommand.
4. Después de que ScriptCommand vuelva, Configuración. invokeURLs está activado.
5. Si configuración. invokeURLs es true y el comando es un tipo de dirección URL, se invoca la dirección URL especificada. Si configuración. invokeURLs es false o si el comando no es un tipo de dirección 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 de 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 se examina el archivo (reenviado rápido o invertido rápidamente).

El valor de los parámetros de evento se especifica mediante Reproductor multimedia de Windows y se puede tener acceso a un método o pasarse a un método en un archivo JScript importado mediante el nombre de parámetro especificado. Este nombre de parámetro debe escribirse exactamente como se muestra, incluida la mayúscula.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Player (objeto)

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs