Einfaches Beispiel für Skripterstellung auf einer Webseite

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Sie können das Windows Medienwiedergabe-Steuerelement ganz einfach in eine HTML-Datei einbetten, indem Sie eine beliebige Skriptsprache verwenden, die Ihr Browser erkennt. Das folgende einfache Beispiel verwendet Microsoft JScript, um eine Seite zu erstellen, die eine Datei wiedergibt, wenn Sie auf eine Schaltfläche klicken, und die Wiedergabe der Datei beenden, wenn Sie auf eine andere Schaltfläche klicken.

Sie können das Windows Medienwiedergabe ActiveX-Steuerelement mit den folgenden vier Schritten in eine Webseite einbetten:

  1. Erstellen Sie die Webseite.
  2. Fügen Sie das OBJECT-Tag hinzu.
  3. Fügen Sie eine Benutzeroberfläche hinzu. In diesem Fall zwei Schaltflächen.
  4. Fügen Sie einige Codezeilen hinzu, um zu reagieren, wenn der Benutzer auf eine der von Ihnen erstellten Schaltflächen klickt.

Erstellen der Webseite

Der erste Schritt besteht darin, eine gültige HTML-Webseite zu erstellen. Der folgende Code ist das Minimum, das zum Erstellen einer leeren, aber gültigen HTML-Seite erforderlich ist:

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

Hinzufügen des OBJECT-Tags

Nachdem Sie eine Webseite erstellt haben, müssen Sie ein OBJECT-Tag hinzufügen. Dadurch wird das ActiveX-Steuerelement für den Browser identifiziert und alle anfänglichen Definitionen eingerichtet. Sie müssen das OBJECT-Tag im Textkörper des Codes platzieren. Wenn Sie sie im TEXTkörper platzieren, wird die Standard-Benutzeroberfläche von Windows Medienwiedergabe angezeigt. Wenn Sie eine eigene Benutzeroberfläche erstellen möchten, legen Sie die Attribute höhe und breite auf 0 (null) fest. Sie können auch den Player festlegen. uiMode-Eigenschaft auf "unsichtbar", wenn Sie das Steuerelement ausblenden möchten, aber trotzdem Speicherplatz dafür auf der Seite reservieren möchten. Der folgende Code wird empfohlen, wenn Sie eine benutzerdefinierte Benutzeroberfläche bereitstellen:

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

Die folgenden OBJECT-Tagattribute sind erforderlich:

ID

Der Name, der von anderen Teilen des Codes verwendet wird, um das ActiveX-Steuerelement zu identifizieren und zu verwenden. Sie können einen beliebigen Namen auswählen, solange es sich um einen Namen handelt, der noch nicht von HTML, HTML-Erweiterungen oder der verwendeten Skriptsprache verwendet wird. In diesem Beispiel wird der Name "Player" verwendet, aber Sie können ihn auch "MyPlayer" oder etwas anderes nennen. Wählen Sie einfach einen Namen aus, der für diese Webseite eindeutig ist.

CLASSID

Eine sehr große hexadezimale Zahl, die für das Steuerelement eindeutig ist. Nur ein Steuerelement weist diese Nummer auf, und es ist das Windows Medienwiedergabe ActiveX-Steuerelements. Um typografische Fehler zu vermeiden, können Sie diese Nummer kopieren und aus der Dokumentation einfügen. Versionen des Windows Medienwiedergabe-Steuerelements vor Version 7.0 hatten eine andere CLASSID.

Hinzufügen einer Benutzeroberfläche

HTML ermöglicht eine vielzahl von Elementen der Benutzeroberfläche, die es dem Benutzer ermöglichen, mit Ihrer Webseite zu interagieren, indem sie klicken, Tasten drücken und andere Benutzeraktionen ausführen. Das Hinzufügen einiger EINGABEschaltflächen ist die einfachste Möglichkeit, eine schnelle Benutzeroberfläche bereitzustellen. Der folgende Code erstellt zwei Schaltflächen, die auf den Benutzer reagieren können. Wenn Sie auf eine Schaltfläche klicken, wird der Mediendatenstrom abgespielt, und die andere Schaltfläche beendet ihn:

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

Der Name der Schaltfläche wird verwendet, um die Schaltfläche für Ihren Code zu identifizieren. der Wert ist die Bezeichnung, die auf der Schaltfläche angezeigt wird, und das OnClick-Attribut gibt an, welcher Teil Des Skriptcodes aufgerufen wird, wenn auf die Schaltfläche geklickt wird.

Hinzufügen von Skriptcode

Skriptcode fügt Ihrer Seite Interaktivität hinzu. Skriptcode kann auf Ereignisse reagieren, Methoden aufrufen und Laufzeiteigenschaften ändern. Erweiterte Skripts sind in einen SCRIPT-Tagsatz eingeschlossen. Das SCRIPT-Tag teilt dem Browser mit, wo sich Ihr Skriptcode befindet, und identifiziert die Skriptsprache. Wenn Sie keine Sprache identifizieren, ist die Standardsprache Microsoft JScript.

Es ist eine gute Erstellungspraxis, Ihr Skript in HTML-Kommentartags einzuschließen, damit Browser, die keine Skripterstellung unterstützen, Ihren Code nicht als Text rendern. Platzieren Sie das SCRIPT-Tag an einer beliebigen Stelle im TEXTKÖRPER Ihrer HTML-Datei, und betten Sie den kommentarseitigen Code in die öffnenden und schließenden SCRIPT-Tags ein.

Im folgenden Microsoft JScript-Codebeispiel wird das Windows Medienwiedergabe-Steuerelement aufgerufen und eine entsprechende Aktion als Reaktion auf den entsprechenden Schaltflächenklick ausgeführt.

<SCRIPT>
<!--

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

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

-->
</SCRIPT>

Die Beispielfunktion StartMeUp wird aufgerufen, wenn auf die Schaltfläche "Wiedergabe" geklickt wird, und die ShutMeDown-Funktion wird aufgerufen, wenn auf die Schaltfläche Beenden geklickt wird.

Der Code in StartMeUp verwendet die URL-Eigenschaft, um einen Pfad zu den Medien zu definieren. Die Medien werden sofort wiedergegeben.

Der ShutMeDown-Code ruft die stop-Methode des Controls-Objekts auf. Beachten Sie, dass das Controls-Objekt über die Steuerelementeigenschaft des Player-Objekts aufgerufen wird, das den ID-Wert "Player" aufweist.

Der folgende Code veranschaulicht das vollständige Beispiel.

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

Beachten Sie, dass Sie eine gültige URL für einen gültigen Dateinamen in der URL-Eigenschaft angeben müssen. In diesem Fall wird davon ausgegangen, dass sich die Datei laure.wma im selben Verzeichnis wie die HTML-Datei befindet.

Verwenden des Windows Medienwiedergabe-Steuerelements in einer Webseite