--- title: "Mola de posição" version: snapshot-2026-10-06 engineGeneration: astra-current language: C# status: source-reviewed runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-spring-position/ --- # Mola de posição Segue fonte com velocidade e amortecimento persistentes no runtime **Família:** Lógica · **Grupo:** Molas · **Identificador:** `astra.spring.position` · **Payload:** 1 :::note[Escopo da evidência] Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho. ::: ## Para que usar Segue fonte com velocidade e amortecimento persistentes no runtime Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador. ## Criar e configurar Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de posição**. O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.SpringPositionConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springpositionconstraint/). ## Exemplo de uso Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo. ## Dependências Nenhuma regra adicional declarada no schema deste componente. ## Conflitos - [Position Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-position/): Escolha restrição direta ou mola para posição - [Parent Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/): Parent Constraint já escreve posição ## Edição e ciclo de vida | Operação | Contrato | |---|---| | Adicionar/remover em Play | ponto seguro | | Alterar propriedades em Play | ponto seguro | | Múltiplas instâncias | Não | | Versão do payload | 1 | 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](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/). ## Propriedades 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. ### Fonte | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Influência**](#field-weight)
`weight` | número | 1 | 0 … 1 | | [**Ativo**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Fonte**](#field-target)
`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

Influência · weight

**Onde:** Inspector → **Mola de posição** → **Fonte** → **Influência**. **Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição. **Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Ativo · enabled

**Onde:** Inspector → **Mola de posição** → **Fonte** → **Ativo**. **Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados. **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Fonte · target

**Onde:** Inspector → **Mola de posição** → **Fonte** → **Fonte**. **Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade. **Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore. ### Resposta | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Frequência**](#field-frequency)
`frequency` | número · Hz | 3 | 0.01 … 60 | | [**Razão de amortecimento**](#field-damping-ratio)
`damping_ratio` | número | 1 | 0 … 10 | | [**Velocidade máxima**](#field-max-speed)
`max_speed` | número · m/s | 1000 | 0.001 … 100000 |

Frequência · frequency

**Onde:** Inspector → **Mola de posição** → **Resposta** → **Frequência**. **Uso e efeito:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo. **Valor:** 3 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.01 … 60.

Razão de amortecimento · damping_ratio

**Onde:** Inspector → **Mola de posição** → **Resposta** → **Razão de amortecimento**. **Uso e efeito:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final. **Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Velocidade máxima · max_speed

**Onde:** Inspector → **Mola de posição** → **Resposta** → **Velocidade máxima**. **Uso e efeito:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala. **Valor:** 1000 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0.001 … 100000. ### Ajustes | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Offset X**](#field-offset-x)
`offset_x` | número | 0 | -10000 … 10000 | | [**Offset Y**](#field-offset-y)
`offset_y` | número | 0 | -10000 … 10000 | | [**Offset Z**](#field-offset-z)
`offset_z` | número | 0 | -10000 … 10000 |

Offset X · offset_x

**Onde:** Inspector → **Mola de posição** → **Ajustes** → **Offset X**. **Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.

Offset Y · offset_y

**Onde:** Inspector → **Mola de posição** → **Ajustes** → **Offset Y**. **Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.

Offset Z · offset_z

**Onde:** Inspector → **Mola de posição** → **Ajustes** → **Offset Z**. **Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z. **Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000. ## Roadmap deste componente [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity. Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade. ## Conferir na sua cena 1. Crie **Mola de posição** 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. ## Limitações da referência 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](https://docs.unity3d.com/6000.0/Documentation/Manual/class-PositionConstraint.html). Essa referência não representa paridade funcional.