调试代码

  • 项目

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

你经常会想看看你的皮肤内部发生了什么。 可以通过文本控件或日志文件执行此操作。

可以创建 TEXT 元素，并暂时将其放置在皮肤的一部分。 例如，可以使用以下代码创建 TEXT 元素：

<!-- debugging control -- remove later -->        
<TEXT
    id = "debug"
    foregroundColor = "white"
    backgroundColor = "black"
    value = "debug"
    top = "100"
    left = "50"
    height = "15"
    width = "100" 
    z-order = "5" />
<!-- end debugging control -->

例如，如果要在 Windows 媒体播放器 中查看数字媒体内容的当前位置，则可以使用如下所示的代码在文本框中显示当前位置。

<PLAYER
    id = "myplayer">
    <CONTROLS
        id = "mycontrols"
        currentPosition_onchange="value=player.controls.currentPosition"/>
</PLAYER>

将调试信息写入日志文件

若要启用或禁用调试，请更改以下注册表项的值：

HKEY_CURRENT_USER\SOFTWARE\Microsoft\MediaPlayer\Preferences\ScriptDebugging

将值设置为 1 时，将启用日志记录。 将值设置为 0 (默认) 时，将禁用日志记录。

如果启用了日志记录，文件将放置在用户计算机上的同一文件夹中，该文件夹与外观相同。 该文件将命名为“filename_0_log.txt”，其中 filename 是外观文件的名称。 外观中的代码可以使用 主题向此文件写入文本。logString 方法。 如果要确定代码在运行时代码中发生的情况，这非常有用。 请注意，文本文件使用 Unicode 字符进行编码。

启用日志记录并安装提供调试功能 (（如 Microsoft Visual Studio) ）的开发系统时，脚本代码未处理的异常将导致针对每个异常打开调试器警告对话框。 这是一项有用的功能，可帮助你调试脚本代码。 此外，启用日志记录后，还可以将Windows 媒体播放器进程手动附加到调试器。

此 SDK 包含一个名为“logging”的示例外观，用于演示皮肤中的日志记录功能。 若要详细了解如何使用示例，请参阅 示例。

关于皮肤