--- title: AudioBufferSourceNode.playbackRate slug: Web/API/AudioBufferSourceNode/playbackRate translation_of: Web/API/AudioBufferSourceNode/playbackRate --- <p>{{ APIRef("Web Audio API") }}</p> <div> <p>La propriété <code>playbackRate</code> de l'interface {{ domxref("AudioBufferSourceNode") }} est un {{domxref("AudioParam")}} de type <a href="/en-US/docs/DOM/AudioParam#k-rate">k-rate</a> qui définit la vitesse à laquelle le contenu audio sera lu.</p> </div> <p>Une valeur de 1.0 (c'est ) indique que le son doit être lu à la vitesse de son taux d'échantillonnage, une valeur inférieure qu'il doit être lu plus lentement, et une valeur supérieure plus rapidement. la valeur par défaut est <code>1.0</code>. Pour toute autre valeur l'<code>AudioBufferSourceNode</code> rééchantillone le son avant de l'envoyer vers la sortie.</p> <h2 id="Syntaxe">Syntaxe</h2> <pre class="brush: js">var source = contexteAudio.createBufferSource(); source.playbackRate.value = 1.25; // proportion : 25% plus rapide que la vitesse normale </pre> <div class="note"> <p><strong>Note :</strong> Bien que le <code>AudioParam</code> renvoyé soit en lecture seule, la valeur qu'il représente ne l'est pas.</p> </div> <h3 id="Valeur">Valeur</h3> <p>Un {{domxref("AudioParam")}} dont la {{domxref("AudioParam.value", "value")}} est un nombre flottant à double précision, qui représente la vitesse de lecture d'un son en proportion décimale du taux d'échantillonnage original.</p> <p>Considérons un buffer audio échantillonné à 44.1 kHz (44,100 échantillons par seconde). Observons l'effet de quelques valeurs de la propriété <code>playbackRate</code> :</p> <ul> <li>un <code>playbackRate</code> de 1.0 entraîne une lecture à vitesse originale : 44,100 Hz.</li> <li>un <code>playbackRate</code> de 0.5 entraîne une lecture à la moitié de la vitesse originale : 22,050 Hz.</li> <li>un <code>playbackRate</code> de 2.0 entraîne une lecture au double de la vitesse originale : 88,200 Hz.</li> </ul> <h2 id="Exemple">Exemple</h2> <p>Dans cet exemple, la fonction {{domxref("AudioContext.decodeAudioData")}} est utilisée pour décoder une piste audio et la mettre dans un {{domxref("AudioBufferSourceNode")}}. L'interface fournit deux boutons pour démarrer et arrêter la lecture, et des sliders pour modifier les propriétés <code>playbackRate</code>, <code>loopStart</code> et <code>loopEnd</code> à la volée.</p> <div class="note"> <p><strong>Note :</strong> Voir <a href="http://mdn.github.io/decode-audio-data/"> l'exemple complet</a> et <a href="https://github.com/mdn/decode-audio-data">son code source</a>.</p> </div> <pre class="brush: html"><input class="playback-rate-control" type="range" min="0.25" max="3" step="0.05" value="1"> <span class="playback-rate-value">1.0</span> </pre> <pre class="brush: js">function getData() { source = contexteAudio.createBufferSource(); requete = new XMLHttpRequest(); requete.open('GET', 'viper.ogg', true); requete.responseType = 'arraybuffer'; requete.onload = function() { var donneesAudio = requete.response; contexteAudio.decodeAudioData(donneesAudio, function(buffer) { maMemoireTampon = buffer; dureeMorceau = buffer.duration; source.buffer = maMemoireTampon; source.playbackRate.value = playbackControl.value; source.connect(contexteAudio.destination); source.loop = true; loopstartControl.setAttribute('max', Math.floor(dureeMorceau)); loopendControl.setAttribute('max', Math.floor(dureeMorceau)); }, function(e){"Erreur lors du décodage des données audio " + e.err}); } requete.send(); } // connecte les boutons pour lancer et arrêter la lecture, et modifier la vitesse de lecture play.onclick = function() { getData(); source.start(0); play.setAttribute('disabled', 'disabled'); playbackControl.removeAttribute('disabled'); } stop.onclick = function() { source.stop(0); play.removeAttribute('disabled'); playbackControl.setAttribute('disabled', 'disabled'); } playbackControl.oninput = function() { source.playbackRate.value = playbackControl.value; playbackValue.innerHTML = playbackControl.value; }</pre> <h2 id="Spécification">Spécification</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">Spécification</th> <th scope="col">Statut</th> <th scope="col">Commentaire</th> </tr> <tr> <td>{{SpecName('Web Audio API', '#widl-AudioBufferSourceNode-playbackRate', 'playbackRate')}}</td> <td>{{Spec2('Web Audio API')}}</td> <td> </td> </tr> </tbody> </table> <h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> <p>{{Compat("api.AudioBufferSourceNode.playbackRate")}}</p> <h2 id="Voir_aussi">Voir aussi</h2> <ul> <li><a href="/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API">Utiliser la Web Audio API</a></li> </ul>