Share via

網頁中的腳本簡單範例

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

您可以使用瀏覽器可辨識的任何指令碼語言，輕鬆地在 HTML 檔案中內嵌Windows 媒體播放機控制項。 下列簡單範例會使用 Microsoft JScript 來建立頁面，以在您按一下按鈕時播放檔案，並在您按一下另一個按鈕時停止播放檔案。

您可以使用下列四個步驟，在網頁中內嵌 Windows 媒體播放機 ActiveX 控制項：

  1. 建立網頁。
  2. 新增 OBJECT 標籤。
  3. 新增使用者介面。 在此情況下，有兩個按鈕。
  4. 新增幾行程式碼，以在使用者按一下您所建立的其中一個按鈕時回應。

建立網頁

第一個步驟是建立有效的 HTML 網頁。 下列程式碼是建立空白但有效的 HTML 頁面所需的最低程式碼：

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

新增 OBJECT 標籤

建立網頁之後，您必須新增 OBJECT 標籤。 這會識別瀏覽器的 ActiveX 控制項，並設定任何初始定義。 您必須將 OBJECT 標籤放在程式碼的 BODY 中。 如果您將其放在 BODY 中，則會顯示Windows 媒體播放機的預設使用者介面。 如果您想要建立自己的使用者介面，請將高度和寬度屬性設定為 0 (零) 。 您也可以設定 Player。當您想要隱藏控制項時，uiMode 屬性會「不可見」，但仍會在頁面上保留空間。 當您提供自訂使用者介面時，建議使用下列程式碼：

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

需要下列 OBJECT 標記屬性：

識別碼

程式碼的其他部分將用來識別及使用 ActiveX 控制項的名稱。 您可以選擇任何您想要的名稱，只要它是 HTML、HTML 延伸模組或您使用的指令碼語言尚未使用的名稱。 在此範例中，會使用名稱 「Player」，但您也可以將其命名為 「MyPlayer」 或其他名稱。 只要挑選該網頁唯一的名稱即可。

CLASSID

控制項唯一的非常大型十六進位數位。 只有一個控制項具有這個數位，而且它是 ActiveX 控制項Windows 媒體播放機。 若要防止印刷錯誤，您可以從檔中複製並貼上此號碼。 7.0 版之前的Windows 媒體播放機控制項版本有不同的 CLASSID。

新增使用者介面

HTML 允許大量的使用者介面元素，讓使用者按一下、按下按鍵和其他使用者動作，與您的網頁互動。 新增幾個輸入按鈕是提供快速使用者介面的最簡單方式。 下列程式碼會建立兩個可回應使用者的按鈕。 按一下一個按鈕會啟動媒體串流播放，而另一個按鈕會停止它：

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

按鈕的名稱可用來識別程式碼的按鈕;值是會出現在按鈕上的標籤，而 OnClick 屬性會識別按一下按鈕時，會呼叫哪一部分的腳本程式碼。

新增腳本程式碼

腳本程式碼會將互動功能新增至您的頁面。 腳本程式碼可以回應事件、呼叫方法，以及變更執行時間屬性。 擴充腳本會包含在 SCRIPT 標記集中。 SCRIPT 標記會告知瀏覽器腳本程式碼的位置，並識別指令碼語言。 如果您未識別語言，預設語言會是 Microsoft JScript。

將腳本括在 HTML 批註標籤中是很好的撰寫做法，因此不支援腳本的瀏覽器不會將您的程式碼轉譯為文字。 將 SCRIPT 標籤放在 HTML 檔案主體內的任何位置，並在開頭和結尾 SCRIPT 標籤內嵌批註括住的程式碼。

下列 Microsoft JScript 程式碼範例會呼叫 Windows 媒體播放機 控制項，並執行適當的動作，以回應對應的按鈕按一下。

<SCRIPT>
<!--

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

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

-->
</SCRIPT>

按一下標示為 [播放] 的按鈕時，會呼叫範例函式 StartMeUp，並在按一下 [停止] 按鈕時呼叫 ShutMeDown 函式。

StartMeUp 內的程式碼會使用 URL 屬性來定義媒體的路徑。 媒體將會立即開始播放。

ShutMeDown 程式碼會呼叫Controls物件的stop方法。 請注意，Controls物件是透過Player物件的controls屬性呼叫，其識別碼值為 「Player」。

下列程式碼顯示完整範例。

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

請注意，您必須在 URL 屬性中提供有效檔案名的有效 URL。 在此情況下，假設檔案 laure.wma 與 HTML 檔案位於相同的目錄中。

在網頁中使用 Windows 媒體播放機 控制項