Media.duration

[La característica asociada a esta página, SDK del Reproductor multimedia de Windows, es una característica heredada. MediaPlayer la ha reemplazado. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar del SDK del Reproductor multimedia de Windows, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible].

La propiedad duration recupera la duración del elemento multimedia actual en segundos.

Sintaxis

player.currentMedia.duration

Valores posibles

Esta propiedad es un número (double) de solo lectura.

Comentarios

Si esta propiedad se usa con un elemento multimedia distinto del especificado en Player.currentMedia, puede que no contenga un valor válido.

Para recuperar la duración de los archivos que no están en la biblioteca del usuario, debe esperar a que el Reproductor multimedia de Windows abra el archivo; es decir, el valor de OpenState actual debe ser igual al valor de MediaOpen. Para comprobarlo, controle el evento Player.OpenStateChange o compruebe periódicamente el valor de Player.openState.

Para las listas de reproducción, la duración de cada elemento multimedia se puede recuperar cuando se abre el elemento multimedia individual, en lugar de cuando se abre la lista de reproducción.

Para recuperar el valor de esta propiedad, se requiere acceso de lectura a la biblioteca. Para más información, consulte Acceso a la biblioteca.

En el ejemplo siguiente de JScript se usa Media.duration para mostrar el tiempo restante en el elemento multimedia actual. Un elemento DIV HTML denominado RemTime muestra la información. Un temporizador HTML actualiza el texto del elemento DIV cada segundo.

El código JScript siguiente inicia el temporizador:

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

El código JScript siguiente detiene el temporizador:

window.clearInterval(idTmr);

Use el evento Player.PlayStateChange con una instrucción switch para determinar cuándo iniciar y detener el temporizador.

El código JScript siguiente se ejecuta cada vez que el temporizador llama a la función de actualización:

// 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);

Requisitos

Requisito	Valor
Versión	Se requiere Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Objeto Media

Player.currentMedia

Evento Player.PlayStateChange

Settings.mediaAccessRights

Settings.requestMediaAccessRights