--- title: "Astra.Components.Joint2D" 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-joint2d/ --- # Astra.Components.Joint2D Junta 2D: Fixed/Weld, Revolute, Prismatic ou Distance reais. Família Física 2D · Juntas. **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.Joint2D ``` Junta 2D: Fixed/Weld, Revolute, Prismatic ou Distance reais. Família Física 2D · Juntas. Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Joint2D.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Juntas** → **Junta 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 Joint2D(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 [Junta 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-joint/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-88562ebef5c48898) | Method | | [Remove](#member-de870e0d14e422ac) | Method | | [Wrap](#member-3654194fb6532aa9) | Method | | [AnchorAX](#member-cbdf51de0832ecd8) | Property | | [AnchorAY](#member-070e90d98a6a0ff0) | Property | | [AnchorBX](#member-fbd1d849830f49af) | Property | | [AnchorBY](#member-adad69a11f284596) | Property | | [AngularDampingRatio](#member-184d4bdcda8922eb) | Property | | [AngularHertz](#member-9eb96af5dda46124) | Property | | [AxisAngleDegrees](#member-c6945d146d51bd59) | Property | | [CollideConnected](#member-3666bb3fc5e00f0c) | Property | | [Component](#member-39141fb0ded10449) | Property | | [Enabled](#member-f23eec8837107793) | Property | | [InstanceId](#member-e2607c8519b2fc1f) | Property | | [IsAlive](#member-fe701ef62a67638a) | Property | | [Kind](#member-f0c6f8e4a7a3c9b2) | Property | | [Length](#member-5b06bacfa711f9aa) | Property | | [LimitEnabled](#member-c736443ee5fc1598) | Property | | [LinearDampingRatio](#member-97d9dfa6ec23a933) | Property | | [LinearHertz](#member-47df75b6fab82c3e) | Property | | [LowerLimit](#member-b7a1c47f67f9fb7c) | Property | | [MaxLength](#member-e66fe6fa4281b40c) | Property | | [MaxMotorForce](#member-e84f207d246417fc) | Property | | [MaxMotorTorque](#member-dc04a3ed0d35cf41) | Property | | [MinLength](#member-5333b7a2e493e861) | Property | | [MotorAngularSpeedDegrees](#member-90fcfb150d6550d6) | Property | | [MotorEnabled](#member-7fe576b732631432) | Property | | [MotorSpeed](#member-5047519b75d7acd0) | Property | | [Object](#member-2a6673d7bb29596c) | Property | | [ReferenceAngleDegrees](#member-b84b4a208b4ae55a) | Property | | [SpringDamping](#member-f3b3f09a5955fd08) | Property | | [SpringEnabled](#member-13896640a363bc96) | Property | | [SpringHertz](#member-782011928b316b31) | Property | | [SpringTargetAngleDegrees](#member-f5859980b33acde1) | Property | | [SpringTargetTranslation](#member-d6042c76eee2614e) | Property | | [Target](#member-a9b936dbd189bcc8) | Property | | [TypeId](#member-4a2caf3fafa733db) | Property | | [UpperLimit](#member-0ae5efc1f96c2fb9) | Property | | [WorldAnchor](#member-9d16d0acfc933a1d) | Property |

.ctor

```csharp public Joint2D(Astra.Component component) ``` **Caminho:** Inspector → Junta 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 → Junta 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.Joint2D Wrap(Astra.Component component) ``` **Caminho:** Inspector → Junta 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` | |

AnchorAX

```csharp public float AnchorAX { get; set; } ``` Anchor A X (m) Faixa válida: -1000 a 1000. **Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior. **Uso:** **Anchor A X:** Posição da âncora no frame do corpo A, componente X. Configure os dois frames compatíveis. **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.

AnchorAY

```csharp public float AnchorAY { get; set; } ``` Anchor A Y (m) Faixa válida: -1000 a 1000. **Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior. **Uso:** **Anchor A Y:** Posição da âncora no frame do corpo A, componente Y. Configure os dois frames compatíveis. **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.

AnchorBX

```csharp public float AnchorBX { get; set; } ``` Anchor B X (m) Faixa válida: -1000 a 1000. **Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior. **Uso:** **Anchor B X:** Posição da âncora no frame do corpo B, componente X. Configure os dois frames compatíveis. **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.

AnchorBY

```csharp public float AnchorBY { get; set; } ``` Anchor B Y (m) Faixa válida: -1000 a 1000. **Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior. **Uso:** **Anchor B Y:** Posição da âncora no frame do corpo B, componente Y. Configure os dois frames compatíveis. **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.

AngularDampingRatio

```csharp public float AngularDampingRatio { get; set; } ``` Amortecimento angular weld Faixa válida: 0 a 10. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Amortecimento angular weld:** Razão de amortecimento angular 2D. **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.

AngularHertz

```csharp public float AngularHertz { get; set; } ``` Mola angular weld (Hz) Faixa válida: 0 a 120. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Mola angular weld:** Frequência da ligação angular 2D. **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.

AxisAngleDegrees

```csharp public float AxisAngleDegrees { get; set; } ``` Eixo local A (graus) Faixa válida: -180 a 180. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Eixo local A:** Direção do eixo da junta 2D em graus. **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.

CollideConnected

```csharp public bool CollideConnected { get; set; } ``` Colidir conectados **Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Colidir conectados:** Permite colisão entre os corpos conectados. **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.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Junta 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 → Junta 2D → Conexã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.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Junta 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 → Junta 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.

Kind

```csharp public Astra.Components.Joint2D.KindOption Kind { get; set; } ``` Modo **Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Modo:** Escolhe a variante de luz/junta no domínio indicado; siga os campos e requisitos condicionais. **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.

Length

```csharp public float Length { get; set; } ``` Comprimento repouso (m) Faixa válida: 0.005 a 1000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Comprimento repouso:** Comprimento de referência da junta Distance. **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.

LimitEnabled

```csharp public bool LimitEnabled { get; set; } ``` Limites **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Limites:** Ativa os limites configurados da junta 2D. **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.

LinearDampingRatio

```csharp public float LinearDampingRatio { get; set; } ``` Amortecimento linear weld Faixa válida: 0 a 10. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Amortecimento linear weld:** Razão de amortecimento linear 2D. **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.

LinearHertz

```csharp public float LinearHertz { get; set; } ``` Mola linear weld (Hz) Faixa válida: 0 a 120. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Mola linear weld:** Frequência da ligação linear 2D. **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.

LowerLimit

```csharp public float LowerLimit { get; set; } ``` Limite inferior Faixa válida: -178 a 178. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Limite inferior:** Limite inferior da junta 2D. **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.

MaxLength

```csharp public float MaxLength { get; set; } ``` Comprimento máximo (m) Faixa válida: 0.005 a 1000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Comprimento máximo:** Comprimento máximo da junta Distance. **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.

MaxMotorForce

```csharp public float MaxMotorForce { get; set; } ``` Força máxima motor (N) Faixa válida: 0 a 1000000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Força máxima motor:** Limite de força do motor linear 2D. **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.

MaxMotorTorque

```csharp public float MaxMotorTorque { get; set; } ``` Torque máximo motor (N m) Faixa válida: 0 a 1000000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Torque máximo motor:** Limite de torque do motor angular 2D. **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.

MinLength

```csharp public float MinLength { get; set; } ``` Comprimento mínimo (m) Faixa válida: 0.005 a 1000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Comprimento mínimo:** Comprimento mínimo da junta Distance. **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.

MotorAngularSpeedDegrees

```csharp public float MotorAngularSpeedDegrees { get; set; } ``` Motor angular (graus/s) Faixa válida: -36000 a 36000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Motor angular:** Velocidade angular alvo do motor 2D em graus/s. **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.

MotorEnabled

```csharp public bool MotorEnabled { get; set; } ``` Motor **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Motor:** Ativa motor da junta 2D. **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.

MotorSpeed

```csharp public float MotorSpeed { get; set; } ``` Velocidade motor (m/s) Faixa válida: -1000 a 1000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Velocidade motor:** Velocidade linear alvo do motor da junta 2D. **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 → Junta 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.

ReferenceAngleDegrees

```csharp public float ReferenceAngleDegrees { get; set; } ``` Ângulo referência (graus) Faixa válida: -180 a 180. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Ângulo referência:** Ângulo de referência relativo da junta 2D em graus. **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.

SpringDamping

```csharp public float SpringDamping { get; set; } ``` Razão amortecimento Faixa válida: 0 a 10. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Razão amortecimento:** Amortecimento da mola da junta. **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.

SpringEnabled

```csharp public bool SpringEnabled { get; set; } ``` Mola **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Mola:** Ativa mola da junta 2D. **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.

SpringHertz

```csharp public float SpringHertz { get; set; } ``` Frequência mola (Hz) Faixa válida: 0 a 120. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Frequência mola:** Frequência da mola 2D. **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.

SpringTargetAngleDegrees

```csharp public float SpringTargetAngleDegrees { get; set; } ``` Ângulo alvo (graus) Faixa válida: -180 a 180. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Ângulo alvo:** Ângulo alvo da mola 2D. **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.

SpringTargetTranslation

```csharp public float SpringTargetTranslation { get; set; } ``` Translação alvo (m) Faixa válida: -1000 a 1000. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Translação alvo:** Translação alvo da mola 2D. **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.

Target

```csharp public Astra.ObjectReference Target { get; set; } ``` Corpo conectado **Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Corpo conectado:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade. **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 → Junta 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.

UpperLimit

```csharp public float UpperLimit { get; set; } ``` Limite superior Faixa válida: -178 a 178. **Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior. **Uso:** **Limite superior:** Limite superior da junta 2D. **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.

WorldAnchor

```csharp public bool WorldAnchor { get; set; } ``` Conectar ao mundo **Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior. **Uso:** **Conectar ao mundo:** Interpreta a âncora conforme a opção de mundo da junta 2D. **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.