Compressor

Família: Áudio · Grupo: Mixer · Identificador: astra.audio.compressor · 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

Reduz picos acima de um limiar. Com Sidechain, reduz o bus quando outro bus toca: a música abaixa durante a fala.

Adicione no Bus da música. Para ducking, atribua o Bus das falas em Sidechain. Sem referência ele mede seu próprio sinal. Ajuste Limiar em dB, Razão e Ataque/Liberação em ms.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Áudio / Mixer → Compressor.

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

Atalho: + → Áudio → Bus com ducking; escolha o bus de fala no seletor. O outro bus ainda precisa existir e receber a fonte. Ganho de compensação recupera nível de saída; não elimina a compressão.

Guia relacionado: Ducking passo a passo

Exemplo de uso

Com música e fala WAV roteadas a buses separados, use Limiar −20 dB, Razão 4, Ataque 20 ms e Liberação 250 ms. Atribua Falas ao Sidechain da música. Toque fala e confira Redução em dB no cartão do Compressor; a música deve recuperar o ganho após a liberação.

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.

Compressão

Propriedade	Tipo / unidade	Padrão	Domínio
Limiar threshold	número · dB	-20	-60 … 0
Razão ratio	número · : 1	4	1 … 48
Ataque attack	número · ms	20	0.02 … 250
Liberação release	número · ms	250	1 … 2000
Ativo enabled	booleano	verdadeiro	verdadeiro | falso
Sidechain sidechain	referência	Próprio sinal	astra.audio.bus · outro objeto

Limiar · threshold

Onde: Inspector → Compressor → Compressão → Limiar.

Uso e efeito: Nível em dB acima do qual o detector provoca redução de ganho; com Sidechain mede o outro Bus.

Valor: -20 · Tipo: número · Unidade: dB · Domínio: -60 … 0.

Aceita tween numérico via contrato de propriedade.

Razão · ratio

Onde: Inspector → Compressor → Compressão → Razão.

Uso e efeito: Razão de compressão: 4 significa que 4 dB acima do limiar resultam em 1 dB acima dele.

Valor: 4 · Tipo: número · Unidade: : 1 · Domínio: 1 … 48.

Ataque · attack

Onde: Inspector → Compressor → Compressão → Ataque.

Uso e efeito: Tempo em milissegundos para reagir à redução; pequeno reage rápido aos picos.

Valor: 20 · Tipo: número · Unidade: ms · Domínio: 0.02 … 250.

Liberação · release

Onde: Inspector → Compressor → Compressão → Liberação.

Uso e efeito: Tempo em milissegundos para recuperar ganho após cair abaixo do limiar; controla a volta da música no ducking.

Valor: 250 · Tipo: número · Unidade: ms · Domínio: 1 … 2000.

Ativo · enabled

Onde: Inspector → Compressor → Compressão → Ativo.

Uso e efeito: Desligado deixa o sinal passar sem alteração

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Sidechain · sidechain

Onde: Inspector → Compressor → Compressão → Sidechain.

Uso e efeito: Comprime quando OUTRO bus soa: música abaixa quando há fala (ducking)

Valor: Próprio sinal · Tipo: referência · Domínio: astra.audio.bus · outro objeto.

Saída

Propriedade	Tipo / unidade	Padrão	Domínio
Ganho de compensação makeup	número · dB	0	0 … 24
Mistura mix	número	1	0 … 1

Ganho de compensação · makeup

Onde: Inspector → Compressor → Saída → Ganho de compensação.

Uso e efeito: Ganho de saída em dB aplicado após compressão; ajuste sem saturar o bus.

Valor: 0 · Tipo: número · Unidade: dB · Domínio: 0 … 24.

Mistura · mix

Onde: Inspector → Compressor → Saída → Mistura.

Uso e efeito: Mistura do sinal comprimido com o original; 1 = processado, valores menores permitem compressão paralela.

Valor: 1 · Tipo: número · Domínio: 0 … 1.

Aceita tween numérico via contrato de propriedade.

Roadmap deste componente

Áudio. Compressão e ducking presentes na 0.2.3. Não é automix universal, loudness normalizado ou sistema de diálogos completo. Sem data prometida.

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

Comandos e leituras em Play

Os IDs abaixo são operações nativas do componente existente. Não são novos botões de autoria. Use a fachada C# correspondente para nomes e assinaturas; Conexão de evento oferece as ações compatíveis no seletor. Confira o componente e o mundo vivos antes de chamar.

Operação / ID	Uso e efeito	Argumentos	Retorno
Redução (dB) · reduction_db	Quanto o compressor está abaixando agora	Nenhum	número

Assinaturas da fachada AudioCompressor