Método Media.getMarkerTime

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. 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 de Reprodutor Multimídia do Windows SDK, quando 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.]

O método getMarkerTime recupera a hora do marcador no índice especificado.

Sintaxe

retVal = Media.getMarkerTime(
  markerNum
)

Parâmetros

markerNum [in]

Número (longo) que especifica o índice do marcador.

Retornar valor

Esse método retorna um Número (duplo) especificando o local do marcador em segundos desde o início do clipe.

Comentários

Esse método retornará NULL se o marcador especificado não existir.

Alguns itens de mídia digital não contêm marcadores. Use markerCount para descobrir quantos marcadores estão no clipe atual.

Os números de índice de marcador começam em 1.

Para usar esse método, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à biblioteca.

Exemplos

O exemplo JScript a seguir usa Mídia. getMarkerTime para preencher um elemento TEXTAREA HTML chamado MTIMES com o local de cada marcador. O objeto Player foi criado com ID = "Player".

// Get the number of markers in the current media item.
var mcount = Player.currentMedia.markerCount;

// Verify that at least one marker exists in the current media item.
if (mcount > 0){

// Loop through the marker list.
for (var i = 1;i < mcount + 1; i++){

   // Print the message to the text area.
   MTIMES.value += "Marker number " + i + " occurs at ";
   MTIMES.value += Player.currentMedia.getMarkerTime(i);
   MTIMES.value += " second(s).";
   MTIMES.value += "\n";
}

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Media

Media.getMarkerName

Media.markerCount

Settings.mediaAccessRights

Settings.requestMediaAccessRights