Media.duration

[O recurso associado a esta página, O SDK do Reprodutor Multimídia do Windows é um recurso herdado. Ele foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez do SDK do Reprodutor Multimídia do Windows sempre que possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A propriedade de duração recupera a duração do item de mídia atual em segundos.

Sintaxe

player.currentMedia.duration

Valores possíveis

Essa propriedade é um número somente leitura ( duplo).

Comentários

Se essa propriedade for usada com um item de mídia diferente do especificado em Player.currentMedia, ela pode não conter um valor válido.

Para recuperar a duração dos arquivos que não estão na biblioteca do usuário, você deve aguardar o Windows Media Player abrir o arquivo; ou seja, o OpenState atual deve ser igual a MediaOpen. Você pode verificar isso manipulando o evento Player.OpenStateChange ou verificando periodicamente o valor de Player.openState.

Para playlists, a duração de cada item de mídia pode ser recuperada quando o item de mídia individual é aberto, em vez de quando a playlist é aberta.

Para recuperar o valor dessa propriedade, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à Biblioteca.

O exemplo JScript a seguir usa Media.duration para exibir o tempo restante no item de mídia atual. Um elemento DIV HTML chamado RemTime exibe as informações. Um temporizador HTML atualiza o texto no elemento DIV a cada segundo.

O código JScript a seguir inicia o temporizador:

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

O código JScript a seguir interrompe o temporizador:

window.clearInterval(idTmr);

Use o evento Player.PlayStateChange com uma instrução switch para determinar quando iniciar e parar o temporizador.

O código JScript a seguir é executado sempre que o temporizador chama a função de atualização:

// 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
Versão	Windows Media Player versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto de mídia

Player.currentMedia

Evento Player.PlayStateChange

Settings.mediaAccessRights

Settings.requestMediaAccessRights