---
title: "Astra.SceneQuery"
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-scenequery/
---

# 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

:::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.SceneQuery
```

Busca de componentes no mundo de Play inteiro, como Object.FindFirstObjectByType&lt;T>() e FindObjectsByType&lt;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

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 |
|---|---|
| [FindComponents](#member-aab1ad7379a50744) | Method |
| [FindFirstObjectByType](#member-f4f81415c8ab2581) | Method |
| [FindObjectsByType](#member-d90a03214e751869) | Method |
| [Root](#member-388c04d89752c666) | Property |

<h3 id="member-aab1ad7379a50744" class="astra-member">FindComponents</h3>

```csharp
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](/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 |
|---|---|---|
| `typeId` | `string` |  |

<h3 id="member-f4f81415c8ab2581" class="astra-member">FindFirstObjectByType</h3>

```csharp
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](/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-d90a03214e751869" class="astra-member">FindObjectsByType</h3>

```csharp
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](/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-388c04d89752c666" class="astra-member">Root</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.