--- title: "Astra.Components.Recoil" version: snapshot-2026-10-16 engineGeneration: astra-current language: C# status: semantic-reference reviewedAt: 2026-10-16 appRelease: "0.3.1-preview.20261016" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-16/api/astra-components-recoil/ --- # Astra.Components.Recoil Recuo: Levanta e recua a cadeia a cada disparo. Família Lógica · IK. **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.Recoil ``` Recuo: Levanta e recua a cadeia a cada disparo. Família Lógica · IK. Referência estudada: https://docs.unity3d.com/Packages/com.unity.animation.rigging@1.2/manual/constraints/MultiAimConstraint.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **IK** → **Recuo**. 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 Recoil(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): 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 [Recuo](/pt-br/snapshot-2026-10-16/componentes/astra-ik-recoil/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-bc6e27e9f43deb68) | Method | | [Fire](#member-b32b61970aee696f) | Method | | [Remove](#member-0a985f273b53e165) | Method | | [Wrap](#member-fa64e94aa9e3a1a8) | Method | | [Axis](#member-265a0da14e3a9e8c) | Property | | [ChainLength](#member-5f4c2beada2deb78) | Property | | [Component](#member-19a2e03e111a7054) | Property | | [Duration](#member-a67ccb95da9ba4f3) | Property | | [Enabled](#member-026e017e356f2b64) | Property | | [InstanceId](#member-41c1f8c73da7af37) | Property | | [IsAlive](#member-0f67f3ddfddf90fa) | Property | | [KickAngle](#member-331a82c576110535) | Property | | [KickBack](#member-4e35a8a16e4e30cc) | Property | | [Object](#member-5051cb660b19c915) | Property | | [TypeId](#member-22596a5cb58e238d) | Property | | [Weight](#member-241a3de3696e0f17) | Property |

.ctor

```csharp public Recoil(Astra.Component component) ``` **Caminho:** Inspector → Recuo; 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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Fire

```csharp public void Fire(double magnitude) ``` Disparar. Aplica um recuo; intensidade 1 usa os valores autorados Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Recuo; ou fachada C# em um Behavior. **Uso:** Disparar. Aplica um recuo; intensidade 1 usa os valores autorados **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `magnitude` | `double` | |

Remove

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

Wrap

```csharp public static Astra.Components.Recoil Wrap(Astra.Component component) ``` **Caminho:** Inspector → Recuo; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Axis

```csharp public Astra.Components.Recoil.AxisOption Axis { get; set; } ``` Eixo do cano **Caminho:** Inspector → Recuo → Cadeia; ou fachada C# em um Behavior. **Uso:** **Eixo do cano:** Eixo local do osso usado pelo efeito; os eixos variam por modelo (no Robot Kyle, o +Z da cabeça aponta para o lado). As receitas escolhem o eixo alinhado com a frente do personagem. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ChainLength

```csharp public float ChainLength { get; set; } ``` Ossos no recuo (ossos) Faixa válida: 1 a 8. **Caminho:** Inspector → Recuo → Cadeia; ou fachada C# em um Behavior. **Uso:** **Ossos no recuo:** Quantos ossos acima deste participam. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Recuo; 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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Duration

```csharp public float Duration { get; set; } ``` Recuperação (s) Faixa válida: 0.02 a 3. **Caminho:** Inspector → Recuo → Recuo; ou fachada C# em um Behavior. **Uso:** **Recuperação:** Tempo para voltar. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo **Caminho:** Inspector → Recuo → Influência; ou fachada C# em um Behavior. **Uso:** **Ativo:** Desligado, o componente fica na cena sem agir. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Recuo; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Recuo; 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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

KickAngle

```csharp public float KickAngle { get; set; } ``` Levantar (graus) Faixa válida: 0 a 60. **Caminho:** Inspector → Recuo → Recuo; ou fachada C# em um Behavior. **Uso:** **Levantar:** Levantada do cano em graus. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

KickBack

```csharp public float KickBack { get; set; } ``` Recuar (m) Faixa válida: 0 a 1. **Caminho:** Inspector → Recuo → Recuo; ou fachada C# em um Behavior. **Uso:** **Recuar:** Recuo da mão em metros. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Recuo; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Recuo; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Weight

```csharp public float Weight { get; set; } ``` Peso Faixa válida: 0 a 1. **Caminho:** Inspector → Recuo → Influência; ou fachada C# em um Behavior. **Uso:** **Peso:** 0 desliga, 1 aplica por inteiro; anime para ligar e desligar o efeito com suavidade. **Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.