Controls.currentPositionTimecode
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
currentPositionTimecode 属性使用时间代码格式指定或检索当前媒体项中的当前位置。 此属性当前支持 SMPTE 时间代码。
player.controls.currentPositionTimecode
可能的值
此属性是读/写 String。
备注
SMPTE 时间代码提供了一种标识单个视频帧的标准方法,这对于同步播放非常有用。 如果数字媒体文件支持 SMPTE 时间代码,Windows 媒体播放器可以检索当前时间代码位置信息或查找由特定时间代码 String 标识的视频帧。
SMPTE 时间代码按小时数、分钟数、秒数和帧数来标识特定帧,该帧与指定为时间零点的特定引用帧相分离。 通常,时间零帧是文件的开头,特定的 SMPTE 时间代码值表示自文件启动以来的已用时间。
时间代码 String 采用 [range]hh:mm:ss 格式。ff ,其中 [range] 表示范围, hh 表示小时, mm 表示分钟, ss 表示秒, ff 表示帧。 使用 currentPositionTimecode 指定值时,必须使用零作为占位符包括所有八位数字。
[range] 说明符对应于 Windows Media Format WMT_TIMECODE_EXTENSION_DATA 结构的 wRange 成员。 有关时间代码范围的详细信息,请参阅 Windows 媒体格式 SDK。
仅包含 SMPTE 时间代码信息的文件支持指定和检索 currentPositionTimecode 。
示例
下面的代码示例将 currentPositionTimecode 指定为 1 小时、0 分钟、30 秒和 5 帧。 创建 ID 为“Player”的 Player 对象。
// Seek to a frame using SMPTE time code.
Player.controls.currentPositionTimecode = "[00000]01:00:30.05";
要求
要求 | 值 |
---|---|
版本 |
Windows Media Player 9 系列或更高版本。 |
DLL |
|
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈