Envio de áudio

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

Copia uma fração do sinal do ponto atual da cadeia para outro Bus. Use para uma reverberação compartilhada sem substituir o caminho original.

Adicione no Bus de origem, escolha outro Bus em Destino e ajuste Nível do envio. Sua posição entre os componentes decide se copia antes ou depois de um efeito.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Áudio / Mixer → Envio de áudio.

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

Destino vazio não envia. Confira o encaminhamento do bus de retorno; uma referência válida não garante que ele alcance a saída. Evite ciclos de roteamento.

Guia relacionado: Mixer e retorno

Exemplo de uso

Crie um Bus de retorno com Reverberação, Sinal original 0 e Mistura .3. No Bus de origem, atribua esse retorno no Envio e use Nível .5. Compare .5 e 0 para ouvir a contribuição do retorno mantendo o caminho original.

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.

Envio

Propriedade	Tipo / unidade	Padrão	Domínio
Nível do envio level	número	0.5	0 … 1
Ativo enabled	booleano	verdadeiro	verdadeiro | falso
Destino target	referência	Nenhum	astra.audio.bus · outro objeto

Nível do envio · level

Onde: Inspector → Envio de áudio → Envio → Nível do envio.

Uso e efeito: Fração linear copiada ao Bus de destino neste ponto da cadeia. Zero não envia; não é volume master.

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

Aceita tween numérico via contrato de propriedade.

Ativo · enabled

Onde: Inspector → Envio de áudio → Envio → Ativo.

Uso e efeito: Desligado não envia nada

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

Destino · target

Onde: Inspector → Envio de áudio → Envio → Destino.

Uso e efeito: Bus que recebe a cópia, por exemplo um bus só com Reverb

Valor: Nenhum · Tipo: referência · Domínio: astra.audio.bus · outro objeto.

Roadmap deste componente

Áudio. Envio ordenado no mixer presente na 0.2.3. Não declara toda topologia de feedback nem roteamento arbitrário entre engines. Sem data de expansão.

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 Envio de áudio 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.