diff options
Diffstat (limited to 'files/fr/web/api/audiobuffer')
| -rw-r--r-- | files/fr/web/api/audiobuffer/audiobuffer/index.md | 74 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/copyfromchannel/index.md | 72 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/copytochannel/index.md | 72 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/duration/index.md | 58 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/getchanneldata/index.md | 67 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/index.md | 95 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/length/index.md | 70 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/numberofchannels/index.md | 69 | ||||
| -rw-r--r-- | files/fr/web/api/audiobuffer/samplerate/index.md | 69 |
9 files changed, 263 insertions, 383 deletions
diff --git a/files/fr/web/api/audiobuffer/audiobuffer/index.md b/files/fr/web/api/audiobuffer/audiobuffer/index.md index ce67efa5e8..cb565da1f0 100644 --- a/files/fr/web/api/audiobuffer/audiobuffer/index.md +++ b/files/fr/web/api/audiobuffer/audiobuffer/index.md @@ -3,47 +3,33 @@ title: AudioBuffer() slug: Web/API/AudioBuffer/AudioBuffer translation_of: Web/API/AudioBuffer/AudioBuffer --- -<p>{{APIRef("Web Audio API")}}{{SeeCompatTable}}</p> - -<p>Le constructeur <strong><code>AudioBuffer</code></strong> créer un nouvel objet {{domxref("AudioBuffer")}}.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox">var audioBuffer = new AudioBuffer([options]); -var audioBuffer = new AudioBuffer(context[, options]);</pre> - -<h3 id="Parameters">Parameters</h3> - -<dl> - <dt><em>context </em>{{obsolete_inline("")}}</dt> - <dd>Référence à un {{domxref("AudioContext")}}. Ce paramètre a été supprimer de la specification. Consultez la section Compatibilité du navigateur pour plus de détails.</dd> - <dt><em>options</em> {{optional_inline}}</dt> - <dd>Les options sont les suivantes: - <ul> - <li><code>length</code>: Longueur de l'échantillonnage du tampon.</li> - <li><code>numberOfChannels</code>: Nombre de cannaux du buffer. La valeur par défaut est 1. </li> - <li><code>sampleRate</code>: Taux d'échantillonnage du buffer en Hz. La valeur par défaut est le taux d'échantillonnage du <code>context</code> utilisé dans la construction de cet objet </li> - </ul> - </dd> -</dl> - -<h2 id="Spécifications">Spécifications</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','#AudioBuffer','AudioBuffer')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_Navigateurs">Compatibilité des Navigateurs</h2> - -<p>{{Compat("api.AudioBuffer.AudioBuffer")}}</p> +{{APIRef("Web Audio API")}}{{SeeCompatTable}} + +Le constructeur **`AudioBuffer`** créer un nouvel objet {{domxref("AudioBuffer")}}. + +## Syntax + + var audioBuffer = new AudioBuffer([options]); + var audioBuffer = new AudioBuffer(context[, options]); + +### Parameters + +- *context* {{obsolete_inline("")}} + - : Référence à un {{domxref("AudioContext")}}. Ce paramètre a été supprimer de la specification. Consultez la section Compatibilité du navigateur pour plus de détails. +- _options_ {{optional_inline}} + + - : Les options sont les suivantes: + + - `length`: Longueur de l'échantillonnage du tampon. + - `numberOfChannels`: Nombre de cannaux du buffer. La valeur par défaut est 1. + - `sampleRate`: Taux d'échantillonnage du buffer en Hz. La valeur par défaut est le taux d'échantillonnage du `context` utilisé dans la construction de cet objet + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('Web Audio API','#AudioBuffer','AudioBuffer')}} | {{Spec2('Web Audio API')}} | Définition initiale | + +## Compatibilité des Navigateurs + +{{Compat("api.AudioBuffer.AudioBuffer")}} diff --git a/files/fr/web/api/audiobuffer/copyfromchannel/index.md b/files/fr/web/api/audiobuffer/copyfromchannel/index.md index 2ae87ca120..16936ddad9 100644 --- a/files/fr/web/api/audiobuffer/copyfromchannel/index.md +++ b/files/fr/web/api/audiobuffer/copyfromchannel/index.md @@ -8,55 +8,41 @@ tags: - Web Audio API translation_of: Web/API/AudioBuffer/copyFromChannel --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<p>La méthode <code>copyFromChannel() </code>de l'interface {{ domxref("AudioBuffer") }} copie les échantillons de l'un des canaux de l'<code>AudioBuffer</code> dans un tableau.</p> +La méthode `copyFromChannel() `de l'interface {{ domxref("AudioBuffer") }} copie les échantillons de l'un des canaux de l'`AudioBuffer` dans un tableau. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>tableauDonnees</em>.copyFromChannel(<em>destination</em>,numeroCanal,decalageDebut);</pre> + tableauDonnees.copyFromChannel(destination,numeroCanal,decalageDebut); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><em>destination</em></dt> - <dd>Un tableau {{domxref("Float32Array")}} dans lequel copier les données.</dd> - <dt><em>channelNumber</em></dt> - <dd>Le numéro du canal de l'AudioBuffer depuis lequel copier les données. Si <em>channelNumber</em> est supérieur ou égal à {{domxref("AudioBuffer.numberOfChannels")}}, une exception <code>INDEX_SIZE_ERR est</code> levée.</dd> - <dt><em>startInChannel</em> {{optional_inline}}</dt> - <dd>Un offset optionnel à partir duquel copier les données. Si la valeur de <em>startInChannel</em> est supérieure à {{domxref("AudioBuffer.length")}}, une exception <code>INDEX_SIZE_ERR</code> est levée.</dd> -</dl> +- _destination_ + - : Un tableau {{domxref("Float32Array")}} dans lequel copier les données. +- _channelNumber_ + - : Le numéro du canal de l'AudioBuffer depuis lequel copier les données. Si *channelNumber* est supérieur ou égal à {{domxref("AudioBuffer.numberOfChannels")}}, une exception `INDEX_SIZE_ERR est` levée. +- _startInChannel_ {{optional_inline}} + - : Un offset optionnel à partir duquel copier les données. Si la valeur de *startInChannel* est supérieure à {{domxref("AudioBuffer.length")}}, une exception `INDEX_SIZE_ERR` est levée. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">var tableauDonnees = contextAudio.createBuffer(2, frameCount, contextAudio.sampleRate); +```js +var tableauDonnees = contextAudio.createBuffer(2, frameCount, contextAudio.sampleRate); var autreTableau = new Float32Array(length); tableauDonnees.copyFromChannel(autreTableau,1,0); -</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-AudioBuffer-copyFromChannel-void-Float32Array-destination-long-channelNumber-unsigned-long-startInChannel', 'copyFromChannel')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> - -<p>{{Compat("api.AudioBuffer.copyFromChannel")}}</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> +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-copyFromChannel-void-Float32Array-destination-long-channelNumber-unsigned-long-startInChannel', 'copyFromChannel')}} | {{Spec2('Web Audio API')}} | | + +## Compatibilité navigateurs + +{{Compat("api.AudioBuffer.copyFromChannel")}} + +## Voir aussi + +- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) diff --git a/files/fr/web/api/audiobuffer/copytochannel/index.md b/files/fr/web/api/audiobuffer/copytochannel/index.md index 38a6393ebc..2dffa72fa8 100644 --- a/files/fr/web/api/audiobuffer/copytochannel/index.md +++ b/files/fr/web/api/audiobuffer/copytochannel/index.md @@ -3,58 +3,44 @@ title: AudioBuffer.copyToChannel() slug: Web/API/AudioBuffer/copyToChannel translation_of: Web/API/AudioBuffer/copyToChannel --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<p>La méthode <code>copyToChannel() </code>de l'interface {{ domxref("AudioBuffer") }} copie les échantillons du tableau source vers le canal de l'<code>AudioBuffer</code> spécifié.</p> +La méthode `copyToChannel() `de l'interface {{ domxref("AudioBuffer") }} copie les échantillons du tableau source vers le canal de l'`AudioBuffer` spécifié. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>myArrayBuffer</em>.copyToChannel(<em>source</em>, <em>channelNumber</em>, <em>startInChannel</em>);</pre> + myArrayBuffer.copyToChannel(source, channelNumber, startInChannel); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><em>source</em></dt> - <dd>Le tableau {{jsxref("Float32Array")}} depuis lequel copier les données.</dd> - <dt><em>channelNumber</em></dt> - <dd>Le numéro du canal de l'{{domxref("AudioBuffer")}} dans lequel copier les données. Si <em>channelNumber</em> est supérieur ou égal à {{domxref("AudioBuffer.numberOfChannels")}}, une exception <code>INDEX_SIZE_ERR est</code> levée.</dd> - <dt><em>startInChannel {{optional_inline}}</em></dt> - <dd>Un offset optionnel à partir duquel copier les données. Si la valeur de <em>startInChannel</em> est supérieure à {{domxref("AudioBuffer.length")}}, une exception <code>INDEX_SIZE_ERR</code> est levée.</dd> -</dl> +- _source_ + - : Le tableau {{jsxref("Float32Array")}} depuis lequel copier les données. +- _channelNumber_ + - : Le numéro du canal de l'{{domxref("AudioBuffer")}} dans lequel copier les données. Si *channelNumber* est supérieur ou égal à {{domxref("AudioBuffer.numberOfChannels")}}, une exception `INDEX_SIZE_ERR est` levée. +- _startInChannel {{optional_inline}}_ + - : Un offset optionnel à partir duquel copier les données. Si la valeur de *startInChannel* est supérieure à {{domxref("AudioBuffer.length")}}, une exception `INDEX_SIZE_ERR` est levée. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">var tableauDonnees = contextAudio.createBuffer(2, frameCount, contextAudio.sampleRate); +```js +var tableauDonnees = contextAudio.createBuffer(2, frameCount, contextAudio.sampleRate); var autreTableau = new Float32Array; // Copy les données depuis le second canal vers le second tableau. tableauDonnees.copyFromChannel(autreTableau,1,0); // Copie les données depuis le second tableau vers le premier canal du premier tableau. A présent les deux canaux ont des données identiques. tableauDonnees.copyToChannel (autreTableau,0,0); -</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-AudioBuffer-copyToChannel-void-Float32Array-source-long-channelNumber-unsigned-long-startInChannel', 'copyToChannel')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> - -<p>{{Compat("api.AudioBuffer.copyToChannel")}}</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> +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-copyToChannel-void-Float32Array-source-long-channelNumber-unsigned-long-startInChannel', 'copyToChannel')}} | {{Spec2('Web Audio API')}} | | + +## Compatibilité navigateurs + +{{Compat("api.AudioBuffer.copyToChannel")}} + +## Voir aussi + +- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) diff --git a/files/fr/web/api/audiobuffer/duration/index.md b/files/fr/web/api/audiobuffer/duration/index.md index 447932473d..ffb7fdaeae 100644 --- a/files/fr/web/api/audiobuffer/duration/index.md +++ b/files/fr/web/api/audiobuffer/duration/index.md @@ -3,24 +3,25 @@ title: AudioBuffer.duration slug: Web/API/AudioBuffer/duration translation_of: Web/API/AudioBuffer/duration --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<div> -<p>La propriéré <code>duration</code> de l'interface {{ domxref("AudioBuffer") }} renvoie un nombre flottant à double précision représentant la durée, en secondes, des données PCM stockées dans le buffer.</p> -</div> +La propriéré `duration` de l'interface {{ domxref("AudioBuffer") }} renvoie un nombre flottant à double précision représentant la durée, en secondes, des données PCM stockées dans le buffer. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var tableauTampon = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); -tableauTampon.duration;</pre> +```js +var tableauTampon = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); +tableauTampon.duration; +``` -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Nombre flottant à double précision.</p> +Nombre flottant à double précision. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Stereo +```js +// Stereo var nombreCanaux = 2; // Crée une mémoire tampon vide de 2 secondes @@ -31,10 +32,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; @@ -42,31 +43,18 @@ bouton.onclick = function() { } console.log(tableauDonnees.duration); } -</pre> +``` -<h2 id="Spécification">Spécification</h2> +## Spécification -<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-AudioBuffer-duration', 'duration')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-duration', 'duration')}} | {{Spec2('Web Audio API')}} | | -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> +## Compatibilité navigateurs -<p>{{Compat("api.AudioBuffer.duration")}}</p> +{{Compat("api.AudioBuffer.duration")}} -<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) diff --git a/files/fr/web/api/audiobuffer/getchanneldata/index.md b/files/fr/web/api/audiobuffer/getchanneldata/index.md index 7f64f907a0..67b9c0d234 100644 --- a/files/fr/web/api/audiobuffer/getchanneldata/index.md +++ b/files/fr/web/api/audiobuffer/getchanneldata/index.md @@ -3,24 +3,27 @@ title: AudioBuffer.getChannelData() slug: Web/API/AudioBuffer/getChannelData translation_of: Web/API/AudioBuffer/getChannelData --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<p>La méthode <code>getChannelData() </code>de l'interface {{ domxref("AudioBuffer") }} renvoie un {{domxref("Float32Array")}} contenant les données PCM associées au canal spécifié (0 correspondant au premier canal).</p> +La méthode `getChannelData() `de l'interface {{ domxref("AudioBuffer") }} renvoie un {{domxref("Float32Array")}} contenant les données PCM associées au canal spécifié (0 correspondant au premier canal). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var tableauDonnees = contexteAudio.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); -var tampon = tableauDonnees.getChannelData(canal);</pre> +```js +var tableauDonnees = contexteAudio.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); +var tampon = tableauDonnees.getChannelData(canal); +``` -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un {{domxref("Float32Array")}}.</p> +Un {{domxref("Float32Array")}}. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Dans l'exemple suivant crée un buffer de 2 secondes, le remplit avec du bruit blanc puis le lit via un {{ domxref("AudioBufferSourceNode") }}. Vous pouvez aussi <a href="http://mdn.github.io/audio-buffer/">exécuter le code</a>, or <a href="https://github.com/mdn/audio-buffer">voir le code source</a>.</p> +Dans l'exemple suivant crée un buffer de 2 secondes, le remplit avec du bruit blanc puis le lit via un {{ domxref("AudioBufferSourceNode") }}. Vous pouvez aussi [exécuter le code](http://mdn.github.io/audio-buffer/), or [voir le code source](https://github.com/mdn/audio-buffer). -<pre class="brush: js">var contexteAudio = new (window.AudioContext || window.webkitAudioContext)(); +```js +var contexteAudio = new (window.AudioContext || window.webkitAudioContext)(); var bouton = document.querySelector('button'); var preformate = document.querySelector('pre'); var monScript = document.querySelector('script'); @@ -38,10 +41,10 @@ var tableauDonnees = contexteAudio.createBuffer(nombreCanaux, nombreFrames, cont 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; @@ -61,38 +64,24 @@ bouton.onclick = function() { // lance la lecture du so source.start(); -}</pre> +} +``` -<h2 id="Paramètres">Paramètres</h2> +## Paramètres -<dl> - <dt>channel</dt> - <dd>The channel property is an index representing the particular channel to get data for. An index value of 0 represents the first channel. If the <code>channel</code> index value is greater than of equal to {{domxref("AudioBuffer.numberOfChannels")}}, an <code>INDEX_SIZE_ERR</code> exception will be thrown.</dd> -</dl> +- channel + - : The channel property is an index representing the particular channel to get data for. An index value of 0 represents the first channel. If the `channel` index value is greater than of equal to {{domxref("AudioBuffer.numberOfChannels")}}, an `INDEX_SIZE_ERR` exception will be thrown. -<h2 id="Spécification">Spécification</h2> +## Spécification -<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-AudioBuffer-getChannelData-Float32Array-unsigned-long-channel', 'getChannelData')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-getChannelData-Float32Array-unsigned-long-channel', 'getChannelData')}} | {{Spec2('Web Audio API')}} | | -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> +## Compatibilité navigateurs -<p>{{Compat("api.AudioBuffer.getChannelData")}}</p> +{{Compat("api.AudioBuffer.getChannelData")}} -<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) 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) diff --git a/files/fr/web/api/audiobuffer/length/index.md b/files/fr/web/api/audiobuffer/length/index.md index f61ff06e0d..eae0885d58 100644 --- a/files/fr/web/api/audiobuffer/length/index.md +++ b/files/fr/web/api/audiobuffer/length/index.md @@ -3,25 +3,25 @@ title: AudioBuffer.length slug: Web/API/AudioBuffer/length translation_of: Web/API/AudioBuffer/length --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<div> -<p>La propriété <code>length</code> de l'interface {{ domxref("AudioBuffer") }} renvoie un entier représentant la longueur, en trames d'échantillonage, des données PCM stockées dans la mémoire-tampon.</p> -</div> +La propriété `length` de l'interface {{ domxref("AudioBuffer") }} renvoie un entier représentant la longueur, en trames d'échantillonage, des données PCM stockées dans la mémoire-tampon. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var tableauMemoireTampon = contexteAudio.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); +```js +var tableauMemoireTampon = contexteAudio.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); tableauMemoireTampon.length; -</pre> +``` -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un nombre entier.</p> +Un nombre entier. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Stereo +```js +// Stereo var nombreCanaux = 2; // Crée une mémoire tampon vide de 2 secondes @@ -33,41 +33,29 @@ 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; } } console.log(tableauDonnees.length); -}</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-AudioBuffer-length', 'length')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> - -<p>{{Compat("api.AudioBuffer.length")}}</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> +} +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-length', 'length')}} | {{Spec2('Web Audio API')}} | | + +## Compatibilité navigateurs + +{{Compat("api.AudioBuffer.length")}} + +## Voir aussi + +- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) diff --git a/files/fr/web/api/audiobuffer/numberofchannels/index.md b/files/fr/web/api/audiobuffer/numberofchannels/index.md index 470397e34d..0c7c2c1ced 100644 --- a/files/fr/web/api/audiobuffer/numberofchannels/index.md +++ b/files/fr/web/api/audiobuffer/numberofchannels/index.md @@ -3,25 +3,25 @@ title: AudioBuffer.numberOfChannels slug: Web/API/AudioBuffer/numberOfChannels translation_of: Web/API/AudioBuffer/numberOfChannels --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<div> -<p>La propriété <code>numberOfChannels</code> de l'interface {{ domxref("AudioBuffer") }} renvoie un nombre entier représentant le nombre de canaux audio diiscrets décrits par les données PCM stockées dans la mémoire-tampon.</p> -</div> +La propriété `numberOfChannels` de l'interface {{ domxref("AudioBuffer") }} renvoie un nombre entier représentant le nombre de canaux audio diiscrets décrits par les données PCM stockées dans la mémoire-tampon. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var tableauMemoireTampon = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); +```js +var tableauMemoireTampon = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); tableauMemoireTampon.numberOfChannels; -</pre> +``` -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un nombre entier.</p> +Un nombre entier. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Stereo +```js +// Stereo var nombreCanaux = 2; // Crée une mémoire tampon vide de 2 secondes @@ -33,10 +33,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; @@ -44,31 +44,18 @@ bouton.onclick = function() { } console.log(tableauDonnees.numberOfChannels); } -</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-AudioBuffer-numberOfChannels', 'numberOfChannels')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> - -<p>{{Compat("api.AudioBuffer.numberOfChannels")}}</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> +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-numberOfChannels', 'numberOfChannels')}} | {{Spec2('Web Audio API')}} | | + +## Compatibilité navigateurs + +{{Compat("api.AudioBuffer.numberOfChannels")}} + +## Voir aussi + +- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) diff --git a/files/fr/web/api/audiobuffer/samplerate/index.md b/files/fr/web/api/audiobuffer/samplerate/index.md index 79e2abb6d2..7992a06828 100644 --- a/files/fr/web/api/audiobuffer/samplerate/index.md +++ b/files/fr/web/api/audiobuffer/samplerate/index.md @@ -3,25 +3,25 @@ title: AudioBuffer.sampleRate slug: Web/API/AudioBuffer/sampleRate translation_of: Web/API/AudioBuffer/sampleRate --- -<p>{{ APIRef("Web Audio API") }}</p> +{{ APIRef("Web Audio API") }} -<div> -<p>La propriété <code>sampleRate</code> de l'interface {{ domxref("AudioBuffer") }} renvoie un nombre à virgule flottante représentant la taux d'échantillonage, en échantillons par seconde, des données PCM stockées dans la mémoire-tampon.</p> -</div> +La propriété `sampleRate` de l'interface {{ domxref("AudioBuffer") }} renvoie un nombre à virgule flottante représentant la taux d'échantillonage, en échantillons par seconde, des données PCM stockées dans la mémoire-tampon. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var tableauMemoireTampon = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); +```js +var tableauMemoireTampon = audioCtx.createBuffer(nombreCanaux, nombreFrames, contexteAudio.sampleRate); tableauMemoireTampon.sampleRate; -</pre> +``` -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un nombre à virgule flottante indiquant le taux d'échantillonnage actuelle des données du tampon, en echantillonnage par seconde.</p> +Un nombre à virgule flottante indiquant le taux d'échantillonnage actuelle des données du tampon, en echantillonnage par seconde. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Stereo +```js +// Stereo var nombreCanaux = 2; // Crée une mémoire tampon vide de 2 secondes @@ -33,10 +33,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; @@ -44,31 +44,18 @@ bouton.onclick = function() { } console.log(tableauDonnees.sampleRate); } -</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-AudioBuffer-sampleRate', 'sampleRate')}}</td> - <td>{{Spec2('Web Audio API')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_Navigateurs">Compatibilité des Navigateurs</h2> - -<p>{{Compat("api.AudioBuffer.sampleRate")}}</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> +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------- | +| {{SpecName('Web Audio API', '#widl-AudioBuffer-sampleRate', 'sampleRate')}} | {{Spec2('Web Audio API')}} | | + +## Compatibilité des Navigateurs + +{{Compat("api.AudioBuffer.sampleRate")}} + +## Voir aussi + +- [Utiliser la Web Audio API](/fr/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) |