UE4骨骼共享插件AnimationSharingPlugin

发表于 更新于 分类于 Changyan：
本文字数： 4k 阅读时长 ≈ 4 分钟

前言

从遥远的2019年搬运而来, 作为记录, 不确定是否有更新

官方文档

  • 引用文档的结构图

Alt text

  • 插件已经启用，如果关闭到插件栏启用

Setup文件

Alt text

Alt text

  • 简单配置以后如下图

image-20191223145213446

  • 一个SkeltonSetup数据在UAnimationSharingManager::Register方法里会生成一个UObject<UAnimationSharingInstance*>,这个UObj会spawn一个场景里的单例Actor，同时存放所有实例对象以及对应的所有参数；这个Actor会根据上图中AnimationStates的数据量创建若干USkeletalMeshComponent维护动画

AnimationBlurprintForBlending(图中的ABP_Trans)

image-20191223145517613

  • 这个蓝图简单理解为用于动画切换，owner就是那个Actor单例
  • 逻辑很简单，直接拷贝就可以image-20191223145820707

StateProcessorClass

  • 必须配置一个枚举，对应所有状态，否则无法配置动画（AnimationStates数据）

  • image-20191223150355965

  • 每隔场景中的实例都会拥有一个对应的Object，一直在Tick得到这个实例的状态，主要逻辑如下

image-20191223150033324

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
void UStatProc::ProcessActorState_Implementation(int32& OutState, AActor* InActor, uint8 CurrentState, uint8 OnDemandState, bool& bShouldProcess)
{

	ATestShareRole* shareRole = Cast<ATestShareRole>(InActor);
	if (shareRole)
	{
		EShareEnum stat = shareRole->GetStat();	
		OutState = int32(stat);
		bShouldProcess = true;
		return;
	}
	OutState =-1;
	bShouldProcess = false;

}
  • 这个函数可以理解为状态的起始点，这个方法决定了每个实例的具体状态枚举，从而才有动画

AnimationStates

image-20191223150551638

  • Processor配置的枚举对应的动画参数

AnimBlueprint

  • 用于播放动画序列的简单动画蓝图，继承于AnimSharingStateInstance

image-20191223150729515

image-20191223150819957

  • 这个ABP只负责播放动画序列，至于专门播放，可以自行扩展
  • Offset参数用于控制实例动画的差异性，系统会算，对应的是NumRandomizedInstances参数
  • 单例Actor会独立创建NumRandomizedInstances数量的SKMesh组件用于控制动画表现，同时设置不同的Offset参数

同一个状态设置多个动画

image-20191223152554826

  • 如上图，Idle设置了2个动画，同时对Run动画对应的实例数量设置了10，造成的结果是场景中大约是10比1的生成2个动画的实例，其中Run动作的偏移参数也有若干份（根据场景中的实例个数换算比例）

OnDemand（指令模式）

  • 简单理解
    • 如果正在播放的是普通动画，切换到指令模式的动画是瞬间切换
    • 如果现在播放的是指令动画，切换到普通动画需要等指令动画播放完毕
    • 如果前后都是指令动画或者普通动画，都是瞬间切换

Additve

  • 基于OnDemand开启以后才能选择的模式
  • 开启以后隐藏了部分Demand选项
  • 开启以后上方的AdditveBlueprint可以设置

AddtiveABP

image-20191223160102804

image-20191223160046344

  • 文档给的方案是如图的连线方式，进入此状态后StateBool就设置为true，开始叠加

  • Add的最大数量参数如果少于实例数量，部分实例就没有叠加动画image-20191223160951498

  • 一些思考

    • 叠加动画多数用于受伤或者姿势上面的扩展

    • 叠加受伤无法用这套方案执行，甚至无法用这个插件执行，ABP无法get到控制实例的状态,下面是头文件所有申明，当然可以魔改掉插件内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
struct ANIMATIONSHARING_API FAdditiveAnimationInstance
{
public:
	FAdditiveAnimationInstance();

	void Initialise(USkeletalMeshComponent* InSkeletalMeshComponent, UClass* InAnimationBP);
	void Setup(USkeletalMeshComponent* InBaseComponent, UAnimSequence* InAnimSequence);
	void UpdateBaseComponent(USkeletalMeshComponent* InBaseComponent);
	void Stop();
	void Start();

	USkeletalMeshComponent* GetComponent() const;
	USkeletalMeshComponent* GetBaseComponent() const;	

protected:
	USkeletalMeshComponent * SkeletalMeshComponent;
	UAnimSharingAdditiveInstance* AdditiveInstance;
	UAnimSequence* AdditiveAnimationSequence;
	USkeletalMeshComponent* BaseComponent;
	bool bLoopingState;
};

  • 姿势扩展比如Idle叠加一些额外动作可以使用这一套方案，但是，有必要用专门一个枚举来提供这个动作？？

  • 一个的方案是提供接口可以得到控制实例的状态，但是跨度有点大，可能会有更多没想到的问题

Bug/缺陷

  • Demand动画设置了大于0的BlendTime，如果在BlendTime期间切换了，Demand动画大概率出不去；怀疑是普通动画等待Demand动画结束的通知跟动画本身结束的时间点发生时间方面的错误

    • 多次测试发现，2个动画（无所谓是否Demand）发生混合，要么都设置BlendTime=0，要么都设置非0切相等，则不会发生卡顿或者卡住；如果参数不一样，会发生切换的时候卡顿

  • 特殊情况，demand情况下的ReturnToPreviousStat（结束以后返回之前的状态）或者SetNextState（结束以后进入下一个指定状态）有问题;参考Processor的默认代码如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
void UStatProc::ProcessActorState_Implementation(int32& OutState, AActor* InActor, uint8 CurrentState, uint8 OnDemandState, bool& bShouldProcess)
{

	ATestShareRole* shareRole = Cast<ATestShareRole>(InActor);
	if (shareRole)
	{
		EShareEnum stat = shareRole->GetStat();
		OutState = int32(stat);
		bShouldProcess = true;
		return;
	}

	OutState =-1;
	bShouldProcess = false;

}

  • 解释：

    • 发起点是Actor中自己维护的状态枚举，通过设置到OutState然后引起一系列的动画计算和播放，然后下一帧才会通过2个uint8反馈过来

    • 如果用默认方案，ReturnToPreviousStat等方式在动画最后一帧确实把动画的状态设置了，但是第二帧又被Actor的状态给覆盖了

    • 解决方案是如果是特殊情况（ReturnToPreviousStat或者SetNextState），需要反向设置Actor的状态枚举，但是默认没法得到这个特殊情况变量，而且反向设置可能会导致一系列的问题

      manager里面的有一个每个骨骼的对应的Instance数据是Protected的，也没有方法可以拿到

      1
      2
      3
      4
      5
      6
      AnimationSharingManager.h
          protected:
      	//***//
      	/** Sharing data required for the unique Skeleton setups */
      	UPROPERTY(VisibleAnywhere, Transient, Category = AnimationSharing)
      	TArray<UAnimSharingInstance*> PerSkeletonData;

      这个数据里面每个UAnimaSharingInstance里有所有Setup数据

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      /** Actors currently registered to be animation driven by the AnimManager using this setup */
      	UPROPERTY(VisibleAnywhere, Transient, Category = AnimationSharing)
      	TArray<AActor*> RegisteredActors;
      	
      	/** Per actor data, matches RegisteredActors*/
      	TArray<FPerActorData> PerActorData;
      	/** Per component state data indexed from FPerActorData.ComponentIndices */
      	TArray<FPerComponentData> PerComponentData;

      	/** Array of unique state data */
      	TArray<FPerStateData> PerStateData;