--- title: "Astra.Components.ConstantForce2D" 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-components-constantforce2d/ --- # Astra.Components.ConstantForce2D Força constante 2D: Força XY e torque contínuos sobre Body2D dinâmico. Família Física 2D · Forças. **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.ConstantForce2D ``` Força constante 2D: Força XY e torque contínuos sobre Body2D dinâmico. Família Física 2D · Forças. Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/ConstantForce2D.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Forças** → **Força constante 2D**. No Behavior em Play, obtenha a fachada com `Object.GetComponent()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new ConstantForce2D(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): 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 [Força constante 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-constant-force/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-e43b069c809c47f8) | Method | | [Remove](#member-20e534616997c008) | Method | | [Wrap](#member-910dd24ccee10026) | Method | | [Component](#member-2420f2b6416a3bf5) | Property | | [Enabled](#member-fc482c93e5390ac1) | Property | | [ForceX](#member-11247047861f9e8d) | Property | | [ForceY](#member-aa438828693398ff) | Property | | [InstanceId](#member-39b0085c58d6dc48) | Property | | [IsAlive](#member-1e1ed1ea0d5d4c12) | Property | | [Object](#member-c138c51f2e51d29a) | Property | | [RelativeForceX](#member-4f193c55b0988772) | Property | | [RelativeForceY](#member-994ebfd8976ff389) | Property | | [Torque](#member-00993beef9012b53) | Property | | [TypeId](#member-1152874fed98d2eb) | Property |

.ctor

```csharp public ConstantForce2D(Astra.Component component) ``` **Caminho:** Inspector → Força constante 2D; 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:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar. **Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior. **Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

```csharp public static Astra.Components.ConstantForce2D Wrap(Astra.Component component) ``` **Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Força constante 2D; 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:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo **Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior. **Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ForceX

```csharp public float ForceX { get; set; } ``` Força X (N) Faixa válida: -1000000 a 1000000. **Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior. **Uso:** **Força X:** Força contínua em espaço mundial, eixo X. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ForceY

```csharp public float ForceY { get; set; } ``` Força Y (N) Faixa válida: -1000000 a 1000000. **Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior. **Uso:** **Força Y:** Força contínua em espaço mundial, eixo Y. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Força constante 2D; 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:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

RelativeForceX

```csharp public float RelativeForceX { get; set; } ``` Força local X (N) Faixa válida: -1000000 a 1000000. **Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior. **Uso:** **Força local X:** Força contínua no espaço local do objeto, eixo X. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

RelativeForceY

```csharp public float RelativeForceY { get; set; } ``` Força local Y (N) Faixa válida: -1000000 a 1000000. **Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior. **Uso:** **Força local Y:** Força contínua no espaço local do objeto, eixo Y. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Torque

```csharp public float Torque { get; set; } ``` Torque (N m) Faixa válida: -1000000 a 1000000. **Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior. **Uso:** **Torque:** Torque contínuo sobre o Body2D dinâmico; não é orientação autoral. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.