---
title: "Audio Source"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-audio-source/
---

# Audio Source

Clipe de projeto com reprodução e espaço acústico

**Família:** Áudio · **Grupo:** Reprodução · **Identificador:** `astra.audio.source` · **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

Clipe de projeto com reprodução e espaço acústico

Atribua um clipe do projeto ao Audio Source e confira reprodução, volume, mute e bus. Escolha escuta e espacialização; prioridade decide o listener efetivo.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Reprodução** → **Audio Source**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.AudioSource](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource/).



## Exemplo de uso

Um Audio Source e um Audio Listener: toque um clipe, altere volume/mute e depois compare estéreo com 3D movendo a fonte.



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

### Som

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Volume**](#field-volume)<br/>`volume` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Silenciar**](#field-mute)<br/>`mute` | booleano | falso | verdadeiro \| falso |
| [**Bus**](#field-bus)<br/>`bus` | referência | Master | astra.audio.bus |

<h4 id="field-volume">Volume · <code>volume</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Volume**.

**Uso e efeito:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

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



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

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



<h4 id="field-mute">Silenciar · <code>mute</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Silenciar**.

**Uso e efeito:** Silencia sem remover o componente.

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



<h4 id="field-bus">Bus · <code>bus</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Bus**.

**Uso e efeito:** Destino de mixer da fonte.

**Valor:** Master · **Tipo:** referência · **Domínio:** astra.audio.bus.



### Reprodução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade / pitch**](#field-pitch)<br/>`pitch` | número · × | 1 | 0.1 … 4 |
| [**Repetir**](#field-loop)<br/>`loop` | booleano | falso | verdadeiro \| falso |
| [**Pedido**](#field-playback)<br/>`playback` | enumeração | Tocar | Parar \| Tocar \| Pausar |

<h4 id="field-pitch">Velocidade / pitch · <code>pitch</code></h4>

**Onde:** Inspector → **Audio Source** → **Reprodução** → **Velocidade / pitch**.

**Uso e efeito:** Velocidade/pitch da reprodução; não altera o arquivo original.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0.1 … 4.



<h4 id="field-loop">Repetir · <code>loop</code></h4>

**Onde:** Inspector → **Audio Source** → **Reprodução** → **Repetir**.

**Uso e efeito:** Repete a reprodução/percurso no fim.

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



<h4 id="field-playback">Pedido · <code>playback</code></h4>

**Onde:** Inspector → **Audio Source** → **Reprodução** → **Pedido**.

**Uso e efeito:** Pedido persistido; consulte o estado real na nota do componente.

**Valor:** Tocar · **Tipo:** enumeração · **Domínio:** Parar \| Tocar \| Pausar.



### Espaço

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Pan estéreo**](#field-pan)<br/>`pan` | número | 0 | -1 … 1 |
| [**Distância mínima**](#field-min-distance)<br/>`min_distance` | número · m | 1 | 0.01 … 100000 |
| [**Distância máxima**](#field-max-distance)<br/>`max_distance` | número · m | 100 | 0.02 … 100001 |
| [**Decaimento**](#field-rolloff-factor)<br/>`rolloff_factor` | número | 1 | 0 … 10 |
| [**Dimensão**](#field-dimension)<br/>`dimension` | enumeração | 2D / estéreo | 2D / estéreo \| 3D / espacial |
| [**Atenuação**](#field-rolloff)<br/>`rolloff` | enumeração | Inverso | Linear \| Inverso \| Exponencial |

<h4 id="field-pan">Pan estéreo · <code>pan</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Pan estéreo**.

**Uso e efeito:** Pan estéreo, de esquerda a direita; é condicional à espacialização.

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

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-min-distance">Distância mínima · <code>min_distance</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Distância mínima**.

**Uso e efeito:** Distância próxima de referência da atenuação 3D.

**Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-distance">Distância máxima · <code>max_distance</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Distância máxima**.

**Uso e efeito:** Distância máxima de referência da atenuação 3D.

**Valor:** 100 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.02 … 100001.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rolloff-factor">Decaimento · <code>rolloff_factor</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Decaimento**.

**Uso e efeito:** Fator de queda de ganho do modelo de atenuação.

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

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-dimension">Dimensão · <code>dimension</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Dimensão**.

**Uso e efeito:** Seleciona áudio estéreo ou espacial conforme o domínio.

**Valor:** 2D / estéreo · **Tipo:** enumeração · **Domínio:** 2D / estéreo \| 3D / espacial.



<h4 id="field-rolloff">Atenuação · <code>rolloff</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Atenuação**.

**Uso e efeito:** Modelo de atenuação por distância.

**Valor:** Inverso · **Tipo:** enumeração · **Domínio:** Linear \| Inverso \| Exponencial.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Emissão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Cone interno**](#field-cone-inner)<br/>`cone_inner` | número · ° | 360 | 0 … 360 |
| [**Cone externo**](#field-cone-outer)<br/>`cone_outer` | número · ° | 360 | 0 … 360 |
| [**Ganho fora do cone**](#field-cone-gain)<br/>`cone_gain` | número | 0 | 0 … 1 |
| [**Doppler**](#field-doppler)<br/>`doppler` | número · × | 1 | 0 … 4 |

<h4 id="field-cone-inner">Cone interno · <code>cone_inner</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Cone interno**.

**Uso e efeito:** Ângulo interno do cone acústico.

**Valor:** 360 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 360.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-cone-outer">Cone externo · <code>cone_outer</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Cone externo**.

**Uso e efeito:** Ângulo externo do cone acústico.

**Valor:** 360 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 360.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-cone-gain">Ganho fora do cone · <code>cone_gain</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Ganho fora do cone**.

**Uso e efeito:** Ganho fora da região interna do cone.

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

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-doppler">Doppler · <code>doppler</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Doppler**.

**Uso e efeito:** Fator do efeito Doppler.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 4.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Ampliar transporte, formatos, mixer e diagnóstico de backend. Seek não deve ser presumido como disponível porque há cursor de reprodução. Conferir saída física no aparelho é uma evidência separada.

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 **Audio Source** 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/class-AudioSource.html). Essa referência não representa paridade funcional.