For the complete documentation index, see llms.txt. This page is also available as Markdown.

Animações de Avatar

Faça o avatar do jogador reproduzir animações padrão ou personalizadas, e detecte quando um emote termina

Pode fazer o jogador executar uma animação como parte do código da cena. Isso pode ajudar a aumentar a imersão e também comunicar aos outros jogadores o que cada um está fazendo. As animações do Avatar são vistas tanto pelo próprio jogador (na visão em terceira pessoa) quanto pelos jogadores ao redor.

As animações controladas pelo jogador que envolvem o corpo inteiro são substituídas pelas animações de locomoção padrão, como andar e pular. Portanto, as animações de corpo inteiro reproduzidas pela cena só são executadas enquanto o jogador está parado. Se o jogador andar ou pular, qualquer animação de corpo inteiro será interrompida. As animações da parte superior do corpo não são interrompidas pelo movimento.

Usar o Scene Editor

A maneira mais fácil de fazer um jogador executar uma animação é usar o Scene Editor. Use a ação sem código Play Emote para reproduzir uma animação padrão, ou a ação Play Custom Emote para reproduzir uma animação de um arquivo. Consulte Tornar qualquer item inteligente.

Animações padrão

Use a função triggerEmote() para executar uma das animações padrão que os jogadores podem reproduzir em qualquer lugar de Decentraland. Essa função recebe como argumento um objeto com as seguintes propriedades:

  • predefinedEmote: nome em string de um emote existente.

  • mask: (opcional) reproduz a animação somente em uma parte do corpo do Avatar, usando um valor do enum AvatarMask . Por exemplo, AvatarMask.AM_UPPER_BODY anima somente a parte superior do corpo do Avatar. Consulte Animar somente a parte superior do corpo.

import { triggerEmote } from '~system/RestrictedActions'

const emoter = engine.addEntity()
Transform.create(emoter, { position: Vector3.create(8, 0, 8) })
MeshRenderer.setBox(emoter)
MeshCollider.setBox(emoter)
pointerEventsSystem.onPointerDown(
	{
		entity: emoter,
		opts: { button: InputAction.IA_POINTER, hoverText: 'Dance' },
	},
	() => {
		triggerEmote({ predefinedEmote: 'robot' })
	}
)

Os emotes a seguir dão feedback sobre as ações dos jogadores na sua cena. Todos eles são valores válidos para o campo predefinedEmote :

  • buttonDown

  • buttonFront

  • getHit

  • knockOut

  • lever

  • openChest

  • openDoor

  • punch

  • push

  • swingWeaponOneHand

  • swingWeaponTwoHands

  • throw

  • sittingChair1

  • sittingChair2

  • sittingGround1

  • sittingGround2

Os quatro sitting emotes repetem-se em ciclo: o avatar mantém a pose até o jogador se mover ou a sua cena chamar stopEmote({}). stopEmote é resolvida com { success: boolean }, que é false quando o Explorer recusa a chamada, por exemplo, porque o jogador já não está na sua cena. Todas as outras são reproduzidas uma vez e o avatar volta ao estado inativo.

Estes emotes estão disponíveis para todos os jogadores na roda de emotes predefinida e também podem ser usados em qualquer cena.

  • wave

  • fistpump

  • robot

  • raiseHand

  • clap

  • money

  • kiss

  • tik

  • hammer

  • tektonik

  • dontsee

  • handsair

  • shrug

  • disco

  • dab

  • headexplode

  • crafting

  • handsintheair

  • Victory

  • Waving

  • fistpump_short

cry e dance também são valores válidos para predefinedEmote, embora o pacote Animações do avatar do Creator Hub não os inclua.

💡 Sugestão: Se um jogador andar ou saltar enquanto a animação está a ser reproduzida, irá interrompê-la. Se não quiser que isso seja possível, pode imobilizar o avatar com Modificadores de entrada durante a animação do avatar.

Animações personalizadas

Utilize triggerSceneEmote() para fazer o jogador executar uma animação personalizada, armazenada num ficheiro .glb como parte dos recursos da cena.

💡 Dica: Não precisa de criar estas animações. O pacote Avatar Animations no Scene Editor inclui 45 animações prontas a usar, como poses sentadas, pesca, carregar uma caixa e dançar. Arraste uma para a vista 3D e o editor copia o ficheiro para a sua cena. Em seguida, passe o caminho desse ficheiro a triggerSceneEmote(). Os ficheiros ficam em assets/asset-packs/<animation-folder>/, por exemplo assets/asset-packs/whack/Whack_Avatar_emote.glb. Consulte o caminho exato em Local Assets. Consulte Adicionar itens.

Esta função recebe um objeto com as seguintes propriedades:

  • src: O caminho completo para o ficheiro de emote, relativo à pasta raiz do projeto. Para um ficheiro localizado em assets/animations/sit_emote.glb é necessário usar 'assets/animations/sit_emote.glb'.

  • loop: Se for true, a animação é repetida continuamente até o jogador se mover ou a animação ser parada. O valor predefinido é false.

  • mask: (opcional) reproduz a animação somente em uma parte do corpo do Avatar, usando um valor do enum AvatarMask . Por exemplo, AvatarMask.AM_UPPER_BODY anima somente a parte superior do corpo do Avatar. Consulte Animar somente a parte superior do corpo.

💡 Sugestão: Se um jogador andar ou saltar enquanto a animação está a ser reproduzida, irá interrompê-la. Se não quiser que isso seja possível, pode imobilizar o avatar com Modificadores de entrada durante a animação do avatar.

Adereços, partículas e som

Um ficheiro de emote reproduzido com triggerSceneEmote() pode incluir adereços, como uma raquete de ténis ou um jato de chamas, animados em conjunto com o avatar. Crie-o da mesma forma que um emote Emotes 2.0, seguindo as regras de nomenclatura em Adereços e sons:

  • O ficheiro contém dois clips de animação: um cujo nome inclui _Avatar para o avatar, e outro cujo nome inclui _Prop para a armature do adereço.

  • Ambos os clips têm a mesma duração.

  • Os efeitos de partículas funcionam se os converter em ossos animados. Consulte Partículas em Emotes.

Os outros jogadores nas proximidades veem os adereços, tal como veem a animação do avatar.

Animar apenas a parte superior do corpo

Tanto triggerEmote() como triggerSceneEmote() aceitam uma propriedade opcional mask que limita a animação a apenas uma parte do corpo do avatar.

Normalmente, uma animação para assim que o jogador começa a andar ou a saltar, porque as animações de locomoção predefinidas assumem o controlo de todo o corpo. Quando define mask como AvatarMask.AM_UPPER_BODY, a animação controla apenas o avatar da cintura para cima, e as pernas continuam a ser controladas pelas animações de locomoção predefinidas. Isto significa que o jogador pode continuar a andar ou a correr pela cena enquanto a parte superior do corpo executa a sua animação. Use esta opção para ações que não devem interromper o movimento, como transportar uma caixa, segurar uma tocha ou fazer malabarismo.

Neste exemplo, o jogador clica num botão e começa a festejar com os braços no ar, numa animação em loop. Como apenas a parte superior do corpo é animada, o jogador pode continuar a correr pela cena enquanto festeja, por exemplo, para acompanhar a ação numa corrida ou num jogo de futebol.

Tenha em conta o seguinte:

  • AvatarMask.AM_UPPER_BODY é atualmente o único valor da enumeração AvatarMask . Para reproduzir uma animação no corpo inteiro, basta não definir a propriedade mask .

  • A propriedade loop funciona da mesma forma que nas animações do corpo inteiro: com loop: false a animação mascarada é reproduzida uma vez e, em seguida, a parte superior do corpo volta à locomoção normal, com loop: true ela é repetida até ser interrompida.

  • Para interromper por código uma animação mascarada em loop, chame stopEmote({}), também importado de ~system/RestrictedActions. A chamada resolve com { success: boolean }.

Detetar quando uma emote termina

Cada evento do ciclo de vida de uma emote é comunicado através do componente AvatarEmoteCommand na entidade do jogador. Cada nova entrada contém um campo state com um valor do enum EmoteState :

  • EmoteState.ES_STARTED: A emote começou a ser reproduzida. Este também é o valor comunicado quando o campo state está ausente.

  • EmoteState.ES_FINISHED: Uma emote sem loop chegou ao fim naturalmente.

  • EmoteState.ES_INTERRUPTED: A emote foi interrompida antes do fim: o jogador moveu-se ou saltou, teletransportou-se, começou outra emote, a emote foi explicitamente interrompida ou o jogador saiu da cena.

Isto funciona tanto para as emotes acionadas pela cena (triggerEmote() e triggerSceneEmote()) como para as emotes que o jogador reproduz através da roda de emotes, bem como para as emotes reproduzidas por outros jogadores na cena.

Use a função onChange no componente AvatarEmoteCommand para reagir a cada nova entrada:

💡 Dica: Para reproduzir animações em avatares que não são jogadores, consulte Avatares NPC.

Atualizado