Media.duration

[Das Feature, das dieser Seite zugeordnet ist, Windows Medienwiedergabe-SDK, ist ein Legacy-Feature. Es wurde durch MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code wenn möglich MediaPlayer anstelle von Windows Medienwiedergabe-SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, wenn möglich umgeschrieben wird, um die neuen APIs zu verwenden.]

Die Dauer-Eigenschaft ruft die Dauer des aktuellen Medienelements in Sekunden ab.

Syntax

player.currentMedia.duration

Mögliche Werte

Diese Eigenschaft ist eine schreibgeschützte Zahl ( double).

Hinweise

Wenn diese Eigenschaft mit einem anderen Medienelement als dem in Player.currentMedia angegebenen verwendet wird, enthält sie möglicherweise keinen gültigen Wert.

Um die Dauer für Dateien abzurufen, die sich nicht in der Bibliothek des Benutzers befinden, müssen Sie warten, bis Windows Medienwiedergabe die Datei öffnen. Das heißt, der aktuelle OpenState muss MediaOpen entsprechen. Sie können dies überprüfen, indem Sie das Ereignis Player.OpenStateChange behandeln oder regelmäßig den Wert von Player.openState überprüfen.

Bei Wiedergabelisten kann die Dauer jedes Medienelements abgerufen werden, wenn das einzelne Medienelement geöffnet wird, und nicht, wenn die Wiedergabeliste geöffnet wird.

Zum Abrufen des Werts dieser Eigenschaft ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Das folgende JScript-Beispiel verwendet Media.duration, um die verbleibende Zeit für das aktuelle Medienelement anzuzeigen. Ein HTML DIV-Element mit dem Namen RemTime zeigt die Informationen an. Ein HTML-Zeitgeber aktualisiert den Text im DIV-Element alle Sekunde.

Der folgende JScript-Code startet den Zeitgeber:

// Execute the update() function at one-second intervals.
idTmr = window.setInterval("update()",1000);

Der folgende JScript-Code beendet den Zeitgeber:

window.clearInterval(idTmr);

Verwenden Sie das Ereignis Player.PlayStateChange mit einer Switch-Anweisung, um zu bestimmen, wann der Zeitgeber gestartet und gestoppt werden soll.

Der folgende JScript-Code wird jedes Mal ausgeführt, wenn der Zeitgeber die Updatefunktion aufruft:

// Store the current position of the current media item.
var TimeNow = Player.controls.currentPosition;

// Display the time remaining information.
RemTime.innerHTML = "Seconds remaining: ";

// Subtract the current position from the duration of the current media.
// Use the Math.floor method to round the result down to the nearest integer.
RemTime.innerHTML += Math.floor(Player.currentMedia.duration - TimeNow);

Anforderungen

Anforderung Wert
Version
Windows Media Player, Version 7.0 oder höher.
DLL
Wmp.dll

Siehe auch

Media-Objekt

Player.currentMedia

Player.PlayStateChange-Ereignis

Settings.mediaAccessRights

Settings.requestMediaAccessRights