Player.ScriptCommand 事件

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

收到同步命令或 URL 时,将发生 ScriptCommand 事件。

语法

Player.ScriptCommand(
  scType,
  Param
)

参数

scType

指定脚本命令类型的字符串。

参数

指定脚本命令的字符串

返回值

此事件不返回值。

备注

命令可以嵌入 Windows Media 文件或流的声音和图像中。 命令是与流中的指定时间关联的一对 Unicode 字符串。 当流到达与命令关联的时间时,Windows 媒体播放器控件发送具有两个参数的 ScriptCommand 事件。 一个参数指定要发送的命令的类型,另一个参数指定命令。 参数的类型用于确定如何处理命令参数。 任何类型的命令都可以嵌入到要由 ScriptCommand 事件处理的文件或流中。

下表列出了Windows 媒体播放器自动处理的脚本命令类型。

类型 描述
CAPTION 控件显示 由 ClosedCaption 指定的 DIV 中的关联文本。captioningID
事件 告知控件执行为指定事件定义的指令。
文件名 控件重置其 URL 属性,尝试打开指定的文件,然后立即开始播放新流。
OPENEVENT 缓冲关联的 EVENT 类型命令,以便及时执行 EVENT 脚本。
SYNCHRONIZEDLYRICLYRIC Param 参数包含同步的歌词文本。 Windows 媒体播放器“正在播放”功能的关闭描述文字区域中显示歌词文本。
TEXT 控件显示 由 ClosedCaption 指定的 DIV 中的关联文本。captioningID
URL 如果 “设置”,控件会自动打开使用默认 Internet 浏览器指定的 URL。invokeURLs 属性设置为 true。

只要提供对等代码来处理命令,就可以嵌入任何其他类型的命令。 尽管未知命令被Windows 媒体播放器控件忽略,但它们仍会移交给 ScriptCommand 事件。

如果为“设置”,则 Windows 媒体播放器 控件收到的 URL 命令会在默认 Web 浏览器中自动调用。invokeURLs 属性设置为 true。 可以使用“设置”。defaultFrame 属性,用于指定网页出现的目标帧。

发送到Windows 媒体播放器的 URL 相对于“设置”指定的基 URL 进行处理。baseURL 属性。 基 URL 与相对指定的 URL 连接,生成由 ScriptCommand 事件作为命令参数传递的完全指定的 URL。

Windows 媒体播放器 控件始终按以下方式处理传入的 URL 类型命令:

  1. 收到 URL 类型命令。
  2. 设置baseURL 用于根据脚本命令中指定的相对 URL 创建完整 URL。
  3. 将调用 ScriptCommand
  4. 在 ScriptCommand 返回后,设置已检查 invokeURLs
  5. 如果“设置”。invokeURLs 为 true,命令为 URL 类型,调用指定的 URL。 如果“设置”。invokeURLs 为 false,或者如果命令不是 URL 类型,则忽略该命令。

创作 Windows Media 文件时,可以通过连接两个和号和参数字段中的帧名称来指定显示新 URL 的帧。 下面的示例演示了典型的 ScriptCommand 参数。 它指定必须在 myframe 帧中启动 URL mypage

scType = "URL"
Param = https://myweb/mypage.html&&myframe

如果扫描文件 (快进或快速反向) ,则不会调用 ScriptCommand 事件。

事件参数的值由 Windows 媒体播放器 指定,可以使用给定的参数名称访问或传递到导入的 JScript 文件中的方法。 必须完全按所示键入此参数名称,包括大写。

要求

要求
版本
Windows 媒体播放器版本 7.0 或更高版本。
DLL
Wmp.dll

另请参阅

Player 对象

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs