AxWindowsMediaPlayer 对象的 ScriptCommand 事件

  • 项目

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

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

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

事件数据

与此事件关联的处理程序的类型为 AxWMPLib._WMPOCXEvents_ScriptCommandEventHandler。 此处理程序接收 AxWMPLib._WMPOCXEvents_ScriptCommandEvent 类型的参数，其中包含与此事件相关的以下属性。

属性 说明
scType System.StringSpecifing 脚本命令的类型。
param System.StringSpecifies 脚本命令。

备注

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

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

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

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

如果在快进或倒退模式下扫描文件，则不会调用 ScriptCommand 事件。

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

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

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

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

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

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

如果正在扫描文件 (快进或重新) ，则不会调用 ScriptCommand 事件。

要求

要求 值
版本
 Windows 媒体播放器 9 系列或更高版本
命名空间
 AxWMPLib
程序集
AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

另请参阅

AxWindowsMediaPlayer 对象 (VB 和 C#)

AxWindowsMediaPlayer.URL (VB 和 C#)

IWMPClosedCaption.captioningId (VB 和 C#)

IWMPSettings.baseURL (VB 和 C#)

IWMPSettings.defaultFrame (VB 和 C#)

IWMPSettings.invokeURLs (VB 和 C#)