---
title: "Astra.ScenesAccess"
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-scenesaccess/
---

# Astra.ScenesAccess

Cenas do projeto em Play (Unity 6000.0 SceneManager). Nome é o caminho relativo sem extensão ou só o nome do arquivo, quando único.

**Namespace:** `Astra` · **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.ScenesAccess
```

Cenas do projeto em Play (Unity 6000.0 SceneManager). Nome é o caminho relativo sem extensão ou só o nome do arquivo, quando único.

## Membros

| Membro | Categoria |
|---|---|
| [Load](#member-88d29d8fa451f976) | Method |
| [LoadAdditive](#member-081fb2eb70216468) | Method |
| [Active](#member-109ec8213b8c357d) | Property |
| [Names](#member-ade272bc3f09a5cf) | Property |

<h3 id="member-88d29d8fa451f976" class="astra-member">Load</h3>

```csharp
public void Load(string name)
```

Troca o mundo inteiro pela cena, no fim do quadro corrente. Os comportamentos atuais recebem Stop/Destroy; os da cena nova, Awake/Start. O documento editado não muda e volta ao parar o Play.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-081fb2eb70216468" class="astra-member">LoadAdditive</h3>

```csharp
public Astra.GameObject LoadAdditive(string name, Astra.GameObject? parent = null)
```

Acrescenta a cena ao mundo atual sob um objeto contêiner com o nome dela, filho de parent (raiz quando nulo). Os comportamentos da cena recebem Awake/Start como em uma instanciação.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |
| `parent` | `Astra.GameObject?` |  · Opcional: `` |

<h3 id="member-109ec8213b8c357d" class="astra-member">Active</h3>

```csharp
public string Active { get; }
```

A cena que iniciou ou substituiu o mundo atual.

<h3 id="member-ade272bc3f09a5cf" class="astra-member">Names</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<string> Names { get; }
```

Cenas do projeto, em ordem estável.