Astra.Components.Projectile
Projétil: Anda pela frente; no primeiro acerto cria o impacto, solta os rastros e some. Família Efeitos · Comportamentos.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.ProjectileProjétil: Anda pela frente; no primeiro acerto cria o impacto, solta os rastros e some. Família Efeitos · Comportamentos.
Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Collider.OnCollisionEnter.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.Projectile>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Efeitos / Comportamentos → Projétil.
No Behavior em Play, obtenha a fachada com Object.GetComponent<Projectile>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new Projectile(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 Projétil para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| GetImpact | Method |
| GetMuzzle | Method |
| Remove | Method |
| SetImpact | Method |
| SetMuzzle | Method |
| Wrap | Method |
| Component | Property |
| Detach0 | Property |
| Detach1 | Property |
| Detach2 | Property |
| Detach3 | Property |
| Enabled | Property |
| FaceShooter | Property |
| ForwardAxis | Property |
| HitOffset | Property |
| InstanceId | Property |
| IsAlive | Property |
| Lifetime | Property |
| Object | Property |
| Radius | Property |
| RotationOffset | Property |
| Speed | Property |
| TypeId | Property |
.ctor
public Projectile(Astra.Component component)Caminho: Inspector → Projétil; 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 |
GetImpact
public Astra.AssetGuid GetImpact(uint slot = 0)Impacto. Recurso do projeto por slot
Caminho: Inspector → Projétil; ou fachada C# em um Behavior.
Uso: Impacto. Recurso do projeto por slot
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
slot |
uint |
· Opcional: 0 |
GetMuzzle
public Astra.AssetGuid GetMuzzle(uint slot = 0)Disparo. Recurso do projeto por slot
Caminho: Inspector → Projétil; ou fachada C# em um Behavior.
Uso: Disparo. Recurso do projeto por slot
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
slot |
uint |
· Opcional: 0 |
Remove
public void Remove()Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.
Caminho: Inspector → Projétil; 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.
SetImpact
public void SetImpact(Astra.AssetGuid value, uint slot = 0)Caminho: Inspector → Projétil; ou fachada C# em um Behavior.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
value |
Astra.AssetGuid |
|
slot |
uint |
· Opcional: 0 |
SetMuzzle
public void SetMuzzle(Astra.AssetGuid value, uint slot = 0)Caminho: Inspector → Projétil; ou fachada C# em um Behavior.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
value |
Astra.AssetGuid |
|
slot |
uint |
· Opcional: 0 |
Wrap
public static Astra.Components.Projectile Wrap(Astra.Component component)Caminho: Inspector → Projétil; 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 → Projétil; 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.
Detach0
public Astra.ObjectReference Detach0 { get; set; }Soltar 1. Filho que fica na cena quando o projétil some (rastro, fumaça)
Caminho: Inspector → Projétil → Ao acertar; ou fachada C# em um Behavior.
Uso: Soltar 1: Filho que fica na cena quando o projétil some (rastro, fumaça)
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Detach1
public Astra.ObjectReference Detach1 { get; set; }Soltar 2. Filho que fica na cena quando o projétil some (rastro, fumaça)
Caminho: Inspector → Projétil → Ao acertar; ou fachada C# em um Behavior.
Uso: Soltar 2: Filho que fica na cena quando o projétil some (rastro, fumaça)
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Detach2
public Astra.ObjectReference Detach2 { get; set; }Soltar 3. Filho que fica na cena quando o projétil some (rastro, fumaça)
Caminho: Inspector → Projétil → Ao acertar; ou fachada C# em um Behavior.
Uso: Soltar 3: Filho que fica na cena quando o projétil some (rastro, fumaça)
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Detach3
public Astra.ObjectReference Detach3 { get; set; }Soltar 4. Filho que fica na cena quando o projétil some (rastro, fumaça)
Caminho: Inspector → Projétil → Ao acertar; ou fachada C# em um Behavior.
Uso: Soltar 4: Filho que fica na cena quando o projétil some (rastro, fumaça)
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, o projétil para onde está
Caminho: Inspector → Projétil → Projétil; ou fachada C# em um Behavior.
Uso: Ativo: Desligado, o projétil para onde está
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
FaceShooter
public bool FaceShooter { get; set; }Impacto virado para o atirador. O impacto gira com o projétil (meia-volta); desligado, encara a superfície
Caminho: Inspector → Projétil → Impacto; ou fachada C# em um Behavior.
Uso: Impacto virado para o atirador: O impacto gira com o projétil (meia-volta); desligado, encara a superfície
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ForwardAxis
public Astra.Components.Projectile.ForwardAxisOption ForwardAxis { get; set; }Frente. +Z é a frente da Astra; −Z é a frente de um efeito importado da Unity
Caminho: Inspector → Projétil → Projétil; 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.
HitOffset
public float HitOffset { get; set; }Afastamento do impacto (m). O impacto nasce esta distância para fora da superfície
Faixa válida: -10 a 10.
Caminho: Inspector → Projétil → Impacto; ou fachada C# em um Behavior.
Uso: Afastamento do impacto: O impacto nasce 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 → Projétil; 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 → Projétil; 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.
Lifetime
public float Lifetime { get; set; }Vida (s). Destruído depois deste tempo mesmo sem acertar nada
Faixa válida: 0.05 a 3600.
Caminho: Inspector → Projétil → Projétil; ou fachada C# em um Behavior.
Uso: Vida: Destruído depois deste tempo mesmo sem acertar nada
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 → Projétil; 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.
Radius
public float Radius { get; set; }Raio (m). Raio da esfera que testa o acerto contra os colisores da cena
Faixa válida: 0 a 100.
Caminho: Inspector → Projétil → Projétil; ou fachada C# em um Behavior.
Uso: Raio: Raio da esfera que testa o acerto contra os colisores da cena
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
RotationOffset
public System.Numerics.Vector3 RotationOffset { get; set; }Giro do impacto
Caminho: Inspector → Projétil → Impacto; ou fachada C# em um Behavior.
Uso: Giro do impacto X: Diferente de zero, o impacto usa este giro fixo Giro do impacto Y: Diferente de zero, o impacto usa este giro fixo Giro do impacto Z: Diferente de zero, o impacto usa este giro fixo
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 (m/s). Avança pela frente do objeto em Play
Faixa válida: 0 a 10000.
Caminho: Inspector → Projétil → Projétil; ou fachada C# em um Behavior.
Uso: Velocidade: Avança pela frente do objeto em Play
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 → Projétil; 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.