---
title: "Astra.DynamicMotorRuntime"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-dynamicmotorruntime/
---

# Astra.DynamicMotorRuntime

Instance-bound commands on the real Body motor. Move applies for the current script frame; call in Update or FixedUpdate. FixedUpdate can override Update; ReleaseMove relinquishes the Script channel to the motor's authored ownership policy. Commands never write pose.

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

Instance-bound commands on the real Body motor. Move applies for the current script frame; call in Update or FixedUpdate. FixedUpdate can override Update; ReleaseMove relinquishes the Script channel to the motor's authored ownership policy. Commands never write pose.

## 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 |
|---|---|
| [Move](#member-a6fc9b9147a839c7) | Method |
| [ReadBodyState](#member-1ef5300cf16d6f99) | Method |
| [ReleaseMove](#member-d4307004be8f1a64) | Method |
| [TryJump](#member-8a2e1fa395be8774) | Method |

<h3 id="member-a6fc9b9147a839c7" class="astra-member">Move</h3>

```csharp
public void Move(System.Numerics.Vector2 input, float yawRadians = 0)
```

**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 |
|---|---|---|
| `input` | `System.Numerics.Vector2` |  |
| `yawRadians` | `float` |  · Opcional: `0` |

<h3 id="member-1ef5300cf16d6f99" class="astra-member">ReadBodyState</h3>

```csharp
public Astra.PhysicsBodyState ReadBodyState()
```

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

<h3 id="member-d4307004be8f1a64" class="astra-member">ReleaseMove</h3>

```csharp
public void ReleaseMove()
```

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

<h3 id="member-8a2e1fa395be8774" class="astra-member">TryJump</h3>

```csharp
public bool TryJump()
```

Queues one attempt for the next fixed step. Support decides acceptance; true means queued, not that an airborne jump was allowed.

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

**Uso:** Queues one attempt for the next fixed step. Support decides acceptance; true means queued, not that an airborne jump was allowed.

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