Astra.Components.AudioSnapshot

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Snapshot de mixer: Leva ganhos e efeitos a valores salvos com transição. Família Áudio · Mixer.

Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct

Declaração

readonly struct Astra.Components.AudioSnapshot

Snapshot de mixer: Leva ganhos e efeitos a valores salvos com transição. Família Áudio · Mixer.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/AudioMixerSnapshots.html

Interfaces: Astra.Components.IComponentFacade<Astra.Components.AudioSnapshot>.

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Áudio / Mixer → Snapshot de mixer.

No Behavior em Play, obtenha a fachada com Object.GetComponent<AudioSnapshot>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new AudioSnapshot(component) envolve um componente existente; não adiciona um componente à cena.

Roadmap e uso

Áudio: o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use mapa de acesso.

Consulte também Snapshot de mixer para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
Apply	Method
Remove	Method
TransitionTo	Method
Wrap	Method
ApplyAtStart	Property
Component	Property
Enabled	Property
InstanceId	Property
IsAlive	Property
Object	Property
Slot0Parameter	Property
Slot0Target	Property
Slot0Value	Property
Slot1Parameter	Property
Slot1Target	Property
Slot1Value	Property
Slot2Parameter	Property
Slot2Target	Property
Slot2Value	Property
Slot3Parameter	Property
Slot3Target	Property
Slot3Value	Property
Slot4Parameter	Property
Slot4Target	Property
Slot4Value	Property
Slot5Parameter	Property
Slot5Target	Property
Slot5Value	Property
Slot6Parameter	Property
Slot6Target	Property
Slot6Value	Property
Slot7Parameter	Property
Slot7Target	Property
Slot7Value	Property
Transition	Property
TypeId	Property

.ctor

public AudioSnapshot(Astra.Component component)

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`component`	`Astra.Component`

Apply

public void Apply()

Aplicar. Aplica os valores na hora, sem transição

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Aplicar. Aplica os valores na hora, sem transição

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Remove

public void Remove()

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TransitionTo

public void TransitionTo(double seconds)

Transicionar. Leva os valores atuais aos do snapshot no tempo dado; negativo usa a Transição do componente

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Transicionar. Leva os valores atuais aos do snapshot no tempo dado; negativo usa a Transição do componente

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`seconds`	`double`

Wrap

public static Astra.Components.AudioSnapshot Wrap(Astra.Component component)

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Envolve um Component existente após conferir TypeId; não cria componente.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`component`	`Astra.Component`

ApplyAtStart

public bool ApplyAtStart { get; set; }

Aplicar ao iniciar. Os valores entram no primeiro quadro do Play, sem transição

Caminho: Inspector → Snapshot de mixer → Snapshot; ou fachada C# em um Behavior.

Uso: Aplicar ao iniciar: Os valores entram no primeiro quadro do Play, sem transição

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

public Astra.Component Component { get; }

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Handle genérico da instância, usado para operações de reflexão e recursos.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

public bool Enabled { get; set; }

Ativo. Desligado recusa transições

Caminho: Inspector → Snapshot de mixer → Snapshot; ou fachada C# em um Behavior.

Uso: Ativo: Desligado recusa transições

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

public ulong InstanceId { get; }

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

public Astra.GameObject Object { get; }

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Objeto dono deste componente; use para resolver composição.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot0Parameter

public Astra.Components.AudioSnapshot.Slot0ParameterOption Slot0Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot0Target

public Astra.ObjectReference Slot0Target { get; set; }

Objeto 1. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 1: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot0Value

public float Slot0Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

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

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot1Parameter

public Astra.Components.AudioSnapshot.Slot1ParameterOption Slot1Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot1Target

public Astra.ObjectReference Slot1Target { get; set; }

Objeto 2. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 2: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot1Value

public float Slot1Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot2Parameter

public Astra.Components.AudioSnapshot.Slot2ParameterOption Slot2Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot2Target

public Astra.ObjectReference Slot2Target { get; set; }

Objeto 3. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 3: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot2Value

public float Slot2Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot3Parameter

public Astra.Components.AudioSnapshot.Slot3ParameterOption Slot3Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot3Target

public Astra.ObjectReference Slot3Target { get; set; }

Objeto 4. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 4: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot3Value

public float Slot3Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot4Parameter

public Astra.Components.AudioSnapshot.Slot4ParameterOption Slot4Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot4Target

public Astra.ObjectReference Slot4Target { get; set; }

Objeto 5. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 5: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot4Value

public float Slot4Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot5Parameter

public Astra.Components.AudioSnapshot.Slot5ParameterOption Slot5Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot5Target

public Astra.ObjectReference Slot5Target { get; set; }

Objeto 6. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 6: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot5Value

public float Slot5Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot6Parameter

public Astra.Components.AudioSnapshot.Slot6ParameterOption Slot6Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot6Target

public Astra.ObjectReference Slot6Target { get; set; }

Objeto 7. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 7: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot6Value

public float Slot6Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot7Parameter

public Astra.Components.AudioSnapshot.Slot7ParameterOption Slot7Parameter { get; set; }

Parâmetro. Usa o primeiro componente daquele tipo no objeto

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Parâmetro: Usa o primeiro componente daquele tipo no objeto

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot7Target

public Astra.ObjectReference Slot7Target { get; set; }

Objeto 8. Bus de áudio, ou o objeto do bus com o efeito

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Uso: Objeto 8: Bus de áudio, ou o objeto do bus com o efeito

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Slot7Value

public float Slot7Value { get; set; }

Valor. Limitado à faixa da propriedade de destino

Faixa válida: -100000 a 100000.

Caminho: Inspector → Snapshot de mixer → Valores; ou fachada C# em um Behavior.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Transition

public float Transition { get; set; }

Transição (s). Tempo real até os valores do snapshot

Faixa válida: 0 a 60.

Caminho: Inspector → Snapshot de mixer → Snapshot; ou fachada C# em um Behavior.

Uso: Transição: Tempo real até os valores do snapshot

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

public static string TypeId { get; }

Caminho: Inspector → Snapshot de mixer; ou fachada C# em um Behavior.

Uso: Identificador nativo usado em AddComponent/GetComponent.

Roadmap deste membro: Áudio. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.