Snapshot de mixer

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

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.

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

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.

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 transition	número · s	1	0 … 60
Ativo enabled	booleano	verdadeiro	verdadeiro | falso
Aplicar ao iniciar 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 slot_0_value	número	1	-100000 … 100000
Valor slot_1_value	número	1	-100000 … 100000
Valor slot_2_value	número	1	-100000 … 100000
Valor slot_3_value	número	1	-100000 … 100000
Valor slot_4_value	número	1	-100000 … 100000
Valor slot_5_value	número	1	-100000 … 100000
Valor slot_6_value	número	1	-100000 … 100000
Valor slot_7_value	número	1	-100000 … 100000
Parâmetro 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 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 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 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 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 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 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 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 slot_0_target	referência	Nenhum	qualquer objeto
Objeto 2 slot_1_target	referência	Nenhum	qualquer objeto
Objeto 3 slot_2_target	referência	Nenhum	qualquer objeto
Objeto 4 slot_3_target	referência	Nenhum	qualquer objeto
Objeto 5 slot_4_target	referência	Nenhum	qualquer objeto
Objeto 6 slot_5_target	referência	Nenhum	qualquer objeto
Objeto 7 slot_6_target	referência	Nenhum	qualquer objeto
Objeto 8 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. 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. 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