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 時間代碼值代表自檔案開頭以來經過的時間。

時間代碼 字串 的格式為 [range]hh：mm：ss。ff 其中 [range] 代表範圍， hh 代表小時、 mm 代表分鐘、 ss 代表秒， 而 ff 代表框架。 使用 currentPositionTimecode指定值時，您必須使用零作為預留位置來包含所有八位數。

[range] 規範對應于 Windows 媒體格式WMT_TIMECODE_EXTENSION_DATA結構的wRange成員。 如需時間程式碼範圍的詳細資訊，請參閱 Windows 媒體格式 SDK。

只有包含 SMPTE 時間程式碼資訊的檔案才支援指定和擷取 currentPositionTimecode 。

範例

下列程式碼範例會將 currentPositionTimecode 指定為 1 小時、零分鐘、30 秒和 5 個畫面格。 Player物件是以識別碼 = 「Player」 建立的。

// Seek to a frame using SMPTE time code.
Player.controls.currentPositionTimecode = "[00000]01:00:30.05";

規格需求

需求 值
版本
 Windows Media Player  9  系列或更新的版本。
DLL
Wmp.dll

另請參閱

Controls 物件