Pular para o conteúdo
AstraDOCS

Astra.Components.Laser

Astra 0.4.0-preview.20261028Referência de assinaturas

Laser: Raio da frente do objeto até o primeiro colisor, desenhado pela Linha, com impacto no ponto. Família Efeitos · Comportamentos.

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

readonly struct Astra.Components.Laser

Laser: Raio da frente do objeto até o primeiro colisor, desenhado pela Linha, com impacto no ponto. Família Efeitos · Comportamentos.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Physics.Raycast.html

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

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Efeitos / Comportamentos → Laser.

No Behavior em Play, obtenha a fachada com Object.GetComponent<Laser>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new Laser(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 Laser para propriedades, valores iniciais, requisitos e edição em Play.

Membro Categoria
.ctor Method
Remove Method
Wrap Method
AlignHit Property
Component Property
Enabled Property
ForwardAxis Property
HitEffect Property
HitOffset Property
InstanceId Property
IsAlive Property
MaxLength Property
Object Property
TextureTiling Property
TypeId Property

.ctor

public Laser(Astra.Component component)

Caminho: Inspector → Laser; 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 → Laser; 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.Laser Wrap(Astra.Component component)

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

AlignHit

public bool AlignHit { get; set; }

Impacto alinhado ao laser. O impacto gira com o laser; desligado, encara a superfície atingida

Caminho: Inspector → Laser → Impacto; ou fachada C# em um Behavior.

Uso: Impacto alinhado ao laser: O impacto gira com o laser; desligado, encara a superfície atingida

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 → Laser; 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. Desligado, a linha e o impacto param de seguir o raio

Caminho: Inspector → Laser → Laser; ou fachada C# em um Behavior.

Uso: Ativo: Desligado, a linha e o impacto param de seguir o raio

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

ForwardAxis

public Astra.Components.Laser.ForwardAxisOption ForwardAxis { get; set; }

Frente. +Z é a frente da Astra; −Z é a frente de um efeito importado da Unity

Caminho: Inspector → Laser → Laser; ou fachada C# em um Behavior.

Uso: Frente: +Z é a frente da Astra; −Z é a frente de um efeito importado da Unity

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

HitEffect

public Astra.ObjectReference HitEffect { get; set; }

Efeito de impacto. Objeto levado ao ponto atingido; as partículas dele tocam enquanto o raio acerta algo

Caminho: Inspector → Laser → Impacto; ou fachada C# em um Behavior.

Uso: Efeito de impacto: Objeto levado ao ponto atingido; as partículas dele tocam enquanto o raio acerta algo

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

HitOffset

public float HitOffset { get; set; }

Afastamento do impacto (m). O impacto fica esta distância para fora da superfície

Faixa válida: -10 a 10.

Caminho: Inspector → Laser → Impacto; ou fachada C# em um Behavior.

Uso: Afastamento do impacto: O impacto fica esta distância para fora da superfície

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 → Laser; 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 → Laser; 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.

MaxLength

public float MaxLength { get; set; }

Alcance (m). Distância máxima do raio; sem acerto, a linha termina aqui

Faixa válida: 0.01 a 10000.

Caminho: Inspector → Laser → Laser; ou fachada C# em um Behavior.

Uso: Alcance: Distância máxima do raio; sem acerto, a linha termina aqui

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 → Laser; 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.

TextureTiling

public float TextureTiling { get; set; }

Repetições por metro (/m). Quantas vezes a imagem da Linha se repete por metro de raio (zero estica)

Faixa válida: 0 a 100.

Caminho: Inspector → Laser → Laser; ou fachada C# em um Behavior.

Uso: Repetições por metro: Quantas vezes a imagem da Linha se repete por metro de raio (zero estica)

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 → Laser; 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.