Settings.rate

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La propriété rate spécifie ou récupère le taux de lecture actuel du média vidéo.

Syntaxe

player.settings.rate

Valeurs possibles

Cette propriété est un nombre en lecture/écriture (double) avec une valeur par défaut de 1,0.

Notes

Cette propriété agit comme une valeur multiplicateur qui vous permet de lire un clip à un rythme plus rapide ou plus lent. La valeur par défaut 1.0 indique la vitesse créée. Notez qu’une piste audio devient difficile à comprendre à des débits inférieurs à 0,5 ou supérieurs à 1,5. Un taux de lecture de 2 équivaut à deux fois la vitesse de lecture normale.

Lecteur multimédia Windows tentez d’utiliser le plus efficace des quatre modes de lecture différents. Ces modes sont une lecture vidéo fluide avec un pitch audio maintenu, une lecture vidéo fluide avec un pitch audio non maintenu, une lecture vidéo fluide sans audio et une lecture vidéo de l’image clé sans audio. Le mode choisi par le Lecteur dépend de nombreux facteurs, notamment le type de fichier et l’emplacement, le système d’exploitation, le réseau et le serveur.

D’autres considérations s’appliquent également, selon le type de média :

• Fichiers WMV (Windows Media Format) et ASF : les valeurs optimales pour cette propriété sont comprises entre 1 et 10, ou de 1 à 10 pour la lecture inversée. Les valeurs comprises entre 0,5 et 1,0 ou -0,5 et -1,0 peuvent également fonctionner correctement dans les cas où la tonalité audio peut être conservée, par exemple lors de la lecture de fichiers situés sur l’ordinateur local. Les valeurs dont la magnitude absolue est supérieure à 10 sont autorisées, mais ne sont pas très significatives.
• Autres types de supports vidéo : cette propriété peut varier de 0 à 9. Les valeurs négatives ne sont pas autorisées. Les valeurs inférieures à 1 représentent un mouvement lent. Les valeurs supérieures à 9 sont autorisées, mais elles ne sont pas très significatives.

Contrôles. La méthode fastForward remplace la valeur du taux sur 5.0, tandis que les contrôles. La méthode fastReversepasse à 5.0.

Le taux de lecture de certains types de médias ne peut pas être modifié. Utilisez les paramètres. méthode isAvailable pour déterminer si cette propriété peut être spécifiée pour un élément multimédia particulier.

Lecteur multimédia Windows 10 Mobile : cette propriété accepte ou retourne uniquement les valeurs de -5.0, 1.0 ou 5.0.

Exemples

L’exemple suivant crée un élément HTML SELECT qui permet à l’utilisateur de modifier la vitesse de lecture du média actuel. Les options SELECT offrent des vitesses de lecture normales, de demi-vitesse et de double vitesse. L’objet Player a été créé avec l’ID = « Player ».

<!-- Create the HTML SELECT element. -->
<SELECT  ID = pbRATE  NAME = "pbRATE"  LANGUAGE="JScript"
         onChange="
                   /* Test whether playback rate can be set. */
                   if(Player.settings.IsAvailable('Rate'))

                   /* Set the playback rate based on the current
                      value of the SELECT element. */
                   Player.settings.rate = this.value
">

/* Create the OPTION list. */
<OPTION VALUE = 1>NORMAL</OPTION>
<OPTION VALUE = .5>half speed</OPTION>
<OPTION VALUE = 2>2 speed</OPTION>
</SELECT>

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Controls.fastForward

Controls.fastReverse

Objet Settings

Settings.isAvailable