Pular para o conteúdo
AstraDOCS

Astra.Components.InteractionTrigger

Astra 0.3.1-preview.20261016Referência de assinaturas

Gatilho de interação: Faixa à frente do objeto: o personagem dentro dela interage. Família Lógica · IK.

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

readonly struct Astra.Components.InteractionTrigger

Gatilho de interação: Faixa à frente do objeto: o personagem dentro dela interage. Família Lógica · IK.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.xr.interaction.toolkit@3.0/manual/xr-direct-interactor.html

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

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / IK → Gatilho de interação.

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

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 Gatilho de interação para propriedades, valores iniciais, requisitos e edição em Play.

Membro Categoria
.ctor Method
Remove Method
Wrap Method
AngleOffset Property
Automatic Property
Component Property
Enabled Property
FixUp Property
Hands Property
InstanceId Property
Interactable Property
IsAlive Property
MaxAngle Property
Object Property
OffsetX Property
OffsetZ Property
Orbit Property
Radius Property
TypeId Property

.ctor

public InteractionTrigger(Astra.Component component)

Caminho: Inspector → Gatilho 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

Remove

public void Remove()

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

Caminho: Inspector → Gatilho 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.

Wrap

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

Caminho: Inspector → Gatilho 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

AngleOffset

public float AngleOffset { get; set; }

Giro da direção (graus)

Faixa válida: -180 a 180.

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Giro da direção: Giro da direção da faixa.

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

Automatic

public bool Automatic { get; set; }

Automático

Caminho: Inspector → Gatilho de interação → Gatilho; ou fachada C# em um Behavior.

Uso: Automático: Começa a interação ao entrar.

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 → Gatilho 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.

Enabled

public bool Enabled { get; set; }

Ativo

Caminho: Inspector → Gatilho de interação → Gatilho; 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.

FixUp

public bool FixUp { get; set; }

Cima fixo

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Cima fixo: Ignora a inclinação do objeto.

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

Hands

public Astra.Components.InteractionTrigger.HandsOption Hands { get; set; }

Mãos

Caminho: Inspector → Gatilho de interação → Gatilho; ou fachada C# em um Behavior.

Uso: Mãos: Mão esquerda, direita ou as duas.

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 → Gatilho 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.

Interactable

public Astra.ObjectReference Interactable { get; set; }

Objeto interagível

Caminho: Inspector → Gatilho de interação → Gatilho; ou fachada C# em um Behavior.

Uso: Objeto interagível: Objeto interagível alvo; vazio usa o próprio objeto.

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 → Gatilho 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.

MaxAngle

public float MaxAngle { get; set; }

Ângulo máximo (graus)

Faixa válida: 1 a 180.

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Ângulo máximo: Ângulo máximo entre a frente do personagem e o objeto.

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 → Gatilho 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.

OffsetX

public float OffsetX { get; set; }

Deslocamento lateral (m)

Faixa válida: -5 a 5.

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Deslocamento lateral: Deslocamento lateral da faixa.

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

OffsetZ

public float OffsetZ { get; set; }

Deslocamento à frente (m)

Faixa válida: -5 a 5.

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Deslocamento à frente: Deslocamento à frente.

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

Orbit

public bool Orbit { get; set; }

Em volta do objeto

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Em volta do objeto: Aceita qualquer direção em volta do objeto.

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

Radius

public float Radius { get; set; }

Raio (m)

Faixa válida: 0.05 a 10.

Caminho: Inspector → Gatilho de interação → Faixa; ou fachada C# em um Behavior.

Uso: Raio: Raio da faixa.

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 → Gatilho 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.