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 enumAvatarMask. Por exemplo,AvatarMask.AM_UPPER_BODYanima 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 :
buttonDownbuttonFrontgetHitknockOutleveropenChestopenDoorpunchpushswingWeaponOneHandswingWeaponTwoHandsthrowsittingChair1sittingChair2sittingGround1sittingGround2
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.
wavefistpumprobotraiseHandclapmoneykisstikhammertektonikdontseehandsairshrugdiscodabheadexplodecraftinghandsintheairVictoryWavingfistpump_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.
Animações personalizadas
Utilize triggerSceneEmote() para fazer o jogador executar uma animação personalizada, armazenada num ficheiro .glb como parte dos recursos da cena.
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 emassets/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 enumAvatarMask. Por exemplo,AvatarMask.AM_UPPER_BODYanima somente a parte superior do corpo do Avatar. Consulte Animar somente a parte superior do corpo.
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
_Avatarpara o avatar, e outro cujo nome inclui_Proppara 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çãoAvatarMask. Para reproduzir uma animação no corpo inteiro, basta não definir a propriedademask.A propriedade
loopfunciona da mesma forma que nas animações do corpo inteiro: comloop: falsea animação mascarada é reproduzida uma vez e, em seguida, a parte superior do corpo volta à locomoção normal, comloop: trueela é 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 campostateestá 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:
Atualizado