Astra.Components.InteractionSystem
Sistema de interação: Leva a mão até objetos interagíveis. Família Lógica · IK.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.InteractionSystemSistema de interação: Leva a mão até objetos interagíveis. 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.InteractionSystem>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / IK → Sistema de interação.
No Behavior em Play, obtenha a fachada com Object.GetComponent<InteractionSystem>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new InteractionSystem(component) envolve um componente existente; não adiciona um componente à cena.
Roadmap e uso
Seção intitulada “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 Sistema de interação para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| OnEntered | Method |
| OnLeft | Method |
| OnPicked | Method |
| OnReached | Method |
| OnReleased | Method |
| Remove | Method |
| Start | Method |
| Stop | Method |
| Trigger | Method |
| Wrap | Method |
| AutoEffector | Property |
| AutoObject | Property |
| AutoSecond | Property |
| Chest | Property |
| Component | Property |
| Crouch | Property |
| Enabled | Property |
| InstanceId | Property |
| IsAlive | Property |
| Lean | Property |
| LimbBones | Property |
| LookAt | Property |
| LookSpeed | Property |
| LookTurn | Property |
| Object | Property |
| Pelvis | Property |
| Speed | Property |
| TypeId | Property |
.ctor
public InteractionSystem(Astra.Component component)Caminho: Inspector → Sistema de interação; 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 |
OnEntered
public Astra.ComponentSubscription OnEntered(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Entrou no gatilho. O personagem entrou na faixa de um Gatilho de interação (Objeto = o gatilho). Payload: Mão: objeto, Objeto: objeto
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Entrou no gatilho. O personagem entrou na faixa de um Gatilho de interação (Objeto = o gatilho). Payload: Mão: objeto, Objeto: objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnLeft
public Astra.ComponentSubscription OnLeft(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Saiu do gatilho. O personagem saiu da faixa do gatilho. Payload: Mão: objeto, Objeto: objeto
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Saiu do gatilho. O personagem saiu da faixa do gatilho. Payload: Mão: objeto, Objeto: objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnPicked
public Astra.ComponentSubscription OnPicked(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Levantou. A última mão chegou e o objeto sobe ao ponto de carregar. Payload: Mão: objeto, Objeto: objeto
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Levantou. A última mão chegou e o objeto sobe ao ponto de carregar. Payload: Mão: objeto, Objeto: objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnReached
public Astra.ComponentSubscription OnReached(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Alcançou. A mão chegou ao ponto de pegada. Payload: Mão: objeto, Objeto: objeto
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Alcançou. A mão chegou ao ponto de pegada. Payload: Mão: objeto, Objeto: objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnReleased
public Astra.ComponentSubscription OnReleased(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Soltou. A mão voltou à animação. Payload: Mão: objeto, Objeto: objeto
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Soltou. A mão voltou à animação. Payload: Mão: objeto, Objeto: objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
Remove
public void Remove()Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.
Caminho: Inspector → Sistema de interação; 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.
Start
public bool Start(Astra.ObjectReference effector, Astra.ObjectReference @object)Interagir. Leva a mão até o Objeto interagível; falso se a mão ou o objeto não servem
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Interagir. Leva a mão até o Objeto interagível; falso se a mão ou o objeto não servem
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
effector |
Astra.ObjectReference |
|
object |
Astra.ObjectReference |
Stop
public void Stop(Astra.ObjectReference effector)Soltar. Devolve a mão à animação e larga o objeto pego
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Soltar. Devolve a mão à animação e larga o objeto pego
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
effector |
Astra.ObjectReference |
Trigger
public bool Trigger()Interagir pelo gatilho. Começa a interação do Gatilho de interação mais próximo em que o personagem está; falso se não há nenhum
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Sistema de interação; ou fachada C# em um Behavior.
Uso: Interagir pelo gatilho. Começa a interação do Gatilho de interação mais próximo em que o personagem está; falso se não há nenhum
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.InteractionSystem Wrap(Astra.Component component)Caminho: Inspector → Sistema de interação; 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 |
AutoEffector
public Astra.ObjectReference AutoEffector { get; set; }Mão ao iniciar
Caminho: Inspector → Sistema de interação → Início sem script; ou fachada C# em um Behavior.
Uso: Mão ao iniciar: Mão usada pelos gatilhos automáticos.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
AutoObject
public Astra.ObjectReference AutoObject { get; set; }Objeto ao iniciar
Caminho: Inspector → Sistema de interação → Início sem script; ou fachada C# em um Behavior.
Uso: Objeto ao iniciar: Objeto padrão para iniciar por script.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
AutoSecond
public Astra.ObjectReference AutoSecond { get; set; }Segunda mão ao iniciar
Caminho: Inspector → Sistema de interação → Início sem script; ou fachada C# em um Behavior.
Uso: Segunda mão ao iniciar: Segunda mão.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Chest
public Astra.ObjectReference Chest { get; set; }Peito
Caminho: Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.
Uso: Peito: Osso do peito (inclinar).
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Component
public Astra.Component Component { get; }Caminho: Inspector → Sistema de interação; 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.
Crouch
public float Crouch { get; set; }Agachar até (m)
Faixa válida: 0 a 2.
Caminho: Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.
Uso: Agachar até: Quanto o corpo agacha para alcançar baixo.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Enabled
public bool Enabled { get; set; }Ativo
Caminho: Inspector → Sistema de interação → Interação; ou fachada C# em um Behavior.
Uso: Ativo: Desligado, o componente fica na cena sem agir.
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 → Sistema de interação; 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 → Sistema de interação; 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.
Lean
public float Lean { get; set; }Inclinar o tronco
Faixa válida: 0 a 1.
Caminho: Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.
Uso: Inclinar o tronco: Quanto o corpo se inclina para alcançar longe.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
LimbBones
public float LimbBones { get; set; }Ossos do braço (ossos)
Faixa válida: 2 a 8.
Caminho: Inspector → Sistema de interação → Interação; ou fachada C# em um Behavior.
Uso: Ossos do braço: Ossos que a mão arrasta ao alcançar (2 = antebraço e braço).
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
LookAt
public Astra.ObjectReference LookAt { get; set; }Olhar com
Caminho: Inspector → Sistema de interação → Olhar; ou fachada C# em um Behavior.
Uso: Olhar com: Osso que olha para o objeto.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
LookSpeed
public float LookSpeed { get; set; }Entrada do olhar (/s)
Faixa válida: 0.1 a 20.
Caminho: Inspector → Sistema de interação → Olhar; ou fachada C# em um Behavior.
Uso: Entrada do olhar: Velocidade do olhar para o objeto.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
LookTurn
public float LookTurn { get; set; }Giro do olhar (/s)
Faixa válida: 0.5 a 60.
Caminho: Inspector → Sistema de interação → Olhar; ou fachada C# em um Behavior.
Uso: Giro do olhar: Giro máximo do olhar.
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 → Sistema de interação; 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.
Pelvis
public Astra.ObjectReference Pelvis { get; set; }Pelve
Caminho: Inspector → Sistema de interação → Corpo; ou fachada C# em um Behavior.
Uso: Pelve: Osso da pelve (agachar).
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Speed
public float Speed { get; set; }Velocidade
Faixa válida: 0.1 a 5.
Caminho: Inspector → Sistema de interação → Interação; ou fachada C# em um Behavior.
Uso: Velocidade: Escala os tempos do objeto.
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 → Sistema de interação; 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.