--- title: "Compressor" 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-compressor/ --- # Compressor Controla picos; com sidechain abaixa este bus quando outro soa **Família:** Áudio · **Grupo:** Mixer · **Identificador:** `astra.audio.compressor` · **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 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](/pt-br/snapshot-2026-10-07/api/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](/pt-br/snapshot-2026-10-06/versoes/preview-0-2-3/#mixer-de-áudio) ## 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](/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. ### Compressão | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Limiar**](#field-threshold)
`threshold` | número · dB | -20 | -60 … 0 | | [**Razão**](#field-ratio)
`ratio` | número · : 1 | 4 | 1 … 48 | | [**Ataque**](#field-attack)
`attack` | número · ms | 20 | 0.02 … 250 | | [**Liberação**](#field-release)
`release` | número · ms | 250 | 1 … 2000 | | [**Ativo**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Sidechain**](#field-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**](#field-makeup)
`makeup` | número · dB | 0 | 0 … 24 | | [**Mistura**](#field-mix)
`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](/pt-br/snapshot-2026-10-06/roadmap/audio/). 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](https://docs.godotengine.org/en/4.5/classes/class_audioeffectcompressor.html). 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](/pt-br/snapshot-2026-10-07/api/astra-components-audiocompressor/#membros)