Astra.Components.InteractionObject

Astra 0.3.1-preview.20261016Referência de assinaturas

Objeto interagível: Ponto de pegada, pose da mão e tempos. Família Lógica · IK.

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

Declaração

readonly struct Astra.Components.InteractionObject

Objeto interagível: Ponto de pegada, pose da mão e tempos. Família Lógica · IK.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.animation.rigging@1.2/manual/constraints/TwoBoneIKConstraint.html

Interfaces: Astra.Components.IComponentFacade<Astra.Components.InteractionObject>.

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / IK → Objeto interagível.

No Behavior em Play, obtenha a fachada com Object.GetComponent<InteractionObject>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new InteractionObject(component) envolve um componente existente; não adiciona um componente à cena.

Roadmap e uso

Objetos, Behaviors e composição: 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.

Consulte também Objeto interagível para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
Remove	Method
Wrap	Method
Component	Property
Grip	Property
HandPose	Property
HoldPoint	Property
InstanceId	Property
IsAlive	Property
LiftTime	Property
Object	Property
PickUp	Property
ReachTime	Property
ReleaseTime	Property
SecondGrip	Property
TypeId	Property

.ctor

public InteractionObject(Astra.Component component)

Caminho: Inspector → Objeto interagível; 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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`component`	`Astra.Component`

Remove

public void Remove()

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

Caminho: Inspector → Objeto interagível; 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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

public static Astra.Components.InteractionObject Wrap(Astra.Component component)

Caminho: Inspector → Objeto interagível; 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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`component`	`Astra.Component`

Component

public Astra.Component Component { get; }

Caminho: Inspector → Objeto interagível; 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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Grip

public Astra.ObjectReference Grip { get; set; }

Ponto de pegada

Caminho: Inspector → Objeto interagível → Pegada; ou fachada C# em um Behavior.

Uso: Ponto de pegada: Filho do objeto onde a mão vai.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

HandPose

public Astra.ObjectReference HandPose { get; set; }

Pose da mão

Caminho: Inspector → Objeto interagível → Pegada; ou fachada C# em um Behavior.

Uso: Pose da mão: Poser de mão aplicado ao pegar.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

HoldPoint

public Astra.ObjectReference HoldPoint { get; set; }

Ponto de carregar

Caminho: Inspector → Objeto interagível → Carregar; ou fachada C# em um Behavior.

Uso: Ponto de carregar: Ponto do personagem onde o objeto fica ao carregar com as duas mãos.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

public ulong InstanceId { get; }

Caminho: Inspector → Objeto interagível; 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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Objeto interagível; 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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LiftTime

public float LiftTime { get; set; }

Tempo para levantar (s)

Faixa válida: 0.05 a 5.

Caminho: Inspector → Objeto interagível → Carregar; ou fachada C# em um Behavior.

Uso: Tempo para levantar: Tempo para erguer até o ponto de carregar.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

public Astra.GameObject Object { get; }

Caminho: Inspector → Objeto interagível; ou fachada C# em um Behavior.

Uso: Objeto dono deste componente; use para resolver composição.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

PickUp

public bool PickUp { get; set; }

Pegar ao alcançar

Caminho: Inspector → Objeto interagível → Pegada; ou fachada C# em um Behavior.

Uso: Pegar ao alcançar: O objeto passa para a mão ao ser alcançado.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ReachTime

public float ReachTime { get; set; }

Tempo para alcançar (s)

Faixa válida: 0.05 a 5.

Caminho: Inspector → Objeto interagível → Tempo; ou fachada C# em um Behavior.

Uso: Tempo para alcançar: Tempo para a mão chegar à pegada.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ReleaseTime

public float ReleaseTime { get; set; }

Tempo para soltar (s)

Faixa válida: 0.05 a 5.

Caminho: Inspector → Objeto interagível → Tempo; ou fachada C# em um Behavior.

Uso: Tempo para soltar: Tempo para soltar.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SecondGrip

public Astra.ObjectReference SecondGrip { get; set; }

Pegada da 2ª mão

Caminho: Inspector → Objeto interagível → Pegada; ou fachada C# em um Behavior.

Uso: Pegada da 2ª mão: Pegada da segunda mão.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

public static string TypeId { get; }

Caminho: Inspector → Objeto interagível; ou fachada C# em um Behavior.

Uso: Identificador nativo usado em AddComponent/GetComponent.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.