---
title: BiquadFilterNode
slug: Web/API/BiquadFilterNode
tags:
  - API
  - BiquadFilterNode
  - CompatibilidadeNavegadorCelular
  - Interface
  - Referencia
  - Web Audio API
translation_of: Web/API/BiquadFilterNode
---
<p>{{APIRef("Web Audio API")}}</p>

<div>
<p><span class="seoSummary">A interface <code>BiquadFilterNode</code> representa um filtro simples de ordem baixa, e é criada utilizando o método {{ domxref("AudioContext.createBiquadFilter()") }} . É o {{domxref("AudioNode")}} que pode representar diferentes tipos de filtros, dispositivo de controle de timbre, e equalizadores gráficos. </span>Um <code>BiquadFilterNode</code> sempre tem exatamente uma entrada e uma saída.</p>
</div>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">Número de entradas</th>
   <td><code>1</code></td>
  </tr>
  <tr>
   <th scope="row">Número de saídas</th>
   <td><code>1</code></td>
  </tr>
  <tr>
   <th scope="row">Modo de contagem de canal</th>
   <td><code>"max"</code></td>
  </tr>
  <tr>
   <th scope="row">Contagem de canal</th>
   <td><code>2</code> (não utilizado no modo de contagem padrão)</td>
  </tr>
  <tr>
   <th scope="row">Interpretação de canal</th>
   <td><code>"speakers"</code></td>
  </tr>
 </tbody>
</table>

<h2 id="Construtor">Construtor</h2>

<dl>
 <dt>{{domxref("BiquadFilterNode.BiquadFilterNode", "BiquadFilterNode()")}}</dt>
 <dd>Cria uma nova instância de um objeto do tipo <code>BiquadFilterNode</code>.</dd>
</dl>

<h2 id="Propriedades">Propriedades</h2>

<p><em>Herda as propriedades de seu pai, </em><em>{{domxref("AudioNode")}}</em>.</p>

<dl>
 <dt>{{domxref("BiquadFilterNode.frequency")}}</dt>
 <dd>É um <a href="/en-US/docs/Web/API/AudioParam#a-rate">a-rate</a> {{domxref("AudioParam")}}, um double que representa a frequência no algoritmo de filtragem atual, medido em hertz (Hz).</dd>
 <dt>{{domxref("BiquadFilterNode.detune")}}</dt>
 <dd>É um  <a href="/en-US/docs/Web/API/AudioParam#a-rate">a-rate</a> {{domxref("AudioParam")}} representando a dessintonização da frequência em <a class="external external-icon" href="http://en.wikipedia.org/wiki/Cent_%28music%29">cents</a>.</dd>
 <dt>{{domxref("BiquadFilterNode.Q")}}</dt>
 <dd>É um <a href="/en-US/docs/Web/API/AudioParam#a-rate">a-rate</a> {{domxref("AudioParam")}}, um double representando um <a href="http://en.wikipedia.org/wiki/Q_factor">Q factor</a>, ou<em> fator de qualidade</em>.</dd>
 <dt>{{domxref("BiquadFilterNode.gain")}} {{readonlyInline}}</dt>
 <dd>É um <a href="/en-US/docs/Web/API/AudioParam#a-rate">a-rate</a> {{domxref("AudioParam")}}, um double representando o <a href="http://en.wikipedia.org/wiki/Gain">gain</a> utilizado no algoritmo de filtragem atual.</dd>
 <dt>{{domxref("BiquadFilterNode.type")}}</dt>
 <dd>É um valor string que define o tipo de algoritmo de filtragem que o nó está implementando.<br>

 <table class="standard-table">
  <caption>O significado dos diferentes parâmetros de acordo com o tipo de filtro (detune tem o mesmo significado, então não está listado abaixo)</caption>
  <thead>
   <tr>
    <th scope="row"><code>tipo</code></th>
    <th scope="col">Descrição</th>
    <th scope="col"><code>frequência</code></th>
    <th scope="col"><code>Q</code></th>
    <th scope="col"><code>ganho</code></th>
   </tr>
  </thead>
  <tbody>
   <tr>
    <th scope="row"><code>lowpass</code></th>
    <td>
     <p>Filtro de resonância lowpass padrão de segunda ordem com 12dB/octave rolloff. Frequências abaixo do ponto de corte passam; frequências acima são atenuadas.</p>
    </td>
    <td>A frequência de corte.</td>
    <td>Indica o quão perto a frequência chegou em relação ao ponto de corte. Quantomaior o valor, maior será a aproximação.</td>
    <td><em>Não utilizado</em></td>
   </tr>
   <tr>
    <th scope="row"><code>highpass</code></th>
    <td>Filtro de resonância highpass padrão de segunda ordem com 12dB/octave rolloff. Frequências abaixo do ponto de corte são atenuadas; frequências acima passam.</td>
    <td>A frequência de corte.</td>
    <td>Indica o quão perto a frequência chegou em relação ao ponto de corte. Quantomaior o valor, maior será a aproximação.</td>
    <td><em>Não utilizado</em></td>
   </tr>
   <tr>
    <th scope="row"><code>bandpass</code></th>
    <td>Filtro bandpass padrão de segunda ordem. Frequências fora do dado limite de frequências são atenuadas; frequências dentro do limite passam.</td>
    <td>O centro de alcance de frequências.</td>
    <td>Controla a largura da banda de frequência. Quanto maior o valor <code>Q</code>, menor a frequência de banda.</td>
    <td><em>Não utilizado</em></td>
   </tr>
   <tr>
    <th scope="row"><code>lowshelf</code></th>
    <td>Filtro lowshelf padrão de segunda ordem. Frequências menores que a frequência recebem um aumento, ou uma atenuação; frequências maiores não sofrem alterações.</td>
    <td>O limite superior das frequênicas recebe um aumento ou atenuação.</td>
    <td><em>Não utilizado</em></td>
    <td>O aumento, em dB, para ser aplicado; se negativo, ele será uma atenuação.</td>
   </tr>
   <tr>
    <th scope="row"><code>highshelf</code></th>
    <td>Filtro highshelf padrão de segunda ordem. Frequências maiores que a frequência recebem aumento ou atenuação; frequências abaixo disso não sofrem alterações.</td>
    <td>O limite inferior de frequências recebe aumento ou uma atenuação.</td>
    <td><em>Não utilizado</em></td>
    <td>
     <p>O aumento, em dB, para ser aplicado; se negativo, ele será uma atenuação.</p>
    </td>
   </tr>
   <tr>
    <th scope="row"><code>peaking</code></th>
    <td>Frequências dentro da faixa de frequencias  recebem aumento ou atenuação; frequências fora da faixa não sofrem alterações.</td>
    <td>O meio da faixa de frequência recebe um aumento ou uma atenuação.</td>
    <td>Controla a largura da banda de frequência. Quanto maior o valor <code>Q</code>, menor a frequência de banda.</td>
    <td>O aumento, em dB, para ser aplicado; se negativo, ele será uma atenuação.</td>
   </tr>
   <tr>
    <th scope="row"><code>notch</code></th>
    <td>Filtro <a href="http://en.wikipedia.org/wiki/Band-stop_filter" title="/en-US/docs/">notch</a> padrão, também chamado de filtro <em>band-stop</em> ou <em>band-rejection</em>. É o oposto do filtro de de bandpass: frequências fora da faixa de frequências atribuída passam; frequências de dentro da faixa são atenuadas.</td>
    <td>O centro de alcance de frequências.</td>
    <td>Controla a largura da banda de frequência. Quanto maior o valor <code>Q</code>, menor a frequência de banda.</td>
    <td><em>Não utilizado</em></td>
   </tr>
   <tr>
    <th scope="row"><code>allpass</code></th>
    <td>Filtro <a href="http://en.wikipedia.org/wiki/All-pass_filter#Digital_Implementation" title="/en-US/docs/">allpass</a> padrão de segunda ordem. Permite que todas as frequências passem, porém altera a relação de fase entre as diversas frequências.</td>
    <td>A frequência com o máximo <a href="http://en.wikipedia.org/wiki/Group_delay_and_phase_delay" title="/en-US/docs/">group delay</a>, ou seja, a frequência onde o centro da fase de transição ocorre.</td>
    <td>Controla o quão apurada a transição é na frequência média. Quanto maior este parâmetro, mais apurada e ampla será a transição</td>
    <td><em>Não utilizado</em></td>
   </tr>
  </tbody>
 </table>
 </dd>
</dl>

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

<p><em>Herda os métodos de seu pai, </em><em>{{domxref("AudioNode")}}</em>.</p>

<dl>
 <dt>{{domxref("BiquadFilterNode.getFrequencyResponse()")}}</dt>
 <dd>A partir dos parâmetros de configuração do filtro atual, este método calcula a frequência de resposta para frequências especificadas no array de frequências.</dd>
</dl>

<h2 id="Exemplo">Exemplo</h2>

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

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Audio API', '#the-biquadfilternode-interface', 'BiquadFilterNode')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

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

<h2 id="Veja_também">Veja também</h2>

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