Méthode Media. getMarkerTime

La méthode getMarkerTime récupère l’heure du marqueur au niveau de l’index spécifié.

Syntaxe

retVal = Media.getMarkerTime(
  markerNum
)

Paramètres

markerNum [ dans]

Nombre (long) spécifiant l’index du marqueur.

Valeur de retour

Cette méthode retourne un nombre (double) qui spécifie l’emplacement du marqueur, en secondes, à partir du début du clip.

Remarques

Cette méthode retourne la valeur null si le marqueur spécifié n’existe pas.

Certains éléments multimédias numériques ne contiennent pas de marqueurs. Utilisez markerCount pour déterminer le nombre de marqueurs dans le clip actuel.

Les numéros d’index des marqueurs commencent à 1.

Pour utiliser cette méthode, l’accès en lecture à la bibliothèque est requis. Pour plus d’informations, consultez accès à la bibliothèque.

Exemples

l’exemple de JScript suivant utilise un média. getMarkerTime pour remplir un élément textarea html nommé MTIMES avec l’emplacement de chaque marqueur. L’objet Player a été créé avec 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";
}

Configuration requise

Condition requise Valeur
Version
Lecteur Windows Media version 7,0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

Objet Media

Media. getMarkerName

Media. markerCount

Paramètres. mediaAccessRights

Paramètres. requestMediaAccessRights