---
title: "Astra.ScenesAccess"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/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.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

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

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

**Uso:** 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.

**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 |
|---|---|---|
| `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.

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

**Uso:** 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.

**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 |
|---|---|---|
| `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.

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

**Uso:** A cena que iniciou ou substituiu o mundo atual.

**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-ade272bc3f09a5cf" class="astra-member">Names</h3>

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

Cenas do projeto, em ordem estável.

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

**Uso:** Cenas do projeto, em ordem estável.

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