Controls.currentPositionTimecode

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

currentPositionTimecode プロパティは、時刻コード形式を使用して、現在のメディアアイテム内の現在の位置を指定または取得します。 このプロパティは現在、SMPTE タイム コードをサポートしています。

player.controls.currentPositionTimecode

指定できる値

このプロパティは、読み取り/書き込み 文字列です。

解説

SMPTE タイム コードは、個々のビデオ フレームを識別する標準的な方法を提供します。これは、再生の同期に役立ちます。 デジタル メディア ファイルが SMPTE タイム コードをサポートしている場合、Windows メディア プレーヤーは現在のタイム コードの位置情報を取得したり、特定のタイム コード String で識別されるビデオ フレームをシークしたりできます。

SMPTE タイム コードは、特定のフレームを時間、分、秒、および特定の参照フレームから切り離すフレーム数によって、タイム ゼロとして指定されたフレームを識別します。 通常、タイム ゼロ フレームはファイルの開始であり、特定の SMPTE 時間コード値はファイルの開始以降の経過時間を表します。

時刻コード String の形式は [range]hh:mm:ss です。ff [range] は範囲を表し、 hh は時間を表し、 mm は分を表し、 ss は秒を表し、 ff は フレームを表します。 currentPositionTimecode を使用して値を指定する場合は、プレースホルダーとしてゼロを使用する 8 桁すべてを含める必要があります。

[range] 指定子は、Windows Media Format WMT_TIMECODE_EXTENSION_DATA 構造体の wRange メンバーに対応します。 タイム コード範囲の詳細については、Windows Media Format SDK に関するページを参照してください。

currentPositionTimecode の指定と取得は、SMPTE 時刻コード情報を含むファイルでのみサポートされます。

例

次のコード例では、 currentPositionTimecode を 1 時間、0 分、30 秒、5 フレームとして指定します。 Player オブジェクトは ID = "Player" で作成されました。

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

必要条件

要件 値
Version
 Windows メディア プレーヤー 9 シリーズ以降。
[DLL]
Wmp.dll

関連項目

Controls オブジェクト