Astra.Components.ParticleCollisionSpawn
Instanciar ao colidir: Cada toque de partícula cria um prefab no ponto (respingo, faísca, explosão). Família Efeitos · Comportamentos.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.ParticleCollisionSpawnInstanciar ao colidir: Cada toque de partícula cria um prefab no ponto (respingo, faísca, explosão). Família Efeitos · Comportamentos.
Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/MonoBehaviour.OnParticleCollision.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.ParticleCollisionSpawn>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Efeitos / Comportamentos → Instanciar ao colidir.
No Behavior em Play, obtenha a fachada com Object.GetComponent<ParticleCollisionSpawn>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new ParticleCollisionSpawn(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 Instanciar ao colidir para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| GetEffects | Method |
| Remove | Method |
| SetEffects | Method |
| Wrap | Method |
| Component | Property |
| DestroyDelay | Property |
| DestroyEmitter | Property |
| Enabled | Property |
| FaceEmitter | Property |
| ForwardAxis | Property |
| InstanceId | Property |
| IsAlive | Property |
| MaxPerFrame | Property |
| Object | Property |
| Offset | Property |
| RotationOffset | Property |
| RotationOffsetOnly | Property |
| TypeId | Property |
| WorldSpace | Property |
.ctor
public ParticleCollisionSpawn(Astra.Component component)Caminho: Inspector → Instanciar ao colidir; 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 |
GetEffects
public Astra.AssetGuid GetEffects(uint slot = 0)Efeitos. Recurso do projeto por slot
Caminho: Inspector → Instanciar ao colidir; ou fachada C# em um Behavior.
Uso: Efeitos. 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 → Instanciar ao colidir; 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.
SetEffects
public void SetEffects(Astra.AssetGuid value, uint slot = 0)Caminho: Inspector → Instanciar ao colidir; 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.ParticleCollisionSpawn Wrap(Astra.Component component)Caminho: Inspector → Instanciar ao colidir; 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 → Instanciar ao colidir; 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.
DestroyDelay
public float DestroyDelay { get; set; }Duração do efeito (s). Cada efeito criado é destruído depois deste tempo
Faixa válida: 0.05 a 3600.
Caminho: Inspector → Instanciar ao colidir → Ao colidir; ou fachada C# em um Behavior.
Uso: Duração do efeito: Cada efeito criado é destruído depois deste tempo
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
DestroyEmitter
public bool DestroyEmitter { get; set; }Destruir este objeto. Depois do primeiro toque, este objeto some meio segundo depois dos efeitos
Caminho: Inspector → Instanciar ao colidir → Ao colidir; ou fachada C# em um Behavior.
Uso: Destruir este objeto: Depois do primeiro toque, este objeto some meio segundo depois dos efeitos
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, os toques não criam nada
Caminho: Inspector → Instanciar ao colidir → Ao colidir; ou fachada C# em um Behavior.
Uso: Ativo: Desligado, os toques não criam nada
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
FaceEmitter
public bool FaceEmitter { get; set; }Virado para o emissor. O efeito olha para este objeto
Caminho: Inspector → Instanciar ao colidir → Giro; ou fachada C# em um Behavior.
Uso: Virado para o emissor: O efeito olha para este objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ForwardAxis
public Astra.Components.ParticleCollisionSpawn.ForwardAxisOption ForwardAxis { get; set; }Frente dos efeitos. Eixo que aponta para a superfície: +Z nos efeitos da Astra, −Z nos importados da Unity
Caminho: Inspector → Instanciar ao colidir → Giro; ou fachada C# em um Behavior.
Uso: Frente dos efeitos: Eixo que aponta para a superfície: +Z nos efeitos da Astra, −Z nos importados da Unity
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 → Instanciar ao colidir; 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 → Instanciar ao colidir; 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.
MaxPerFrame
public float MaxPerFrame { get; set; }Máximo por quadro. Teto de efeitos criados num quadro (chuva de toques não trava o aparelho)
Faixa válida: 1 a 64.
Caminho: Inspector → Instanciar ao colidir → Ao colidir; ou fachada C# em um Behavior.
Uso: Máximo por quadro: Teto de efeitos criados num quadro (chuva de toques não trava o aparelho)
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 → Instanciar ao colidir; 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.
Offset
public float Offset { get; set; }Afastamento (m). O efeito nasce esta distância para fora da superfície
Faixa válida: -10 a 10.
Caminho: Inspector → Instanciar ao colidir → Ao colidir; ou fachada C# em um Behavior.
Uso: Afastamento: O efeito 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.
RotationOffset
public System.Numerics.Vector3 RotationOffset { get; set; }Giro fixo
Caminho: Inspector → Instanciar ao colidir → Giro; ou fachada C# em um Behavior.
Uso: Giro fixo X: Giro do efeito criado Giro fixo Y: Giro do efeito criado Giro fixo Z: Giro do efeito criado
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
RotationOffsetOnly
public bool RotationOffsetOnly { get; set; }Só o giro fixo. Com giro fixo, usa só ele; desligado, soma o giro à direção da superfície
Caminho: Inspector → Instanciar ao colidir → Giro; ou fachada C# em um Behavior.
Uso: Só o giro fixo: Com giro fixo, usa só ele; desligado, soma o giro à direção da superfície
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 → Instanciar ao colidir; 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.
WorldSpace
public bool WorldSpace { get; set; }Solto na cena. O efeito criado fica na cena; desligado, vira filho deste objeto
Caminho: Inspector → Instanciar ao colidir → Ao colidir; ou fachada C# em um Behavior.
Uso: Solto na cena: O efeito criado fica na cena; desligado, vira filho deste objeto
Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.