Pular para o conteúdo
AstraDOCS

Junta

Nove mecanismos Jolt com limites, referenciais e motores

Família: Física 3D · Grupo: Juntas · Identificador: astra.physics.joint · Payload: 2

Selecione o objeto na Hierarquia, abra Adicionar componente e procure Junta, na família Física 3D. Confira os requisitos antes de confirmar a composição.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é Astra.Components.Joint.

Nenhuma regra adicional declarada no schema deste componente.

Operação Contrato
Adicionar/remover em Play ponto seguro
Alterar propriedades em Play ponto seguro
Múltiplas instâncias Sim
Versão do payload 2

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja Play e cena autoral.

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Âncora A · X
anchor_a_x | número | 0 | -100000 … 100000 | | Âncora A · Y
anchor_a_y | número | 0 | -100000 … 100000 | | Âncora A · Z
anchor_a_z | número | 0 | -100000 … 100000 | | Âncora B · X
anchor_b_x | número | 0 | -100000 … 100000 | | Âncora B · Y
anchor_b_y | número | 0 | -100000 … 100000 | | Âncora B · Z
anchor_b_z | número | 0 | -100000 … 100000 | | Conectar corpo
connected_body | referência | Escolher corpo | astra.physics.body · outro objeto |

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Eixo A · X
axis_a_x | número | 0 | -1 … 1 | | Eixo A · Y
axis_a_y | número | 1 | -1 … 1 | | Eixo A · Z
axis_a_z | número | 0 | -1 … 1 | | Eixo B · X
axis_b_x | número | 0 | -1 … 1 | | Eixo B · Y
axis_b_y | número | 1 | -1 … 1 | | Eixo B · Z
axis_b_z | número | 0 | -1 … 1 | | Plano A · X
normal_a_x | número | 1 | -1 … 1 | | Plano A · Y
normal_a_y | número | 0 | -1 … 1 | | Plano A · Z
normal_a_z | número | 0 | -1 … 1 | | Plano B · X
normal_b_x | número | 1 | -1 … 1 | | Plano B · Y
normal_b_y | número | 0 | -1 … 1 | | Plano B · Z
normal_b_z | número | 0 | -1 … 1 |

axis_a_x: A exibição depende do estado do componente.

axis_a_y: A exibição depende do estado do componente.

axis_a_z: A exibição depende do estado do componente.

axis_b_x: A exibição depende do estado do componente.

axis_b_y: A exibição depende do estado do componente.

axis_b_z: A exibição depende do estado do componente.

normal_a_x: A exibição depende do estado do componente.

normal_a_y: A exibição depende do estado do componente.

normal_a_z: A exibição depende do estado do componente.

normal_b_x: A exibição depende do estado do componente.

normal_b_y: A exibição depende do estado do componente.

normal_b_z: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
limit_min | número | 0 | -100000 … 100000 | | Limite máximo
limit_max | número | 1 | -100000 … 100000 |

limit_min: A exibição depende do estado do componente.

limit_max: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Velocidade do motor
motor_velocity | número | 0 | -1000 … 1000 | | Alvo do motor
motor_position | número | 0 | -100000 … 100000 | | Força / torque máximo
motor_force | número | 100 | 0 … 1000000 | | Frequência · Hz
spring_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento da mola
spring_damping | número | 1 | 0 … 10 | | Motor
motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

motor_velocity: A exibição depende do estado do componente.

motor_position: A exibição depende do estado do componente.

motor_force: A exibição depende do estado do componente.

spring_frequency: A exibição depende do estado do componente.

spring_damping: A exibição depende do estado do componente.

motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Cone · semiângulo Y
swing_y | número · ° | 45 | 0 … 180 | | Cone · semiângulo Z
swing_z | número · ° | 45 | 0 … 180 | | Torção mínima
twist_min | número · ° | -45 | -180 … 180 | | Torção máxima
twist_max | número · ° | 45 | -180 … 180 |

swing_y: A exibição depende do estado do componente.

swing_z: A exibição depende do estado do componente.

twist_min: A exibição depende do estado do componente.

twist_max: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
linear_x_minimum | número · u | -1 | -100000 … 100000 | | Limite máximo
linear_x_maximum | número · u | 1 | -100000 … 100000 | | Atrito máximo
linear_x_friction | número · N | 0 | 0 … 1000000 | | Velocidade alvo
linear_x_velocity | número · u/s | 0 | -1000 … 1000 | | Posição alvo
linear_x_position | número · u | 0 | -100000 … 100000 | | Força máxima
linear_x_force | número · N | 100 | 0 … 1000000 | | Frequência
linear_x_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento
linear_x_damping | número | 1 | 0 … 10 | | Movimento
linear_x_motion | enumeração | Travado | Travado | Limitado | Livre | | Motor
linear_x_motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

linear_x_minimum: A exibição depende do estado do componente.

linear_x_maximum: A exibição depende do estado do componente.

linear_x_friction: A exibição depende do estado do componente.

linear_x_velocity: A exibição depende do estado do componente.

linear_x_position: A exibição depende do estado do componente.

linear_x_force: A exibição depende do estado do componente.

linear_x_frequency: A exibição depende do estado do componente.

linear_x_damping: A exibição depende do estado do componente.

linear_x_motion: A exibição depende do estado do componente.

linear_x_motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
linear_y_minimum | número · u | -1 | -100000 … 100000 | | Limite máximo
linear_y_maximum | número · u | 1 | -100000 … 100000 | | Atrito máximo
linear_y_friction | número · N | 0 | 0 … 1000000 | | Velocidade alvo
linear_y_velocity | número · u/s | 0 | -1000 … 1000 | | Posição alvo
linear_y_position | número · u | 0 | -100000 … 100000 | | Força máxima
linear_y_force | número · N | 100 | 0 … 1000000 | | Frequência
linear_y_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento
linear_y_damping | número | 1 | 0 … 10 | | Movimento
linear_y_motion | enumeração | Travado | Travado | Limitado | Livre | | Motor
linear_y_motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

linear_y_minimum: A exibição depende do estado do componente.

linear_y_maximum: A exibição depende do estado do componente.

linear_y_friction: A exibição depende do estado do componente.

linear_y_velocity: A exibição depende do estado do componente.

linear_y_position: A exibição depende do estado do componente.

linear_y_force: A exibição depende do estado do componente.

linear_y_frequency: A exibição depende do estado do componente.

linear_y_damping: A exibição depende do estado do componente.

linear_y_motion: A exibição depende do estado do componente.

linear_y_motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
linear_z_minimum | número · u | -1 | -100000 … 100000 | | Limite máximo
linear_z_maximum | número · u | 1 | -100000 … 100000 | | Atrito máximo
linear_z_friction | número · N | 0 | 0 … 1000000 | | Velocidade alvo
linear_z_velocity | número · u/s | 0 | -1000 … 1000 | | Posição alvo
linear_z_position | número · u | 0 | -100000 … 100000 | | Força máxima
linear_z_force | número · N | 100 | 0 … 1000000 | | Frequência
linear_z_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento
linear_z_damping | número | 1 | 0 … 10 | | Movimento
linear_z_motion | enumeração | Travado | Travado | Limitado | Livre | | Motor
linear_z_motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

linear_z_minimum: A exibição depende do estado do componente.

linear_z_maximum: A exibição depende do estado do componente.

linear_z_friction: A exibição depende do estado do componente.

linear_z_velocity: A exibição depende do estado do componente.

linear_z_position: A exibição depende do estado do componente.

linear_z_force: A exibição depende do estado do componente.

linear_z_frequency: A exibição depende do estado do componente.

linear_z_damping: A exibição depende do estado do componente.

linear_z_motion: A exibição depende do estado do componente.

linear_z_motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
angular_x_minimum | número · ° | -1 | -180 … 180 | | Limite máximo
angular_x_maximum | número · ° | 1 | -180 … 180 | | Atrito máximo
angular_x_friction | número · Nm | 0 | 0 … 1000000 | | Velocidade alvo
angular_x_velocity | número · °/s | 0 | -1000 … 1000 | | Posição alvo
angular_x_position | número · ° | 0 | -180 … 180 | | Força máxima
angular_x_force | número · Nm | 100 | 0 … 1000000 | | Frequência
angular_x_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento
angular_x_damping | número | 1 | 0 … 10 | | Movimento
angular_x_motion | enumeração | Travado | Travado | Limitado | Livre | | Motor
angular_x_motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

angular_x_minimum: A exibição depende do estado do componente.

angular_x_maximum: A exibição depende do estado do componente.

angular_x_friction: A exibição depende do estado do componente.

angular_x_velocity: A exibição depende do estado do componente.

angular_x_position: A exibição depende do estado do componente.

angular_x_force: A exibição depende do estado do componente.

angular_x_frequency: A exibição depende do estado do componente.

angular_x_damping: A exibição depende do estado do componente.

angular_x_motion: A exibição depende do estado do componente.

angular_x_motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
angular_y_minimum | número · ° | -1 | -180 … 180 | | Limite máximo
angular_y_maximum | número · ° | 1 | -180 … 180 | | Atrito máximo
angular_y_friction | número · Nm | 0 | 0 … 1000000 | | Velocidade alvo
angular_y_velocity | número · °/s | 0 | -1000 … 1000 | | Posição alvo
angular_y_position | número · ° | 0 | -180 … 180 | | Força máxima
angular_y_force | número · Nm | 100 | 0 … 1000000 | | Frequência
angular_y_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento
angular_y_damping | número | 1 | 0 … 10 | | Movimento
angular_y_motion | enumeração | Travado | Travado | Limitado | Livre | | Motor
angular_y_motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

angular_y_minimum: A exibição depende do estado do componente.

angular_y_maximum: A exibição depende do estado do componente.

angular_y_friction: A exibição depende do estado do componente.

angular_y_velocity: A exibição depende do estado do componente.

angular_y_position: A exibição depende do estado do componente.

angular_y_force: A exibição depende do estado do componente.

angular_y_frequency: A exibição depende do estado do componente.

angular_y_damping: A exibição depende do estado do componente.

angular_y_motion: A exibição depende do estado do componente.

angular_y_motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Limite mínimo
angular_z_minimum | número · ° | -1 | -180 … 180 | | Limite máximo
angular_z_maximum | número · ° | 1 | -180 … 180 | | Atrito máximo
angular_z_friction | número · Nm | 0 | 0 … 1000000 | | Velocidade alvo
angular_z_velocity | número · °/s | 0 | -1000 … 1000 | | Posição alvo
angular_z_position | número · ° | 0 | -180 … 180 | | Força máxima
angular_z_force | número · Nm | 100 | 0 … 1000000 | | Frequência
angular_z_frequency | número · Hz | 2 | 0.001 … 1000 | | Amortecimento
angular_z_damping | número | 1 | 0 … 10 | | Movimento
angular_z_motion | enumeração | Travado | Travado | Limitado | Livre | | Motor
angular_z_motor | enumeração | Desligado | Desligado | Velocidade | Posição | Posição e velocidade |

angular_z_minimum: A exibição depende do estado do componente.

angular_z_maximum: A exibição depende do estado do componente.

angular_z_friction: A exibição depende do estado do componente.

angular_z_velocity: A exibição depende do estado do componente.

angular_z_position: A exibição depende do estado do componente.

angular_z_force: A exibição depende do estado do componente.

angular_z_frequency: A exibição depende do estado do componente.

angular_z_damping: A exibição depende do estado do componente.

angular_z_motion: A exibição depende do estado do componente.

angular_z_motor: A exibição depende do estado do componente.

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Ativa
enabled | booleano | verdadeiro | verdadeiro | falso | | Tipo
kind | enumeração | Distância | Ponto | Dobradiça | Deslizante | Distância | Fixa | Cone | Swing / Twist | Configurável 6DOF | Mola |

  1. Crie Junta pelo fluxo indicado e resolva as dependências.
  2. Altere uma propriedade por vez e observe o efeito esperado na cena.
  3. Salve, reabra e confira os valores autorais.
  4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
  5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

Referência de arquitetura registrada pela engine: documentação oficial. Essa referência não representa paridade funcional.