Compartir a través de

Ejemplo sencillo de scripting en una página web

  • Artículo

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

Puede insertar fácilmente el control Reproductor multimedia de Windows en un archivo HTML mediante cualquier lenguaje de scripting que reconozca el explorador. En el ejemplo simple siguiente se usa Microsoft JScript para crear una página que reproducirá un archivo al hacer clic en un botón y dejar de reproducir el archivo al hacer clic en otro botón.

Puede insertar el Reproductor multimedia de Windows control ActiveX en una página web mediante los cuatro pasos siguientes:

  1. Cree la página web.
  2. Agregue la etiqueta OBJECT.
  3. Agregue una interfaz de usuario. En este caso, dos botones.
  4. Agregue algunas líneas de código para responder cuando el usuario haga clic en uno de los botones que ha creado.

Creación de la página web

El primer paso es crear una página web HTML válida. El código siguiente es el mínimo necesario para crear una página HTML en blanco pero válida:

<HTML>
    <HEAD>
    </HEAD>
    <BODY>
    </BODY>
</HTML>

Adición de la etiqueta OBJECT

Una vez que haya creado una página web, debe agregar una etiqueta OBJECT. Esto identifica el control ActiveX en el explorador y configura las definiciones iniciales. Debe colocar la etiqueta OBJECT en el cuerpo del código. Si lo coloca en body, la interfaz de usuario predeterminada de Reproductor multimedia de Windows estará visible. Si desea crear su propia interfaz de usuario, establezca los atributos height y width en 0 (cero). También puede establecer el Reproductor. La propiedad uiMode se "invisible" cuando se desea ocultar el control, pero todavía se reserva espacio para él en la página. Se recomienda el código siguiente cuando se proporciona una interfaz de usuario personalizada:

<OBJECT ID="Player" height="0" width="0"
  CLASSID="CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6">
</OBJECT>

Se requieren los siguientes atributos de etiqueta OBJECT:

ID

Nombre que usarán otras partes del código para identificar y usar el control ActiveX. Puede elegir cualquier nombre que desee, siempre que sea un nombre que no esté ya usado por HTML, extensiones HTML o el lenguaje de scripting que esté usando. En este ejemplo, se usa el nombre "Player", pero también puedes llamarlo "MyPlayer" o algo más. Solo tiene que elegir un nombre que sea único para esa página web.

CLASSID

Un número hexadecimal muy grande que es único para el control. Solo un control tiene este número y es el Reproductor multimedia de Windows control ActiveX. Para evitar errores tipográficos, puede copiar y pegar este número en la documentación. Las versiones del control Reproductor multimedia de Windows anteriores a la versión 7.0 tenían un CLASSID diferente.

Agregar una interfaz de usuario

HTML permite una gran cantidad de elementos de la interfaz de usuario, lo que permite al usuario interactuar con su página web haciendo clic, presionando teclas y otras acciones de usuario. Agregar algunos botones INPUT es la manera más fácil de proporcionar una interfaz de usuario rápida. El código siguiente crea dos botones que pueden responder al usuario. Al hacer clic en un botón, se inicia la transmisión multimedia y el otro botón lo detiene:

<INPUT TYPE="BUTTON" NAME="BtnPlay" VALUE="Play" OnClick="StartMeUp()">
<INPUT TYPE="BUTTON" NAME="BtnStop" VALUE="Stop" OnClick="ShutMeDown()">

El nombre del botón se usa para identificar el botón en el código; el valor es la etiqueta que aparecerá en el botón y el atributo OnClick identifica a qué parte del código de scripting se llamará cuando se haga clic en el botón.

Agregar código de scripting

El código de scripting agrega interactividad a la página. El código de scripting puede responder a eventos, métodos de llamada y cambiar las propiedades en tiempo de ejecución. Los scripts extendidos se incluyen en un conjunto de etiquetas SCRIPT. La etiqueta SCRIPT indica al explorador dónde está el código de scripting e identifica el lenguaje de scripting. Si no identifica un idioma, el idioma predeterminado será Microsoft JScript.

Es una buena práctica de creación incluir el script en etiquetas de comentario HTML para que los exploradores que no admitan scripting no representen el código como texto. Coloque la etiqueta SCRIPT en cualquier lugar del cuerpo del archivo HTML e inserte el código rodeado de comentarios dentro de las etiquetas SCRIPT de apertura y cierre.

El siguiente ejemplo de código de Microsoft JScript llama al control Reproductor multimedia de Windows y realiza una acción adecuada en respuesta al clic del botón correspondiente.

<SCRIPT>
<!--

function StartMeUp ()
{
    Player.URL = "laure.wma";
}

function ShutMeDown ()
{
    Player.controls.stop();
}

-->
</SCRIPT>

Se llama a la función de ejemplo StartMeUp cuando se hace clic en el botón marcado como Reproducir y se llama a la función ShutMeDown cuando se hace clic en el botón Detener.

El código de StartMeUp usa la propiedad URL para definir una ruta de acceso al medio. El medio comenzará a reproducirse inmediatamente.

El código ShutMeDown llama al método stop del objeto Controls . Tenga en cuenta que se llama al objeto Controls a través de la propiedad controls del objeto Player , que tiene el valor id. de "Player".

En el código siguiente se muestra un ejemplo completo.

<HTML>
<HEAD>
</HEAD>
<BODY>
<OBJECT ID="Player" height="0" width="0"
  CLASSID="CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6">
</OBJECT>
<INPUT TYPE="BUTTON" NAME="BtnPlay" VALUE="Play" OnClick="StartMeUp()">
<INPUT TYPE="BUTTON" NAME="BtnStop" VALUE="Stop" OnClick="ShutMeDown()">
<SCRIPT>
<!--

function StartMeUp ()
{
    Player.URL = "laure.wma";
}

function ShutMeDown ()
{
    Player.controls.stop();
}

-->
</SCRIPT>
</BODY>
</HTML>

Tenga en cuenta que debe proporcionar una dirección URL válida a un nombre de archivo válido en la propiedad URL. En este caso, la suposición es que el archivo laure.wma está en el mismo directorio que el archivo HTML.

Usar el control Reproductor multimedia de Windows en una página web