---
title: GainNode
slug: Web/API/GainNode
tags:
  - API
  - Experimental
  - Reference
  - Web Audio API
translation_of: Web/API/GainNode
---
<p>{{ APIRef("Web Audio API") }}</p>

<p>L'interface <strong><code>GainNode</code></strong> représente une variation de volume. Il s'agit d'un {{domxref("AudioNode")}}, c'est un module de traitement audio, qui provoque un gain donné à appliquer à des données d'entrée avant sa propagation à la sortie. Un <code>GainNode</code> a toujours exactement une entrée et une sortie, avec la même quantité de canaux.</p>

<p>Le gain est une valeur sans unité, qui change éventuellement avec le temps, qui est multiplié à chaque échantillon correspondant de tous les canaux entrées. En cas de modification, le nouveau gain est appliqué à l'aide d'un algorithme d'effilochage afin d'éviter aux «clics» inesthétiques d'apparaître dans l'audio résultant.</p>

<p><img alt="Un objet GainNode augmente le gain de la sortie." src="webaudiogainnode.png"></p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row"><dfn>Nombre d'entrées</dfn></th>
   <td><code>1</code></td>
  </tr>
  <tr>
   <th scope="row"><dfn>Nombre de sorties</dfn></th>
   <td><code>1</code></td>
  </tr>
  <tr>
   <th scope="row"><dfn>Mode de comptage des canaux</dfn></th>
   <td><code>"max"</code></td>
  </tr>
  <tr>
   <th scope="row"><dfn>Nombre de canaux</dfn></th>
   <td><code>2</code> (inutilisés dans le mode de comptage par défaut)</td>
  </tr>
  <tr>
   <th scope="row"><dfn>Interprétation des canaux</dfn></th>
   <td><code>"speakers"</code></td>
  </tr>
 </tbody>
</table>

<h2 id="Constructeur">Constructeur</h2>

<dl>
 <dt>{{domxref("GainNode.GainNode", "GainNode()")}}</dt>
 <dd>Crée une nouvelle instance d'un objet <code>GainNode</code>. Il ne faut pas créer un noeud de gain manuellement, mais plutôt utiliser la méthode {{domxref("AudioContext.createGain()")}}.</dd>
</dl>

<h2 id="Propriétés">Propriétés</h2>

<p><em>Hérite des propritétés de son parent, </em><em>{{domxref("AudioNode")}}</em>.</p>

<dl>
 <dt>{{domxref("GainNode.gain")}}</dt>
 <dd>Est un <a href="/fr/docs/Web/API/AudioParam#a-rate">a-rate</a> {{domxref ("AudioParam")}} représentant le montant du gain à appliquer. (Bien que le <code>AudioParam</code> retournée est en lecture seule, la valeur qu'il représente ne l'est pas).</dd>
</dl>

<h2 id="Méthodes">Méthodes</h2>

<p>Aucune méthode spécifique; hérite des méthodes de son parent, {{domxref("AudioNode")}}.</p>

<h2 id="Exemple">Exemple</h2>

<p>{{page("/en-US/docs/Web/API/AudioContext.createGain","Example")}}</p>

<h2 id="Spécification">Spécification</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statuts</th>
   <th scope="col">Commentaire</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Audio API', '#GainNode-section', 'GainNode')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2>

<p>{{Compat("api.GainNode")}}</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li><a href="/en-US/docs/Web_Audio_API/Using_Web_Audio_API">Utiliser l'API Web Audio</a></li>
</ul>