Pular para o conteúdo
AstraDOCS

Astra.PhysicsBodyRuntime

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Instance-bound access to the real native body. Recreating or removing the component invalidates this access; rebuilding its solver body preserves it.

Namespace: Astra · Assembly: Astra.Scripting · Tipo: Struct

readonly struct Astra.PhysicsBodyRuntime

Instance-bound access to the real native body. Recreating or removing the component invalidates this access; rebuilding its solver body preserves it.

No Behavior, use Physics, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

Física 3D e motores: 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.

Membro Categoria
AddAngularVelocityChange Method
AddForceAtPosition Method
AddImpulseAtPosition Method
AddVelocityChange Method
GetPointVelocity Method
GetRelativePointVelocity Method
ReadState Method
SetLinearAndAngularVelocity Method
Sleep Method
TryReadState Method
WakeUp Method
AngularVelocity Property
CenterOfMass Property
IsActive Property
IsSleeping Property

AddAngularVelocityChange

public void AddAngularVelocityChange(System.Numerics.Vector3 delta)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
delta System.Numerics.Vector3

AddForceAtPosition

public void AddForceAtPosition(System.Numerics.Vector3 force, System.Numerics.Vector3 worldPoint)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
force System.Numerics.Vector3
worldPoint System.Numerics.Vector3

AddImpulseAtPosition

public void AddImpulseAtPosition(System.Numerics.Vector3 impulse, System.Numerics.Vector3 worldPoint)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
impulse System.Numerics.Vector3
worldPoint System.Numerics.Vector3

AddVelocityChange

public void AddVelocityChange(System.Numerics.Vector3 delta)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
delta System.Numerics.Vector3

GetPointVelocity

public System.Numerics.Vector3 GetPointVelocity(System.Numerics.Vector3 worldPoint)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
worldPoint System.Numerics.Vector3

GetRelativePointVelocity

public System.Numerics.Vector3 GetRelativePointVelocity(System.Numerics.Vector3 localPoint)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
localPoint System.Numerics.Vector3

ReadState

public Astra.PhysicsBodyState ReadState()

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SetLinearAndAngularVelocity

public void SetLinearAndAngularVelocity(System.Numerics.Vector3 linear, System.Numerics.Vector3 angular)

Both velocities are published under one body lock, capped by its solver limits.

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

Uso: Both velocities are published under one body lock, capped by its solver limits.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
linear System.Numerics.Vector3
angular System.Numerics.Vector3

Sleep

public void Sleep()

Refuses static/kinematic bodies and bodies with AllowSleep false. Jolt sleep clears velocity; waking does not restore it.

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

Uso: Refuses static/kinematic bodies and bodies with AllowSleep false. Jolt sleep clears velocity; waking does not restore it.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TryReadState

public bool TryReadState(out Astra.PhysicsBodyState state)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
state Astra.PhysicsBodyState · Out

WakeUp

public void WakeUp()

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AngularVelocity

public System.Numerics.Vector3 AngularVelocity { get; set; }

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

Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

CenterOfMass

public System.Numerics.Vector3 CenterOfMass { get; }

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

Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsActive

public bool IsActive { get; }

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

Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsSleeping

public bool IsSleeping { get; }

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

Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.