--- title: "Snapshot de mixer" 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-snapshot/ --- # Snapshot de mixer Leva ganhos e efeitos a valores salvos com transição **Família:** Áudio · **Grupo:** Mixer · **Identificador:** `astra.audio.snapshot` · **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 Guarda até oito valores-alvo de mixer e faz uma transição entre o estado atual e esses valores. Use para água, pausa ou mudanças de ambiente sonoro. Para cada slot, escolha Objeto (o Bus ou o objeto do efeito), Parâmetro e Valor. O parâmetro determina a unidade e a faixa real; o limite amplo da tabela de Valor não contorna o destino. Slots sem destino não configuram um efeito. ## Criar e configurar Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Mixer** → **Snapshot de mixer**. O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.AudioSnapshot](/pt-br/snapshot-2026-10-07/api/astra-components-audiosnapshot/). Parâmetros aceitos: ganho do bus (linear), corte do filtro (Hz), Q, ganho do filtro (dB), mistura de Eco/Reverb, tamanho do Reverb, nível de Envio e limiar do Compressor (dB). A seleção usa o primeiro componente daquele tipo no objeto; se houver dois filtros, não presume escolher o segundo. Transição usa tempo real. Não guarda a cena, clipes ou o progresso de gameplay. **Guia relacionado:** [Mixer e comandos](/pt-br/snapshot-2026-10-06/versoes/preview-0-2-3/#mixer-de-áudio) ## Exemplo de uso No slot 1, selecione um Bus de música, Parâmetro Ganho do bus e Valor .3; Transição 1 s. Em Play, a fachada AudioSnapshot.TransitionTo(1f) leva o ganho ao alvo. Aplicar ao iniciar liga aplicação imediata no primeiro quadro, sem transição. Prepare outro snapshot com ganho 1 para restaurar. ## Dependências Nenhuma regra adicional declarada no schema deste componente. ## 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 | Não | | 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. ### Snapshot | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Transição**](#field-transition)
`transition` | número · s | 1 | 0 … 60 | | [**Ativo**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Aplicar ao iniciar**](#field-apply-at-start)
`apply_at_start` | booleano | falso | verdadeiro \| falso |

Transição · transition

**Onde:** Inspector → **Snapshot de mixer** → **Snapshot** → **Transição**. **Uso e efeito:** Tempo real até os valores do snapshot **Valor:** 1 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 60.

Ativo · enabled

**Onde:** Inspector → **Snapshot de mixer** → **Snapshot** → **Ativo**. **Uso e efeito:** Desligado recusa transições **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Aplicar ao iniciar · apply_at_start

**Onde:** Inspector → **Snapshot de mixer** → **Snapshot** → **Aplicar ao iniciar**. **Uso e efeito:** Os valores entram no primeiro quadro do Play, sem transição **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. ### Valores | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Valor**](#field-slot-0-value)
`slot_0_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-1-value)
`slot_1_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-2-value)
`slot_2_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-3-value)
`slot_3_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-4-value)
`slot_4_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-5-value)
`slot_5_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-6-value)
`slot_6_value` | número | 1 | -100000 … 100000 | | [**Valor**](#field-slot-7-value)
`slot_7_value` | número | 1 | -100000 … 100000 | | [**Parâmetro**](#field-slot-0-parameter)
`slot_0_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-1-parameter)
`slot_1_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-2-parameter)
`slot_2_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-3-parameter)
`slot_3_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-4-parameter)
`slot_4_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-5-parameter)
`slot_5_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-6-parameter)
`slot_6_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Parâmetro**](#field-slot-7-parameter)
`slot_7_parameter` | enumeração | Ganho do bus | Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor | | [**Objeto 1**](#field-slot-0-target)
`slot_0_target` | referência | Nenhum | qualquer objeto | | [**Objeto 2**](#field-slot-1-target)
`slot_1_target` | referência | Nenhum | qualquer objeto | | [**Objeto 3**](#field-slot-2-target)
`slot_2_target` | referência | Nenhum | qualquer objeto | | [**Objeto 4**](#field-slot-3-target)
`slot_3_target` | referência | Nenhum | qualquer objeto | | [**Objeto 5**](#field-slot-4-target)
`slot_4_target` | referência | Nenhum | qualquer objeto | | [**Objeto 6**](#field-slot-5-target)
`slot_5_target` | referência | Nenhum | qualquer objeto | | [**Objeto 7**](#field-slot-6-target)
`slot_6_target` | referência | Nenhum | qualquer objeto | | [**Objeto 8**](#field-slot-7-target)
`slot_7_target` | referência | Nenhum | qualquer objeto |

Valor · slot_0_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_1_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_2_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_3_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_4_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_5_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_6_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Valor · slot_7_value

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Valor**. **Uso e efeito:** Valor-alvo deste slot de mixer, na unidade do Parâmetro selecionado (Hz, dB ou ganho linear). A escrita é limitada pela faixa do destino; a faixa ampla deste campo não a contorna. **Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_0_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_1_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_2_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_3_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_4_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_5_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_6_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Parâmetro · slot_7_parameter

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Parâmetro**. **Uso e efeito:** Usa o primeiro componente daquele tipo no objeto **Valor:** Ganho do bus · **Tipo:** enumeração · **Domínio:** Ganho do bus \| Corte do filtro \| Ressonância do filtro \| Ganho do filtro \| Mistura do eco \| Mistura da reverberação \| Tamanho da sala \| Nível do envio \| Limiar do compressor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 1 · slot_0_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 1**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 2 · slot_1_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 2**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 3 · slot_2_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 3**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 4 · slot_3_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 4**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 5 · slot_4_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 5**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 6 · slot_5_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 6**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 7 · slot_6_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 7**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Objeto 8 · slot_7_target

**Onde:** Inspector → **Snapshot de mixer** → **Valores** → **Objeto 8**. **Uso e efeito:** Bus de áudio, ou o objeto do bus com o efeito **Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. ## Roadmap deste componente [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Snapshots de até oito valores e transição presentes na 0.2.3. Não representam preset universal de toda propriedade do mixer; destinos arbitrários não suportados. Sem expansão datada. 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 **Snapshot de mixer** 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.unity3d.com/6000.0/Documentation/Manual/AudioMixerSnapshots.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 | |---|---|---|---| | **Transicionar** · `transition_to` | Leva os valores atuais aos do snapshot no tempo dado; negativo usa a Transição do componente | Duração: número (s) | nada | | **Aplicar** · `apply` | Aplica os valores na hora, sem transição | Nenhum | nada | [Assinaturas da fachada AudioSnapshot](/pt-br/snapshot-2026-10-07/api/astra-components-audiosnapshot/#membros)