--- title: "Astra.Components.ConstantForce" 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-components-constantforce/ --- # Astra.Components.ConstantForce Força constante: Força e torque contínuos sobre corpo dinâmico. Família Física 3D · 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.ConstantForce ``` Força constante: Força e torque contínuos sobre corpo dinâmico. Família Física 3D · Forças. Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-ConstantForce.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Forças** → **Força constante**. 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 ConstantForce(component)` envolve um componente existente; não adiciona um componente à cena. ## 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/). Consulte também [Força constante](/pt-br/snapshot-2026-10-07/componentes/astra-physics-constant-force/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-a9735dc5cf15e132) | Method | | [Remove](#member-172708bbd3672a19) | Method | | [Wrap](#member-597fef5095e4d8a8) | Method | | [Component](#member-d6c14ad656486b10) | Property | | [Enabled](#member-cd04c3247565dbb3) | Property | | [Force](#member-85f42a1e956d058e) | Property | | [InstanceId](#member-57e14acb3d53a0aa) | Property | | [IsAlive](#member-b01cb01e08b0e7cb) | Property | | [Object](#member-c817ed874668c92f) | Property | | [RelativeForce](#member-f294467e2da81f25) | Property | | [RelativeTorque](#member-c77b407ac16cb799) | Property | | [Torque](#member-46c57035544f0e83) | Property | | [TypeId](#member-03dafae6973ecdf7) | Property |

.ctor

```csharp public ConstantForce(Astra.Component component) ``` **Caminho:** Inspector → Força constante; 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 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 | |---|---|---| | `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; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

```csharp public static Astra.Components.ConstantForce Wrap(Astra.Component component) ``` **Caminho:** Inspector → Força constante; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **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 | |---|---|---| | `component` | `Astra.Component` | |

Component

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

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo. Requer Corpo físico dinâmico no mesmo objeto; desligado permite configurar sem aplicar. **Caminho:** Inspector → Força constante → Força mundo; ou fachada C# em um Behavior. **Uso:** **Ativo:** Requer Corpo físico dinâmico no mesmo objeto; desligado permite configurar sem aplicar. **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.

Force

```csharp public System.Numerics.Vector3 Force { get; set; } ``` Força mundo **Caminho:** Inspector → Força constante → Força mundo; ou fachada C# em um Behavior. **Uso:** **Força X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força Z:** Aplicado a cada passo físico; não multiplique pelo tempo. **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.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Força constante; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **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.

IsAlive

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

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Força constante; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composiçã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.

RelativeForce

```csharp public System.Numerics.Vector3 RelativeForce { get; set; } ``` Força local **Caminho:** Inspector → Força constante → Força local; ou fachada C# em um Behavior. **Uso:** **Força local X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força local Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força local Z:** Aplicado a cada passo físico; não multiplique pelo tempo. **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.

RelativeTorque

```csharp public System.Numerics.Vector3 RelativeTorque { get; set; } ``` Torque local **Caminho:** Inspector → Força constante → Torque local; ou fachada C# em um Behavior. **Uso:** **Torque local X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque local Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque local Z:** Aplicado a cada passo físico; não multiplique pelo tempo. **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.

Torque

```csharp public System.Numerics.Vector3 Torque { get; set; } ``` Torque mundo **Caminho:** Inspector → Força constante → Torque mundo; ou fachada C# em um Behavior. **Uso:** **Torque X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque Z:** Aplicado a cada passo físico; não multiplique pelo tempo. **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.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Força constante; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **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.