--- title: "Reverberação" version: snapshot-2026-10-07 engineGeneration: astra-current language: C# status: source-reviewed reviewedAt: 2026-10-07 appRelease: "0.2.3-preview.20261007" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/componentes/astra-audio-reverb/ --- # Reverberação Sala simulada com tamanho, amortecimento e pré-atraso **Família:** Áudio · **Grupo:** Mixer · **Identificador:** `astra.audio.reverb` · **Payload:** 1 :::note[Escopo da evidência] Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho. ::: ## Para que usar Acrescenta uma cauda de sala ao Bus de áudio. Use para dar ambiente sonoro a um sinal ou a um bus de envio. Adicione no Bus. Tamanho da sala e Amortecimento controlam a cauda; Pré-atraso em ms separa as primeiras reflexões. Em um bus só de retorno, Sinal original 0 deixa apenas reverberação. ## Criar e configurar Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Mixer** → **Reverberação**. O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.AudioReverb](/pt-br/snapshot-2026-10-07/api/astra-components-audioreverb/). Tamanho da sala é normalizado, não metros nem leitura da geometria. Desligar corta a reverberação. O bus de retorno precisa encaminhar sua saída para um destino audível. **Guia relacionado:** [Mixer e envios](/pt-br/snapshot-2026-10-06/versoes/preview-0-2-3/#mixer-de-áudio) ## Exemplo de uso Use Tamanho .8, Amortecimento .5, Largura 1 e Pré-atraso 20 ms. Compare Mistura 0 e .3 com uma voz curta. Para retorno separado, envie por Envio de áudio e use Sinal original 0 no destino. ## Dependências - [Bus de áudio](/pt-br/snapshot-2026-10-07/componentes/astra-audio-bus/): Adicione Bus de áudio a este objeto: efeitos e envios processam o sinal do bus ## Conflitos Nenhuma regra adicional declarada no schema deste componente. ## Edição e ciclo de vida | Operação | Contrato | |---|---| | Adicionar/remover em Play | ponto seguro | | Alterar propriedades em Play | ponto seguro | | Múltiplas instâncias | Sim | | Versão do payload | 1 | Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/). ## Propriedades Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto. ### Sala | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Tamanho da sala**](#field-room-size)
`room_size` | número | 0.8 | 0 … 1 | | [**Amortecimento**](#field-damping)
`damping` | número | 0.5 | 0 … 1 | | [**Largura**](#field-width)
`width` | número | 1 | 0 … 1 | | [**Pré-atraso**](#field-predelay)
`predelay` | número · ms | 20 | 0 … 500 | | [**Ativo**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso |

Tamanho da sala · room_size

**Onde:** Inspector → **Reverberação** → **Sala** → **Tamanho da sala**. **Uso e efeito:** Tamanho normalizado da sala algorítmica; maior prolonga a cauda. Não é a medida geométrica em metros. **Valor:** 0.8 · **Tipo:** número · **Domínio:** 0 … 1. Aceita tween numérico via contrato de propriedade.

Amortecimento · damping

**Onde:** Inspector → **Reverberação** → **Sala** → **Amortecimento**. **Uso e efeito:** Absorção dos agudos na cauda da reverberação. Compare com um som curto rico em agudos. **Valor:** 0.5 · **Tipo:** número · **Domínio:** 0 … 1. Aceita tween numérico via contrato de propriedade.

Largura · width

**Onde:** Inspector → **Reverberação** → **Sala** → **Largura**. **Uso e efeito:** Abertura estéreo da cauda. Não muda a posição 3D da fonte. **Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Pré-atraso · predelay

**Onde:** Inspector → **Reverberação** → **Sala** → **Pré-atraso**. **Uso e efeito:** Espera em milissegundos antes das primeiras reflexões; 20 significa .02 segundo. **Valor:** 20 · **Tipo:** número · **Unidade:** ms · **Domínio:** 0 … 500.

Ativo · enabled

**Onde:** Inspector → **Reverberação** → **Sala** → **Ativo**. **Uso e efeito:** Desligado corta a reverberação **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. ### Mistura | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Mistura da reverberação**](#field-wet)
`wet` | número | 0.3 | 0 … 1 | | [**Sinal original**](#field-dry)
`dry` | número | 1 | 0 … 1 |

Mistura da reverberação · wet

**Onde:** Inspector → **Reverberação** → **Mistura** → **Mistura da reverberação**. **Uso e efeito:** Ganho do sinal processado pelo efeito. Zero retira essa contribuição; não é porcentagem em 0–100. **Valor:** 0.3 · **Tipo:** número · **Domínio:** 0 … 1. Aceita tween numérico via contrato de propriedade.

Sinal original · dry

**Onde:** Inspector → **Reverberação** → **Mistura** → **Sinal original**. **Uso e efeito:** Ganho do sinal original. Em um bus de retorno com Reverb, zero evita duplicar o caminho seco. **Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1. Aceita tween numérico via contrato de propriedade. ## Roadmap deste componente [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Reverberação algorítmica de bus presente na 0.2.3. Não presume convolução, baking acústico ou leitura automática de uma sala. Sem data de expansão. Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade. ## Conferir na sua cena 1. Crie **Reverberação** pelo fluxo indicado e resolva as dependências. 2. Altere uma propriedade por vez e observe o efeito esperado na cena. 3. Salve, reabra e confira os valores autorais. 4. Entre em Play e verifique o comportamento com os recursos reais do projeto. 5. Pare o Play e confira a cena autoral. Este é um roteiro de conferência; não representa um teste executado nesta publicação. ## Limitações da referência A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas. **Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_audioeffectreverb.html). Essa referência não representa paridade funcional.