---
title: "Astra.Rendering.Volume"
version: snapshot-2026-10-28
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-28
appRelease: "0.4.0-preview.20261028"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-28/api/astra-rendering-volume/
---

# Astra.Rendering.Volume

Volume da Unity: forma global ou local, peso, prioridade e perfil.

**Namespace:** `Astra.Rendering` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::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
class Astra.Rendering.Volume
```

Volume da Unity: forma global ou local, peso, prioridade e perfil.

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): 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/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-7aedd70f34be1326) | Method |
| [FindAll](#member-ae8f632a273a0284) | Method |
| [Get](#member-01e8d7c2d32107ed) | Method |
| [HasInstantiatedProfile](#member-f5a88045db7b9e83) | Method |
| [BlendDistance](#member-94dcea102f74caa6) | Property |
| [Component](#member-00312050a99c10ed) | Property |
| [Enabled](#member-5e8933c52ee221a4) | Property |
| [Facade](#member-6d6bd313bf34c8d5) | Property |
| [GameObject](#member-965958ac5aefd3b7) | Property |
| [IsGlobal](#member-eb4ef451f87afd9b) | Property |
| [Priority](#member-dfd52e68b0daaa75) | Property |
| [Profile](#member-73726ad97f14517d) | Property |
| [SharedProfile](#member-3fedb2089904a574) | Property |
| [Weight](#member-89ae99079d8606e5) | Property |

<h3 id="member-7aedd70f34be1326" class="astra-member">.ctor</h3>

```csharp
public Volume(Astra.Components.EnvironmentVolume facade)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `facade` | `Astra.Components.EnvironmentVolume` |  |

<h3 id="member-ae8f632a273a0284" class="astra-member">FindAll</h3>

```csharp
public static Astra.Rendering.Volume[] FindAll()
```

Todos os Volumes ativos do mundo, em pré-ordem.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Todos os Volumes ativos do mundo, em pré-ordem.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01e8d7c2d32107ed" class="astra-member">Get</h3>

```csharp
public static Astra.Rendering.Volume? Get(Astra.GameObject owner)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |

<h3 id="member-f5a88045db7b9e83" class="astra-member">HasInstantiatedProfile</h3>

```csharp
public bool HasInstantiatedProfile()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-94dcea102f74caa6" class="astra-member">BlendDistance</h3>

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

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

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

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

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

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d6bd313bf34c8d5" class="astra-member">Facade</h3>

```csharp
public Astra.Components.EnvironmentVolume Facade { get; }
```

A fachada gerada, com todos os campos pelo nome da Astra.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** A fachada gerada, com todos os campos pelo nome da Astra.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-965958ac5aefd3b7" class="astra-member">GameObject</h3>

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

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eb4ef451f87afd9b" class="astra-member">IsGlobal</h3>

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

Mode = Global (true) ou Local; local vira Caixa, preservando Esfera.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Mode = Global (true) ou Local; local vira Caixa, preservando Esfera.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dfd52e68b0daaa75" class="astra-member">Priority</h3>

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

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-73726ad97f14517d" class="astra-member">Profile</h3>

```csharp
public Astra.Rendering.VolumeProfile Profile { get; }
```

Volume.profile: na primeira leitura copia o perfil compartilhado para este Volume; as mudanças seguintes valem só aqui e só no Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Volume.profile: na primeira leitura copia o perfil compartilhado para este Volume; as mudanças seguintes valem só aqui e só no Play.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3fedb2089904a574" class="astra-member">SharedProfile</h3>

```csharp
public Astra.AssetGuid SharedProfile { get; set; }
```

Volume.sharedProfile: o Volume Profile do projeto. Trocar o recurso troca os valores no mesmo quadro; ler valores pelo perfil compartilhado não o copia.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Volume.sharedProfile: o Volume Profile do projeto. Trocar o recurso troca os valores no mesmo quadro; ler valores pelo perfil compartilhado não o copia.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-89ae99079d8606e5" class="astra-member">Weight</h3>

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

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.