Astra.Components.Collider

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

Sobre esta referência

Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.

Declaração

readonly struct Astra.Components.Collider

Colisor 3D: Volume de contato. Família Física 3D · Formas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-BoxCollider.html

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

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Física 3D / Formas → Colisor 3D.

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

Roadmap e uso

Física 3D e motores: 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 Colisor 3D para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
GetCollisionMesh	Method
GetMaterial	Method
OnCollisionEnter	Method
OnCollisionExit	Method
OnTriggerEnter	Method
OnTriggerExit	Method
OnTriggerStay	Method
Remove	Method
SetCollisionMesh	Method
SetMaterial	Method
Wrap	Method
ActiveEdgeAngle	Property
Center	Property
Component	Property
Convex	Property
Enabled	Property
Friction	Property
FrictionCombine	Property
HalfExtents	Property
HalfHeight	Property
HullTolerance	Property
InstanceId	Property
IsAlive	Property
MeshLocalPose	Property
Object	Property
OptimizeCooking	Property
Owner	Property
OwnMaterial	Property
Radius	Property
Restitution	Property
RestitutionCombine	Property
Rotation	Property
Shape	Property
Surface	Property
TypeId	Property
WeldVertices	Property

.ctor

public Collider(Astra.Component component)

Caminho: Inspector → Colisor 3D; 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: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
component	Astra.Component

GetCollisionMesh

public Astra.AssetGuid GetCollisionMesh(uint slot = 0)

Malha de colisão. Recurso do projeto por slot

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Malha de colisão. Recurso do projeto por slot

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
slot	uint	· Opcional: 0

GetMaterial

public Astra.AssetGuid GetMaterial(uint slot = 0)

Material físico. Recurso do projeto por slot

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Material físico. Recurso do projeto por slot

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
slot	uint	· Opcional: 0

OnCollisionEnter

public Astra.ComponentSubscription OnCollisionEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Colisão: começou. Contato sólido começou; entregue aos dois objetos. Payload: Outro objeto: objeto

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Colisão: começou. Contato sólido começou; entregue aos dois objetos. Payload: Outro objeto: objeto

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnCollisionExit

public Astra.ComponentSubscription OnCollisionExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Colisão: terminou. Contato sólido terminou; entregue aos dois objetos. Payload: Outro objeto: objeto

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Colisão: terminou. Contato sólido terminou; entregue aos dois objetos. Payload: Outro objeto: objeto

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnTriggerEnter

public Astra.ComponentSubscription OnTriggerEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnTriggerExit

public Astra.ComponentSubscription OnTriggerExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnTriggerStay

public Astra.ComponentSubscription OnTriggerStay(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Sensor: dentro. Outro corpo continua sobrepondo este sensor; no máximo uma vez por quadro e par. Payload: Outro objeto: objeto

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Sensor: dentro. Outro corpo continua sobrepondo este sensor; no máximo uma vez por quadro e par. Payload: Outro objeto: objeto

Roadmap deste membro: Física 3D e motores. 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 → Colisor 3D; ou fachada C# em um Behavior.

Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SetCollisionMesh

public void SetCollisionMesh(Astra.AssetGuid value, uint slot = 0)

Caminho: Inspector → Colisor 3D; 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: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
value	Astra.AssetGuid
slot	uint	· Opcional: 0

SetMaterial

public void SetMaterial(Astra.AssetGuid value, uint slot = 0)

Caminho: Inspector → Colisor 3D; 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: Física 3D e motores. 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.Collider Wrap(Astra.Component component)

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Envolve um Component existente após conferir TypeId; não cria componente.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
component	Astra.Component

ActiveEdgeAngle

public float ActiveEdgeAngle { get; set; }

Ângulo de aresta ativa (°). Separa arestas de contato em superfícies com mudança de normal acima deste ângulo.

Faixa válida: 0 a 90.

Caminho: Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

Uso: Ângulo de aresta ativa: Separa arestas de contato em superfícies com mudança de normal acima deste ângulo.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Center

public System.Numerics.Vector3 Center { get; set; }

Centro

Caminho: Inspector → Colisor 3D → Pose; ou fachada C# em um Behavior.

Uso: Centro X: Centro local da forma de colisão, eixo X. Centro Y: Centro local da forma de colisão, eixo Y. Centro Z: Centro local da forma de colisão, eixo Z.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

public Astra.Component Component { get; }

Caminho: Inspector → Colisor 3D; 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: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Convex

public bool Convex { get; set; }

Convexo. Casco convexo da malha: aceita corpo dinâmico. Desligado usa os triângulos exatos e só vale em corpo estático ou cinemático.

Caminho: Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

Uso: Convexo: Casco convexo da malha: aceita corpo dinâmico. Desligado usa os triângulos exatos e só vale em corpo estático ou cinemático.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

public bool Enabled { get; set; }

Ativo

Caminho: Inspector → Colisor 3D → Geral; ou fachada C# em um Behavior.

Uso: Ativo: Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Friction

public float Friction { get; set; }

Atrito. Usado por esta forma quando Material próprio está ligado

Faixa válida: 0 a 1.

Caminho: Inspector → Colisor 3D → Material; ou fachada C# em um Behavior.

Uso: Atrito: Usado por esta forma quando Material próprio está ligado

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FrictionCombine

public Astra.Components.Collider.FrictionCombineOption FrictionCombine { get; set; }

Combinar atrito

Caminho: Inspector → Colisor 3D → Material; ou fachada C# em um Behavior.

Uso: Combinar atrito: Política de combinar atrito do par. Padrão conserva a regra do motor; a precedência dos modos participa da escolha.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

HalfExtents

public System.Numerics.Vector3 HalfExtents { get; set; }

Meia extensão

Caminho: Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

Uso: Meia extensão X: Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo. Meia extensão Y: Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo. Meia extensão Z: Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

HalfHeight

public float HalfHeight { get; set; }

Meia altura cilíndrica

Faixa válida: 0.01 a 10000.

Caminho: Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

Uso: Meia altura cilíndrica: Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

HullTolerance

public float HullTolerance { get; set; }

Tolerância do casco (u). Pontos até esta distância podem ficar fora do casco; valores maiores geram cascos mais simples.

Faixa válida: 0.00001 a 1.

Caminho: Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

Uso: Tolerância do casco: Pontos até esta distância podem ficar fora do casco; valores maiores geram cascos mais simples.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

public ulong InstanceId { get; }

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Colisor 3D; 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: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

MeshLocalPose

public bool MeshLocalPose { get; set; }

Pose local da malha. Aplica centro e rotação locais à geometria física; não altera a malha visual. Desligado mantém a pose legada do objeto.

Caminho: Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

Uso: Pose local da malha: Aplica centro e rotação locais à geometria física; não altera a malha visual. Desligado mantém a pose legada do objeto.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

public Astra.GameObject Object { get; }

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Objeto dono deste componente; use para resolver composição.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OptimizeCooking

public bool OptimizeCooking { get; set; }

Otimizar para o jogo. Constrói uma árvore de busca mais eficiente; desligue para cozinhar mais rápido durante iterações.

Caminho: Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

Uso: Otimizar para o jogo: Constrói uma árvore de busca mais eficiente; desligue para cozinhar mais rápido durante iterações.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Owner

public Astra.ObjectReference Owner { get; set; }

Corpo proprietário

Caminho: Inspector → Colisor 3D → Vínculo; ou fachada C# em um Behavior.

Uso: Corpo proprietário: Escolhe o dono do corpo/forma no domínio do colisor.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OwnMaterial

public bool OwnMaterial { get; set; }

Material próprio. Esta forma usa atrito, restituição e superfície próprios em vez dos do corpo

Caminho: Inspector → Colisor 3D → Material; ou fachada C# em um Behavior.

Uso: Material próprio: Ligado usa material físico próprio desta forma. Desligado herda o do corpo. Não altera cor/textura.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Radius

public float Radius { get; set; }

Raio

Faixa válida: 0.01 a 10000.

Caminho: Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

Uso: Raio: Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Restitution

public float Restitution { get; set; }

Restituição

Faixa válida: 0 a 1.

Caminho: Inspector → Colisor 3D → Material; ou fachada C# em um Behavior.

Uso: Restituição: Restituição nos contatos; controla ressalto conforme a combinação física.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

RestitutionCombine

public Astra.Components.Collider.RestitutionCombineOption RestitutionCombine { get; set; }

Combinar restituição

Caminho: Inspector → Colisor 3D → Material; ou fachada C# em um Behavior.

Uso: Combinar restituição: Política de combinar restituição do par. Compare em uma queda controlada; não muda o material visual.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Rotation

public System.Numerics.Vector3 Rotation { get; set; }

Rotação

Caminho: Inspector → Colisor 3D → Pose; ou fachada C# em um Behavior.

Uso: Rotação local X: Rotação autorada do sistema na unidade indicada, eixo X. Rotação local Y: Rotação autorada do sistema na unidade indicada, eixo Y. Rotação local Z: Rotação autorada do sistema na unidade indicada, eixo Z.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Shape

public Astra.Components.Collider.ShapeOption Shape { get; set; }

Forma

Caminho: Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

Uso: Forma: Escolhe a geometria do colisor/campo no domínio indicado; os campos relevantes mudam por forma.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Surface

public Astra.Components.Collider.SurfaceOption Surface { get; set; }

Superfície

Caminho: Inspector → Colisor 3D → Material; ou fachada C# em um Behavior.

Uso: Superfície: Classificação da superfície para consumidores como regras de passos. Selecionar o valor não cria som ou Behavior automaticamente.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

public static string TypeId { get; }

Caminho: Inspector → Colisor 3D; ou fachada C# em um Behavior.

Uso: Identificador nativo usado em AddComponent/GetComponent.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

WeldVertices

public bool WeldVertices { get; set; }

Soldar vértices iguais. Compartilha vértices coincidentes antes de criar a malha física, reduzindo costuras internas.

Caminho: Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

Uso: Soldar vértices iguais: Compartilha vértices coincidentes antes de criar a malha física, reduzindo costuras internas.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.