diff options
Diffstat (limited to 'files/fr/web/api/audiobuffer/index.md')
| -rw-r--r-- | files/fr/web/api/audiobuffer/index.md | 95 |
1 files changed, 39 insertions, 56 deletions
diff --git a/files/fr/web/api/audiobuffer/index.md b/files/fr/web/api/audiobuffer/index.md index faa4f0f309..b914ca7a11 100644 --- a/files/fr/web/api/audiobuffer/index.md +++ b/files/fr/web/api/audiobuffer/index.md @@ -8,48 +8,43 @@ tags: - Web Audio API translation_of: Web/API/AudioBuffer --- -<p>{{APIRef("Web Audio API")}}</p> +{{APIRef("Web Audio API")}} -<p>L'interface AudioBuffer représente une ressource audio stockée en mémoire, créée à partir d'un fichier audio avec la méthode {{ domxref("AudioContext.decodeAudioData()") }}, ou à partir de données brutes avec {{ domxref("AudioContext.createBuffer()") }}. Une fois mises en mémoire dans un AudioBuffer, les données audio sont transférées dans un {{ domxref("AudioBufferSourceNode") }} afin d'être lues.<br> - <br> - Ce type d'objet est conçu pour contenir de petit extraits audio, durant généralement moins de 45s. Pour les sons plus longs, les objets implémentant {{domxref ("MediaAudioElementSourceNode")}} sont plus adaptés. La mémoire tampon contient des données au format non entrelacé IEEE 32-bit PCM linéaire, avec une portée nominale comprise entre -1 et +1. S'il y a plusieurs canaux, ils sont stockés dans des mémoires-tampon distinctes.</p> +L'interface AudioBuffer représente une ressource audio stockée en mémoire, créée à partir d'un fichier audio avec la méthode {{ domxref("AudioContext.decodeAudioData()") }}, ou à partir de données brutes avec {{ domxref("AudioContext.createBuffer()") }}. Une fois mises en mémoire dans un AudioBuffer, les données audio sont transférées dans un {{ domxref("AudioBufferSourceNode") }} afin d'être lues. -<h2 id="Constructeur">Constructeur</h2> +Ce type d'objet est conçu pour contenir de petit extraits audio, durant généralement moins de 45s. Pour les sons plus longs, les objets implémentant {{domxref ("MediaAudioElementSourceNode")}} sont plus adaptés. La mémoire tampon contient des données au format non entrelacé IEEE 32-bit PCM linéaire, avec une portée nominale comprise entre -1 et +1. S'il y a plusieurs canaux, ils sont stockés dans des mémoires-tampon distinctes. -<dl> - <dt>{{domxref("AudioBuffer.AudioBuffer", "AudioBuffer()")}}</dt> - <dd>Crée et retourne un nouvel objet <code>AudioBuffer</code>.</dd> -</dl> +## Constructeur -<h2 id="Propriétés">Propriétés</h2> +- {{domxref("AudioBuffer.AudioBuffer", "AudioBuffer()")}} + - : Crée et retourne un nouvel objet `AudioBuffer`. -<dl> - <dt>{{domxref("AudioBuffer.sampleRate")}} {{readonlyInline}}</dt> - <dd>Retourne un nombre flottant qui représente la fréquence d'échantillonnage, en échantillons par seconde, des données PCM stockées dans la mémoire tampon.</dd> - <dt>{{domxref("AudioBuffer.length")}} {{readonlyInline}}</dt> - <dd>Retourne un nombre entier qui représente la longueur, en trames d'échantillonnage , des données PCM stockées dans la mémoire tampon.</dd> - <dt>{{domxref("AudioBuffer.duration")}} {{readonlyInline}}</dt> - <dd>Retourne un nombre à virgule flottante de double précision qui représente la durée, exprimée en secondes, des données PCM stockées dans la mémoire tampon.</dd> - <dt>{{domxref("AudioBuffer.numberOfChannels")}} {{readonlyInline}}</dt> - <dd>Retourne un nombre entier qui représente le nombre de canaux audio discrets décrits par les données PCM stockées dans la mémoire tampon.</dd> -</dl> +## Propriétés -<h2 id="Méthodes">Méthodes</h2> +- {{domxref("AudioBuffer.sampleRate")}} {{readonlyInline}} + - : Retourne un nombre flottant qui représente la fréquence d'échantillonnage, en échantillons par seconde, des données PCM stockées dans la mémoire tampon. +- {{domxref("AudioBuffer.length")}} {{readonlyInline}} + - : Retourne un nombre entier qui représente la longueur, en trames d'échantillonnage , des données PCM stockées dans la mémoire tampon. +- {{domxref("AudioBuffer.duration")}} {{readonlyInline}} + - : Retourne un nombre à virgule flottante de double précision qui représente la durée, exprimée en secondes, des données PCM stockées dans la mémoire tampon. +- {{domxref("AudioBuffer.numberOfChannels")}} {{readonlyInline}} + - : Retourne un nombre entier qui représente le nombre de canaux audio discrets décrits par les données PCM stockées dans la mémoire tampon. -<dl> - <dt>{{domxref("AudioBuffer.getChannelData()")}}</dt> - <dd>Retourne un {{domxref ("Float32Array")}} contenant les données PCM associés au canal, défini par l'index du canal (0 représentant le premier canal).</dd> - <dt>{{domxref("AudioBuffer.copyFromChannel()")}}</dt> - <dd>Copie les échantillons du canal associé à <code>AudioBuffer</code> dans un tableau de destination.</dd> - <dt>{{domxref("AudioBuffer.copyToChannel()")}}</dt> - <dd>Copie les échantillons dans le canal associé à <code>AudioBuffer</code>, depuis le tableau <code>source</code>.</dd> -</dl> +## Méthodes -<h2 id="Exemple">Exemple</h2> +- {{domxref("AudioBuffer.getChannelData()")}} + - : Retourne un {{domxref ("Float32Array")}} contenant les données PCM associés au canal, défini par l'index du canal (0 représentant le premier canal). +- {{domxref("AudioBuffer.copyFromChannel()")}} + - : Copie les échantillons du canal associé à `AudioBuffer` dans un tableau de destination. +- {{domxref("AudioBuffer.copyToChannel()")}} + - : Copie les échantillons dans le canal associé à `AudioBuffer`, depuis le tableau `source`. -<p>L'exemple suivant montre comment créer un <code>AudioBuffer</code> et le remplir avec du bruit blanc. Le code source est disponible sur notre repo <a href="https://github.com/mdn/audio-buffer">audio-buffer demo</a>; une <a href="http://mdn.github.io/audio-buffer/">version live</a> est également consultable.</p> +## Exemple -<pre class="brush: js">// Stéréo +L'exemple suivant montre comment créer un `AudioBuffer` et le remplir avec du bruit blanc. Le code source est disponible sur notre repo [audio-buffer demo](https://github.com/mdn/audio-buffer); une [version live](http://mdn.github.io/audio-buffer/) est également consultable. + +```js +// Stéréo var nombreCanaux = 2; // Crée une mémoire tampon vide de 2 secondes @@ -60,10 +55,10 @@ var tableauDonnees = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteA bouton.onclick = function() { // remplit la mémoire tampon avec du bruit blanc // valeurs aléatoires entre -1.0 et 1.0 - for (var canal = 0; canal < nombreCanaux; canal++) { + for (var canal = 0; canal < nombreCanaux; canal++) { // génère le tableau contenant les données var tampon = tableauDonnees.getChannelData(canal); - for (var i = 0; i < nombreFrames; i++) { + for (var i = 0; i < nombreFrames; i++) { // Math.random() donne une valeur comprise entre [0; 1.0] // l'audio doit être compris entre [-1.0; 1.0] tampon[i] = Math.random() * 2 - 1; @@ -84,31 +79,19 @@ bouton.onclick = function() { // lance la lecture du so source.start(); -}</pre> +} +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<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', '#AudioBuffer-section', 'AudioBuffer')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('Web Audio API', '#AudioBuffer-section', 'AudioBuffer')}} | {{Spec2('Web Audio API')}} | Définition initiale | -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> +## Compatibilité navigateurs -<p>{{Compat("api.AudioBuffer")}}</p> +{{Compat("api.AudioBuffer")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API">Utiliser la Web Audio API</a></li> -</ul> +- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) |