Pular para o conteúdo
AstraDOCS

Astra.ScenesAccess

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

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

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.

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.

Objetos, Behaviors e composição: 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.

Membro Categoria
Load Method
LoadAdditive Method
Active Property
Names Property

Load

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
name string

LoadAdditive

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

Active

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Names

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.