Astra.SceneQuery
Busca de componentes no mundo de Play inteiro, como Object.FindFirstObjectByType<T>() e FindObjectsByType<T>() da Unity. Percorre a hierarquia em pré-ordem a partir da raiz, só objetos ativos; é O(N) e serve para inicialização ou para os acessos estáticos (Astra.Rendering.RenderSettings, TimeOfDay.Current), não para todo quadro.
Namespace: Astra · Assembly: Astra.Scripting · Tipo: Class
Declaração
Seção intitulada “Declaração”class Astra.SceneQueryBusca de componentes no mundo de Play inteiro, como Object.FindFirstObjectByType<T>() e FindObjectsByType<T>() da Unity. Percorre a hierarquia em pré-ordem a partir da raiz, só objetos ativos; é O(N) e serve para inicialização ou para os acessos estáticos (Astra.Rendering.RenderSettings, TimeOfDay.Current), não para todo quadro.
Onde acessar este tipo
Seção intitulada “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
Seção intitulada “Roadmap e uso”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.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| FindComponents | Method |
| FindFirstObjectByType | Method |
| FindObjectsByType | Method |
| Root | Property |
FindComponents
public static System.Collections.Generic.IEnumerable<Astra.Component> FindComponents(string typeId)Todas as instâncias ativas do tipo de componente, em pré-ordem.
Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Todas as instâncias ativas do tipo de componente, em pré-ordem.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
typeId |
string |
FindFirstObjectByType
public static T? FindFirstObjectByType<T>() where T : struct, Astra.Components.IComponentFacade<T>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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
FindObjectsByType
public static T[] FindObjectsByType<T>() where T : struct, Astra.Components.IComponentFacade<T>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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Root
public static Astra.GameObject Root { get; }A raiz do mundo de Play (sem componentes próprios).
Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: A raiz do mundo de Play (sem componentes próprios).
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.