Poser de mão

Astra 0.3.1-preview.20261016Conferido em fonte

Copia a pose de uma hierarquia de referência

Família: Lógica · Grupo: IK · Identificador: astra.ik.hand_poser · Payload: 1

Para que usar

Copia a pose de uma mão de referência (dedos e pulso) para a mão do personagem, com peso.

Adicione à mão, aponte a Referência (uma hierarquia de mão posada, por exemplo a pegada de um objeto) e ajuste o Peso.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / IK → Poser de mão.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é Astra.Components.HandPoser.

Incluir o próprio osso copia também a rotação do pulso.

Guia relacionado: Efeitos de IK e interação

Exemplo de uso

Objeto interagível com Pose da mão apontando para uma mão fechada: ao pegar, os dedos assumem a pegada.

Dependências

Nenhuma regra adicional declarada no schema deste componente.

Conflitos

Nenhuma regra adicional declarada no schema deste componente.

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.

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.

Influência

Propriedade	Tipo / unidade	Padrão	Domínio
Peso `weight`	número	1	0 … 1
Ativo `enabled`	booleano	verdadeiro	verdadeiro \| falso

Peso · `weight`

Onde: Inspector → Poser de mão → Influência → Peso.

Uso e efeito: 0 desliga, 1 aplica por inteiro; anime para ligar e desligar o efeito com suavidade.

Valor: 1 · Tipo: número · Domínio: 0 … 1.

Aceita tween numérico via contrato de propriedade.

Ativo · `enabled`

Onde: Inspector → Poser de mão → Influência → Ativo.

Uso e efeito: Desligado, o componente fica na cena sem agir.

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Pose

Propriedade	Tipo / unidade	Padrão	Domínio
Incluir este osso `include_self`	booleano	falso	verdadeiro \| falso
Pose de referência `reference`	referência	Escolher pose	qualquer objeto · fora da subárvore

Incluir este osso · `include_self`

Onde: Inspector → Poser de mão → Pose → Incluir este osso.

Uso e efeito: Copia também a rotação do pulso.

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Pose de referência · `reference`

Onde: Inspector → Poser de mão → Pose → Pose de referência.

Uso e efeito: Hierarquia de mão posada a copiar.

Valor: Escolher pose · Tipo: referência · Domínio: qualquer objeto · fora da subárvore.

Roadmap deste componente

Objetos, Behaviors e composição. Presente na 0.3.1. Sem mistura entre duas referências. Sem data prometida.

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

Crie Poser de mão pelo fluxo indicado e resolva as dependências.
Altere uma propriedade por vez e observe o efeito esperado na cena.
Salve, reabra e confira os valores autorais.
Entre em Play e verifique o comportamento com os recursos reais do projeto.
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. Essa referência não representa paridade funcional.