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 类型命令:
- 收到 URL 类型命令。
- 设置。baseURL 用于根据脚本命令中指定的相对 URL 创建完整 URL。
- 将调用 ScriptCommand 。
- 在 ScriptCommand 返回后,设置。已检查 invokeURLs。
- 如果“设置”。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 |
|
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将推出:在整个 2024 年,我们将逐步取消以“GitHub 问题”作为内容的反馈机制,并将其替换为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈