---
title: "Astra.Components.AudioSource"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiosource/
---

# Astra.Components.AudioSource

Audio Source: Clipe de projeto com reprodução e espaço acústico. Família Áudio · Reprodução.

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

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.AudioSource
```

Audio Source: Clipe de projeto com reprodução e espaço acústico. Família Áudio · Reprodução.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-AudioSource.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.AudioSource>`.

## Onde acessar este tipo

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

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

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): 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](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Audio Source](/pt-br/snapshot-2026-10-06/componentes/astra-audio-source/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-64a7cce5115a4063) | Method |
| [GetClip](#member-4cc200665aa0662b) | Method |
| [Pause](#member-acdc7c1ffbb8a79d) | Method |
| [Play](#member-d5033b287ae87cea) | Method |
| [Remove](#member-dfa11ef77970bbab) | Method |
| [Resume](#member-3f8f1332205a9e7c) | Method |
| [Seek](#member-1a89f061f5f2259f) | Method |
| [SetClip](#member-9479efa6769c8342) | Method |
| [Stop](#member-c75ec25b3b002f1d) | Method |
| [Wrap](#member-4642b1dda31b40c8) | Method |
| [Bus](#member-f62ff8c2f1f6f33c) | Property |
| [Component](#member-c7cfa368440a7849) | Property |
| [ConeGain](#member-192a42485edea585) | Property |
| [ConeInner](#member-08e4d53131546af5) | Property |
| [ConeOuter](#member-f9b07e0f6ead1d10) | Property |
| [Dimension](#member-e3a834e7f469d4d6) | Property |
| [Doppler](#member-0bb0d6a843dc2d64) | Property |
| [Enabled](#member-da72fe7b179df126) | Property |
| [InstanceId](#member-4c8850733a37007a) | Property |
| [IsAlive](#member-857f2eccad39bb1d) | Property |
| [Loop](#member-f70847c16296d7f0) | Property |
| [MaxDistance](#member-16651eb308e9b70e) | Property |
| [MinDistance](#member-3e83663bc12fd956) | Property |
| [Mute](#member-feeed6940b37bbe6) | Property |
| [Object](#member-a34257e27ea43300) | Property |
| [Pan](#member-701c2073845dbd69) | Property |
| [Pitch](#member-6a922d79961f02dc) | Property |
| [Playback](#member-32f5f6b72587bbd6) | Property |
| [Rolloff](#member-4b9a5348a30db581) | Property |
| [RolloffFactor](#member-4d4587cecb3b2632) | Property |
| [TypeId](#member-1ea08d176dfd3f96) | Property |
| [Volume](#member-5d62b270c01990bb) | Property |

<h3 id="member-64a7cce5115a4063" class="astra-member">.ctor</h3>

```csharp
public AudioSource(Astra.Component component)
```

**Caminho:** Inspector → Audio Source; 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](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

<h3 id="member-4cc200665aa0662b" class="astra-member">GetClip</h3>

```csharp
public Astra.AssetGuid GetClip(uint slot = 0)
```

Clipe WAV. Recurso do projeto por slot

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Clipe WAV. Recurso do projeto por slot

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-acdc7c1ffbb8a79d" class="astra-member">Pause</h3>

```csharp
public void Pause()
```

Pausar. Congela o cursor

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

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Pausar. Congela o cursor

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d5033b287ae87cea" class="astra-member">Play</h3>

```csharp
public void Play()
```

Tocar. Recomeça do início

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

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Tocar. Recomeça do início

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dfa11ef77970bbab" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

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

**Caminho:** Inspector → Audio Source; 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](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f8f1332205a9e7c" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

Retomar. Continua do cursor pausado

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

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Retomar. Continua do cursor pausado

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1a89f061f5f2259f" class="astra-member">Seek</h3>

```csharp
public void Seek(double seconds)
```

Posicionar. Move o cursor; aplicado pelo mixer

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

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Posicionar. Move o cursor; aplicado pelo mixer

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |

<h3 id="member-9479efa6769c8342" class="astra-member">SetClip</h3>

```csharp
public void SetClip(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-c75ec25b3b002f1d" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Parar. Interrompe e libera a voz

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

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Parar. Interrompe e libera a voz

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4642b1dda31b40c8" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.AudioSource Wrap(Astra.Component component)
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

<h3 id="member-f62ff8c2f1f6f33c" class="astra-member">Bus</h3>

```csharp
public Astra.ObjectReference Bus { get; set; }
```

Bus

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

**Uso:** **Bus:** Destino de mixer da fonte.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c7cfa368440a7849" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Audio Source; 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](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-192a42485edea585" class="astra-member">ConeGain</h3>

```csharp
public float ConeGain { get; set; }
```

Ganho fora do cone

Faixa válida: 0 a 1.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-08e4d53131546af5" class="astra-member">ConeInner</h3>

```csharp
public float ConeInner { get; set; }
```

Cone interno (°)

Faixa válida: 0 a 360.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f9b07e0f6ead1d10" class="astra-member">ConeOuter</h3>

```csharp
public float ConeOuter { get; set; }
```

Cone externo (°)

Faixa válida: 0 a 360.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e3a834e7f469d4d6" class="astra-member">Dimension</h3>

```csharp
public Astra.Components.AudioSource.DimensionOption Dimension { get; set; }
```

Dimensão

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0bb0d6a843dc2d64" class="astra-member">Doppler</h3>

```csharp
public float Doppler { get; set; }
```

Doppler (×)

Faixa válida: 0 a 4.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-da72fe7b179df126" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4c8850733a37007a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-857f2eccad39bb1d" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Audio Source; 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](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f70847c16296d7f0" class="astra-member">Loop</h3>

```csharp
public bool Loop { get; set; }
```

Repetir

**Caminho:** Inspector → Audio Source → Reprodução; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16651eb308e9b70e" class="astra-member">MaxDistance</h3>

```csharp
public float MaxDistance { get; set; }
```

Distância máxima (m)

Faixa válida: 0.02 a 100001.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e83663bc12fd956" class="astra-member">MinDistance</h3>

```csharp
public float MinDistance { get; set; }
```

Distância mínima (m)

Faixa válida: 0.01 a 100000.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-feeed6940b37bbe6" class="astra-member">Mute</h3>

```csharp
public bool Mute { get; set; }
```

Silenciar

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

**Uso:** **Silenciar:** Silencia sem remover o componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a34257e27ea43300" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-701c2073845dbd69" class="astra-member">Pan</h3>

```csharp
public float Pan { get; set; }
```

Pan estéreo

Faixa válida: -1 a 1.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a922d79961f02dc" class="astra-member">Pitch</h3>

```csharp
public float Pitch { get; set; }
```

Velocidade / pitch (×)

Faixa válida: 0.1 a 4.

**Caminho:** Inspector → Audio Source → Reprodução; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-32f5f6b72587bbd6" class="astra-member">Playback</h3>

```csharp
public Astra.Components.AudioSource.PlaybackOption Playback { get; set; }
```

Pedido. Pedido persistido; consulte o estado real na nota do componente.

**Caminho:** Inspector → Audio Source → Reprodução; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4b9a5348a30db581" class="astra-member">Rolloff</h3>

```csharp
public Astra.Components.AudioSource.RolloffOption Rolloff { get; set; }
```

Atenuação

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d4587cecb3b2632" class="astra-member">RolloffFactor</h3>

```csharp
public float RolloffFactor { get; set; }
```

Decaimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1ea08d176dfd3f96" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5d62b270c01990bb" class="astra-member">Volume</h3>

```csharp
public float Volume { get; set; }
```

Volume

Faixa válida: 0 a 1.

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

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

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.