--- title: "Astra.Components.LookAtIk" 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-lookatik/ --- # Astra.Components.LookAtIk Look At IK: Coluna e cabeça olham para o alvo com pesos e ângulo máximo. 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.LookAtIk ``` Look At IK: Coluna e cabeça olham para o alvo com pesos e ângulo máximo. 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** → **Look At IK**. 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 LookAtIk(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 [Look At IK](/pt-br/snapshot-2026-10-16/componentes/astra-ik-look-at/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-b3f38e7a3d722a7c) | Method | | [Remove](#member-12daffb05630719e) | Method | | [Wrap](#member-5d7c13f899c2fc21) | Method | | [Axis](#member-9460bbf9b15ed449) | Property | | [BodyWeight](#member-323e5c95243f1da7) | Property | | [ChainLength](#member-cd380c3d401f1d6d) | Property | | [ClampAngle](#member-606cc19f1004bb3c) | Property | | [Component](#member-18e9b6b6ebbf9f48) | Property | | [Enabled](#member-d54be7ee33ac92c1) | Property | | [HeadWeight](#member-67177377940f7793) | Property | | [InstanceId](#member-648dd5fcd124925c) | Property | | [IsAlive](#member-6c7ca7b2369a9301) | Property | | [Object](#member-4669442f224e1953) | Property | | [Priority](#member-377aa8dd6889805e) | Property | | [Target](#member-5a0ffba8bd12ebae) | Property | | [TypeId](#member-3d5a33e08045ce2a) | Property | | [Weight](#member-2415a4bd1612fd28) | Property |

.ctor

```csharp public LookAtIk(Astra.Component component) ``` **Caminho:** Inspector → Look At IK; 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` | |

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar. **Caminho:** Inspector → Look At IK; 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.LookAtIk Wrap(Astra.Component component) ``` **Caminho:** Inspector → Look At IK; 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.LookAtIk.AxisOption Axis { get; set; } ``` Eixo frontal **Caminho:** Inspector → Look At IK → Distribuição; ou fachada C# em um Behavior. **Uso:** **Eixo frontal:** 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.

BodyWeight

```csharp public float BodyWeight { get; set; } ``` Peso do corpo Faixa válida: 0 a 1. **Caminho:** Inspector → Look At IK → Distribuição; ou fachada C# em um Behavior. **Uso:** **Peso do corpo:** Quanto a coluna participa do olhar. **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 na cadeia (ossos) Faixa válida: 1 a 16. **Caminho:** Inspector → Look At IK → Distribuição; ou fachada C# em um Behavior. **Uso:** **Ossos na cadeia:** 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.

ClampAngle

```csharp public float ClampAngle { get; set; } ``` Ângulo máximo (graus) Faixa válida: 0 a 180. **Caminho:** Inspector → Look At IK → Limite; ou fachada C# em um Behavior. **Uso:** **Ângulo máximo:** Ângulo máximo do olhar 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.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Look At IK; 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.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo **Caminho:** Inspector → Look At IK → 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.

HeadWeight

```csharp public float HeadWeight { get; set; } ``` Peso da cabeça Faixa válida: 0 a 1. **Caminho:** Inspector → Look At IK → Distribuição; ou fachada C# em um Behavior. **Uso:** **Peso da cabeça:** Quanto a cabeça participa. **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 → Look At IK; 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 → Look At IK; 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.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Look At IK; 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.

Priority

```csharp public float Priority { get; set; } ``` Prioridade Faixa válida: -100 a 100. **Caminho:** Inspector → Look At IK → Influência; ou fachada C# em um Behavior. **Uso:** **Prioridade:** Ordem entre solvers do mesmo osso: o maior roda por último e vence. **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.

Target

```csharp public Astra.ObjectReference Target { get; set; } ``` Alvo **Caminho:** Inspector → Look At IK → Alvo; ou fachada C# em um Behavior. **Uso:** **Alvo:** Objeto da cena que o solver alcança; as receitas criam um alvo nomeado ao lado 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.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Look At IK; 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 → Look At IK → 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.