Share via

Exemple simple de script dans une page web

  • Article

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Vous pouvez facilement incorporer le contrôle Lecteur multimédia Windows dans un fichier HTML à l’aide de n’importe quel langage de script reconnu par votre navigateur. L’exemple simple suivant utilise Microsoft JScript pour créer une page qui lira un fichier lorsque vous cliquez sur un bouton et arrêtera la lecture du fichier lorsque vous cliquez sur un autre bouton.

Vous pouvez incorporer le contrôle ActiveX Lecteur multimédia Windows dans une page web en procédant comme suit :

  1. Créez la page web.
  2. Ajoutez la balise OBJECT.
  3. Ajoutez une interface utilisateur. Dans ce cas, deux boutons.
  4. Ajoutez quelques lignes de code pour répondre lorsque l’utilisateur clique sur l’un des boutons que vous avez créés.

Création de la page web

La première étape consiste à créer une page web HTML valide. Le code suivant est le minimum nécessaire pour créer une page HTML vide mais valide :

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

Ajout de la balise OBJECT

Une fois que vous avez créé une page web, vous devez ajouter une balise OBJECT. Cela identifie le contrôle ActiveX dans le navigateur et configure toutes les définitions initiales. Vous devez placer la balise OBJECT dans le CORPS du code. Si vous le placez dans body, l’interface utilisateur par défaut de Lecteur multimédia Windows sera visible. Si vous souhaitez créer votre propre interface utilisateur, définissez les attributs height et width sur 0 (zéro). Vous pouvez également définir le Lecteur. propriété uiMode à « invisible » lorsque vous souhaitez masquer le contrôle, mais toujours réserver de l’espace pour celui-ci sur la page. Le code suivant est recommandé lorsque vous fournissez une interface utilisateur personnalisée :

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

Les attributs de balise OBJECT suivants sont requis :

id

Nom qui sera utilisé par d’autres parties du code pour identifier et utiliser le contrôle ActiveX. Vous pouvez choisir le nom de votre choix, tant qu’il s’agit d’un nom qui n’est pas déjà utilisé par html, les extensions HTML ou le langage de script que vous utilisez. Dans cet exemple, le nom « Player » est utilisé, mais vous pouvez également l’appeler « MyPlayer » ou autre chose. Il vous suffit de choisir un nom qui est propre à cette page web.

CLASSID

Nombre hexadécimal très important qui est unique au contrôle. Un seul contrôle a ce nombre et il s’agit du Lecteur multimédia Windows contrôle ActiveX. Pour éviter les erreurs typographiques, vous pouvez copier et coller ce nombre à partir de la documentation. Les versions du contrôle Lecteur multimédia Windows antérieures à la version 7.0 avaient un CLASSID différent.

Ajout d’une interface utilisateur

HTML permet une grande quantité d’éléments d’interface utilisateur, ce qui permet à l’utilisateur d’interagir avec votre page web en cliquant, en appuyant sur les touches et en appuyant sur d’autres actions utilisateur. L’ajout de quelques boutons d’entrée est le moyen le plus simple de fournir une interface utilisateur rapide. Le code suivant crée deux boutons qui peuvent répondre à l’utilisateur. Cliquer sur un bouton démarre la lecture du flux multimédia et l’autre bouton l’arrête :

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

Le nom du bouton est utilisé pour identifier le bouton dans votre code ; la valeur est l’étiquette qui apparaîtra sur le bouton, et l’attribut OnClick identifie la partie de votre code de script qui sera appelée lorsque vous cliquez sur le bouton.

Ajout de code de script

Le script de code ajoute de l’interactivité à votre page. Le code de script peut répondre aux événements, appeler des méthodes et modifier les propriétés d’exécution. Les scripts étendus sont placés dans un jeu de balises SCRIPT. La balise SCRIPT indique au navigateur où se trouve votre code de script et identifie le langage de script. Si vous n’identifiez pas une langue, la langue par défaut est Microsoft JScript.

Il est recommandé de placer votre script dans des balises de commentaire HTML afin que les navigateurs qui ne prennent pas en charge les scripts ne restituent pas votre code sous forme de texte. Placez la balise SCRIPT n’importe où dans le CORPS de votre fichier HTML et incorporez le code entouré de commentaires dans les balises SCRIPT d’ouverture et de fermeture.

L’exemple de code Microsoft JScript suivant appelle le contrôle Lecteur multimédia Windows et effectue une action appropriée en réponse au clic sur le bouton correspondant.

<SCRIPT>
<!--

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

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

-->
</SCRIPT>

L’exemple de fonction, StartMeUp, est appelé lorsque l’utilisateur clique sur le bouton Lecture et que la fonction ShutMeDown est appelée lorsque vous cliquez sur le bouton Arrêter.

Le code à l’intérieur de StartMeUp utilise la propriété URL pour définir un chemin d’accès au média. Le média commencera à jouer immédiatement.

Le code ShutMeDown appelle la méthode stop de l’objet Controls . Notez que l’objet Controls est appelé via la propriété controls de l’objet Player , qui a la valeur d’ID « Player ».

L'exemple de code suivant illustre l'exemple complet.

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

Notez que vous devez fournir une URL valide à un nom de fichier valide dans la propriété URL. Dans ce cas, l’hypothèse est que le fichier laure.wma se trouve dans le même répertoire que le fichier HTML.

Utilisation du contrôle Lecteur multimédia Windows dans une page web