---
title: "Astra.QueryFilter"
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-queryfilter/
---

# Astra.QueryFilter

Como a consulta escolhe o que pode acertar.

**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
struct Astra.QueryFilter
```

Como a consulta escolhe o que pode acertar.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): 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 |
|---|---|
| [Ignore](#member-671bb7caa3a110d0) | Field |
| [IncludeDynamic](#member-47b4477f6b916873) | Field |
| [IncludeSensors](#member-dd3cbab914c0ac44) | Field |
| [IncludeStatic](#member-9b5f8ff815572efa) | Field |
| [LayerMask](#member-136a865f9e697396) | Field |
| [Ignoring](#member-7cc51421846e2cb9) | Method |
| [OnlyLayers](#member-5e45068bb64ac5ff) | Method |
| [Default](#member-410c0cc9b5e4d233) | Property |

<h3 id="member-671bb7caa3a110d0" class="astra-member">Ignore</h3>

```csharp
public ulong Ignore
```

Objeto que não deve ser acertado — normalmente quem consulta.

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

**Uso:** Objeto que não deve ser acertado — normalmente quem consulta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47b4477f6b916873" class="astra-member">IncludeDynamic</h3>

```csharp
public bool IncludeDynamic
```

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

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd3cbab914c0ac44" class="astra-member">IncludeSensors</h3>

```csharp
public bool IncludeSensors
```

Falso por padrão: um raio de visada que parasse na zona de detecção invisível do próprio jogo seria um erro difícil de enxergar.

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

**Uso:** Falso por padrão: um raio de visada que parasse na zona de detecção invisível do próprio jogo seria um erro difícil de enxergar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b5f8ff815572efa" class="astra-member">IncludeStatic</h3>

```csharp
public bool IncludeStatic
```

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

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-136a865f9e697396" class="astra-member">LayerMask</h3>

```csharp
public uint LayerMask
```

Bit por camada de gameplay (0..31).

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

**Uso:** Bit por camada de gameplay (0..31).

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7cc51421846e2cb9" class="astra-member">Ignoring</h3>

```csharp
public Astra.QueryFilter Ignoring(Astra.GameObject self)
```

**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:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `self` | `Astra.GameObject` |  |

<h3 id="member-5e45068bb64ac5ff" class="astra-member">OnlyLayers</h3>

```csharp
public Astra.QueryFilter OnlyLayers(params int[] layers)
```

**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:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `layers` | `int[]` |  |

<h3 id="member-410c0cc9b5e4d233" class="astra-member">Default</h3>

```csharp
public static Astra.QueryFilter Default { get; }
```

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

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.