---
title: "Interagir com raycast"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/interagir-com-raycast/
---

# Interagir com raycast

Consulte a geometria física na direção do objeto.

## Composição da cena

Objeto emissor, alvo com collider e camadas incluídas no filtro.

## Implementação

```csharp
var hit = Physics.RayCast(Object.WorldPosition,
    Object.Forward * 5.0f, QueryFilter.Default.Ignoring(Object));
if (hit is { } contact)
{
    contact.Object.Name = "Alvo encontrado";
}
```

## Resultado esperado

Um alvo físico encontrado pelo raio recebe o nome indicado.

## Cuidados

Trecho para uma ação de interação em Behavior. O vetor carrega a extensão da consulta; não substitua por uma direção unitária quando deseja outro alcance. O exemplo altera nome, não implementa inventário ou regras de interação.

Consulte [PhysicsAccess](/pt-br/snapshot-2026-10-06/api/astra-physicsaccess/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.