Reverberação

Família: Áudio · Grupo: Mixer · Identificador: astra.audio.reverb · Payload: 1

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.

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

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: 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.

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 room_size	número	0.8	0 … 1
Amortecimento damping	número	0.5	0 … 1
Largura width	número	1	0 … 1
Pré-atraso predelay	número · ms	20	0 … 500
Ativo 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 wet	número	0.3	0 … 1
Sinal original 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. 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. Essa referência não representa paridade funcional.