---
title: "Astra.Components.InteractionSystem"
version: snapshot-2026-10-16b
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-16b
appRelease: "0.3.2-preview.20261016"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-16b/api/astra-components-interactionsystem/
---

# Astra.Components.InteractionSystem

Sistema de interação: Leva a mão até objetos interagíveis. Família Lógica · IK.

**Namespace:** `Astra.Components` · **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
readonly struct Astra.Components.InteractionSystem
```

Sistema de interação: Leva a mão até objetos interagíveis. Família Lógica · IK.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.animation.rigging@1.2/manual/constraints/TwoBoneIKConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.InteractionSystem>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **IK** → **Sistema de interação**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<InteractionSystem>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new InteractionSystem(component)` envolve um componente existente; não adiciona um componente à cena.

## 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/).

Consulte também [Sistema de interação](/pt-br/snapshot-2026-10-16b/componentes/astra-ik-interaction-system/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-9b60fee755ced5dd) | Method |
| [OnEntered](#member-b7f60116e82cc6f4) | Method |
| [OnLeft](#member-6f83449ef91479de) | Method |
| [OnPicked](#member-c0d8585773ff4771) | Method |
| [OnReached](#member-05a934c00927abd6) | Method |
| [OnReleased](#member-7ddd8ac5a43ab25c) | Method |
| [Remove](#member-e40abeed77b2f8ee) | Method |
| [Start](#member-d86b85c6d209f47f) | Method |
| [Stop](#member-0def7640324e66f9) | Method |
| [Trigger](#member-7451162e8152dd18) | Method |
| [Wrap](#member-81ef07a18806873b) | Method |
| [AutoEffector](#member-72b3965263b23621) | Property |
| [AutoObject](#member-e0630d1858d4ad21) | Property |
| [AutoSecond](#member-f9d56389a54d7f26) | Property |
| [Chest](#member-bacdb39302b6c073) | Property |
| [Component](#member-44c7603903817eb4) | Property |
| [Crouch](#member-534112e428de4dfe) | Property |
| [Enabled](#member-0086e5d0d2a16204) | Property |
| [InstanceId](#member-2768022d4d3e8c50) | Property |
| [IsAlive](#member-c9641b35b3759dd1) | Property |
| [Lean](#member-4e90b3b5400c6790) | Property |
| [LimbBones](#member-2308e3fbf2956f76) | Property |
| [LookAt](#member-9a2140cef22c0987) | Property |
| [LookSpeed](#member-26b4963daf1895d0) | Property |
| [LookTurn](#member-4029ed08d0bca1b7) | Property |
| [Object](#member-ed7f2d76d0442758) | Property |
| [Pelvis](#member-8c3880e067726e36) | Property |
| [Speed](#member-cbb62ee7863f3950) | Property |
| [TypeId](#member-c4cc34e25f7df2bd) | Property |

<h3 id="member-9b60fee755ced5dd" class="astra-member">.ctor</h3>

```csharp
public InteractionSystem(Astra.Component component)
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**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 |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b7f60116e82cc6f4" class="astra-member">OnEntered</h3>

```csharp
public Astra.ComponentSubscription OnEntered(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Entrou no gatilho. O personagem entrou na faixa de um Gatilho de interação (Objeto = o gatilho). Payload: Mão: objeto, Objeto: objeto

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Entrou no gatilho. O personagem entrou na faixa de um Gatilho de interação (Objeto = o gatilho). Payload: Mão: objeto, Objeto: objeto

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-6f83449ef91479de" class="astra-member">OnLeft</h3>

```csharp
public Astra.ComponentSubscription OnLeft(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Saiu do gatilho. O personagem saiu da faixa do gatilho. Payload: Mão: objeto, Objeto: objeto

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Saiu do gatilho. O personagem saiu da faixa do gatilho. Payload: Mão: objeto, Objeto: objeto

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-c0d8585773ff4771" class="astra-member">OnPicked</h3>

```csharp
public Astra.ComponentSubscription OnPicked(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Levantou. A última mão chegou e o objeto sobe ao ponto de carregar. Payload: Mão: objeto, Objeto: objeto

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Levantou. A última mão chegou e o objeto sobe ao ponto de carregar. Payload: Mão: objeto, Objeto: objeto

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-05a934c00927abd6" class="astra-member">OnReached</h3>

```csharp
public Astra.ComponentSubscription OnReached(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Alcançou. A mão chegou ao ponto de pegada. Payload: Mão: objeto, Objeto: objeto

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Alcançou. A mão chegou ao ponto de pegada. Payload: Mão: objeto, Objeto: objeto

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-7ddd8ac5a43ab25c" class="astra-member">OnReleased</h3>

```csharp
public Astra.ComponentSubscription OnReleased(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Soltou. A mão voltou à animação. Payload: Mão: objeto, Objeto: objeto

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Soltou. A mão voltou à animação. Payload: Mão: objeto, Objeto: objeto

**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 |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-e40abeed77b2f8ee" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**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-d86b85c6d209f47f" class="astra-member">Start</h3>

```csharp
public bool Start(Astra.ObjectReference effector, Astra.ObjectReference @object)
```

Interagir. Leva a mão até o Objeto interagível; falso se a mão ou o objeto não servem

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Interagir. Leva a mão até o Objeto interagível; falso se a mão ou o objeto não servem

**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 |
|---|---|---|
| `effector` | `Astra.ObjectReference` |  |
| `object` | `Astra.ObjectReference` |  |

<h3 id="member-0def7640324e66f9" class="astra-member">Stop</h3>

```csharp
public void Stop(Astra.ObjectReference effector)
```

Soltar. Devolve a mão à animação e larga o objeto pego

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Soltar. Devolve a mão à animação e larga o objeto pego

**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 |
|---|---|---|
| `effector` | `Astra.ObjectReference` |  |

<h3 id="member-7451162e8152dd18" class="astra-member">Trigger</h3>

```csharp
public bool Trigger()
```

Interagir pelo gatilho. Começa a interação do Gatilho de interação mais próximo em que o personagem está; falso se não há nenhum

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Interagir pelo gatilho. Começa a interação do Gatilho de interação mais próximo em que o personagem está; falso se não há nenhum

**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-81ef07a18806873b" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.InteractionSystem Wrap(Astra.Component component)
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**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 |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-72b3965263b23621" class="astra-member">AutoEffector</h3>

```csharp
public Astra.ObjectReference AutoEffector { get; set; }
```

Mão ao iniciar

**Caminho:** Inspector → Sistema de interação → Início sem script; ou fachada C# em um Behavior.

**Uso:** **Mão ao iniciar:** Mão usada pelos gatilhos automáticos.

**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-e0630d1858d4ad21" class="astra-member">AutoObject</h3>

```csharp
public Astra.ObjectReference AutoObject { get; set; }
```

Objeto ao iniciar

**Caminho:** Inspector → Sistema de interação → Início sem script; ou fachada C# em um Behavior.

**Uso:** **Objeto ao iniciar:** Objeto padrão para iniciar por script.

**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-f9d56389a54d7f26" class="astra-member">AutoSecond</h3>

```csharp
public Astra.ObjectReference AutoSecond { get; set; }
```

Segunda mão ao iniciar

**Caminho:** Inspector → Sistema de interação → Início sem script; ou fachada C# em um Behavior.

**Uso:** **Segunda mão ao iniciar:** Segunda mão.

**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-bacdb39302b6c073" class="astra-member">Chest</h3>

```csharp
public Astra.ObjectReference Chest { get; set; }
```

Peito

**Caminho:** Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Peito:** Osso do peito (inclinar).

**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-44c7603903817eb4" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**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-534112e428de4dfe" class="astra-member">Crouch</h3>

```csharp
public float Crouch { get; set; }
```

Agachar até (m)

Faixa válida: 0 a 2.

**Caminho:** Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Agachar até:** Quanto o corpo agacha para alcançar baixo.

**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-0086e5d0d2a16204" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Sistema de interação → Interação; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Desligado, o componente fica na cena sem agir.

**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-2768022d4d3e8c50" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**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-c9641b35b3759dd1" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**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-4e90b3b5400c6790" class="astra-member">Lean</h3>

```csharp
public float Lean { get; set; }
```

Inclinar o tronco

Faixa válida: 0 a 1.

**Caminho:** Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Inclinar o tronco:** Quanto o corpo se inclina para alcançar longe.

**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-2308e3fbf2956f76" class="astra-member">LimbBones</h3>

```csharp
public float LimbBones { get; set; }
```

Ossos do braço (ossos)

Faixa válida: 2 a 8.

**Caminho:** Inspector → Sistema de interação → Interação; ou fachada C# em um Behavior.

**Uso:** **Ossos do braço:** Ossos que a mão arrasta ao alcançar (2 = antebraço e braço).

**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-9a2140cef22c0987" class="astra-member">LookAt</h3>

```csharp
public Astra.ObjectReference LookAt { get; set; }
```

Olhar com

**Caminho:** Inspector → Sistema de interação → Olhar; ou fachada C# em um Behavior.

**Uso:** **Olhar com:** Osso que olha para o objeto.

**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-26b4963daf1895d0" class="astra-member">LookSpeed</h3>

```csharp
public float LookSpeed { get; set; }
```

Entrada do olhar (/s)

Faixa válida: 0.1 a 20.

**Caminho:** Inspector → Sistema de interação → Olhar; ou fachada C# em um Behavior.

**Uso:** **Entrada do olhar:** Velocidade do olhar para o objeto.

**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-4029ed08d0bca1b7" class="astra-member">LookTurn</h3>

```csharp
public float LookTurn { get; set; }
```

Giro do olhar (/s)

Faixa válida: 0.5 a 60.

**Caminho:** Inspector → Sistema de interação → Olhar; ou fachada C# em um Behavior.

**Uso:** **Giro do olhar:** Giro máximo do olhar.

**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-ed7f2d76d0442758" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**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-8c3880e067726e36" class="astra-member">Pelvis</h3>

```csharp
public Astra.ObjectReference Pelvis { get; set; }
```

Pelve

**Caminho:** Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.

**Uso:** **Pelve:** Osso da pelve (agachar).

**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-cbb62ee7863f3950" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade

Faixa válida: 0.1 a 5.

**Caminho:** Inspector → Sistema de interação → Interação; ou fachada C# em um Behavior.

**Uso:** **Velocidade:** Escala os tempos do objeto.

**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-c4cc34e25f7df2bd" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Sistema de interação; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**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.