网页中脚本的简单示例

[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

可以使用浏览器识别的任何脚本语言轻松地将 Windows 媒体播放器 控件嵌入 HTML 文件中。 下面的简单示例使用 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 标记属性:

ID

代码的其他部分将用来标识和使用 ActiveX 控件的名称。 你可以选择所需的任何名称,只要它是 HTML、HTML 扩展或你使用的脚本语言尚未使用的名称。 在此示例中,使用名称“Player”,但你也可以将其称为“MyPlayer”或其他名称。 只需选择该网页唯一的名称即可。

CLASSID

控件唯一的非常大的十六进制数。 只有一个控件具有此数字,它是Windows 媒体播放器 ActiveX 控件。 若要防止出现版式错误,可以从文档中复制并粘贴此编号。 版本 7.0 之前的 Windows 媒体播放器 控件具有不同的 CLASSID。

添加用户界面

HTML 允许大量用户界面元素,允许用户通过单击、按键和其他用户操作来与网页交互。 添加几个 INPUT 按钮是提供快速用户界面的最简单方法。 以下代码创建两个可响应用户的按钮。 单击一个按钮开始播放媒体流,另一个按钮停止播放:

<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 文件的 BODY 中的任何位置,并将注释环绕的代码嵌入到开始和结束的 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 属性调用的,该对象的 ID 值为“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 媒体播放器 控件