档概要:关于使用ActorComponents 及创建自定义ActorComponent 类型的解释说明。

文档变更记录:由Andrew Scheidecker创建；由Scott Sherman 和 Matt Oelfke更新；并将会不断地进行维护。

概述

在虚幻引擎中，所有游戏相关的物体都是从基类Actor继承而来。在之前一代的虚幻引擎中，基类Actor是非常重量级的，不论Actor的属性行为是什么，任何从Actor衍生而来的类将会继承它的所有属性。

Actor组件通过定义多个轻量级组件来解决这个问题，轻量级组件用于为Actor渲染和碰撞的模块化扩展提供接口。

通过使用在虚幻引擎2中先前定义的子对象语法的修改版本，我们把组件原型定义在类的默认属性中。命名原型，并使得一个子类继承该原型。子类可以覆盖原型的某些或所有默认属性。要想使用组件，可以通过默认属性把它添加到Actor的组件(Component)数组中。在默认属性中引用的组件原型是和Actor类一同进行实例化的。默认的属性改变可以被传递到关卡中保存的Actor类的所有现有实例上。

使用Actor组件

ActorComponent 对 PrimitiveComponent

ActorComponent(Actor组件)是一个可以附加到世界中的一个actor上的对象。

PrimitiveComponent(图元组件)是一个可以进行渲染和碰撞的ActorComponent(Actor组件)。

添加一个组件

如果任何实例化的Actor具有SpriteComponent，那么SpriteComponent将随同那个Actor一同进行实例化(除非子类从它的数组中删除了Sprite)。

组件数组引用的组件是和Actor的位置相绑定的。

实例:

class Actor extends Object;

var const array<ActorComponent>   Components;

defaultproperties
{
   Begin Object class="SpriteComponent" Name=Sprite
      Sprite=S_Actor
      HiddenGame=True
   End Object
   Components.Add(Sprite)
}

修改一个组件

实例:

class Trigger extends Actor;

defaultproperties
{
   Begin Object Name=Sprite
      Sprite=S_Trigger
   End Object
}

删除一个组件

实例:

class StaticMeshActor extends Actor;

defaultproperties
{
   Components.Remove(Sprite)
   …
}

因为Sprite组件原型已经不被StaticMeshActor类的默认属性所引用，所以它将不会被在跟着StaticMeshActors一同进行实例化。

组件模板

组件模板用于声明actor类的默认组件。一个组件模板是一个命名对象，它包含了在类的默认属性中的一个组件的默认属性。当实例化那个类时，则它所引用的组件模板也会随同它进行实例化。

组件模板将会被它们声明所在类的子类所继承。每个子类可以覆盖继承的模版的独立的属性。

组件模板的实例是相对于模版的默认属性来进行实例化的。这使得当把actor组件实例放置到关卡中时，它仍然可以从模板属性中接受改变。

创建组件模板

组件模板在类的默认属性中进行声明：

Begin Object class="SpriteComponent" Name=Sprite
   Sprite=Texture2D‘EngineResources.S_Actor‘
   HiddenGame=True
   AlwaysLoadOnClient=False
   AlwaysLoadOnServer=False
End Object

实例化及附加组件模板

除非组件模板被一个类的默认属性所引用，否则它将不会随同那个类进行实例化；并且除非一个actor组件在actor的组件数组中，否则那个actor组件将不能附加到那个actor上。您可以把actor组件模板和actor类一同进行实例化，并通过在默认属性中把组件模板添加到actor的组件数组中来自动地把实例化的组件附加到actor实例上。

Begin Object class="SpriteComponent" Name=Sprite
   // Sprite组件属性在这里进行赋值。
End Object
Components.Add(Sprite)

改变从父类继承而来的组件模板的属性

组件模板将会被最初声明该模板的类的子类所继承。子类可以覆盖继承的模板上的单独的属性。这个实例从Actor类继承了Sprite模板，并仅修改了spirte贴图属性：

Begin Object Name=Sprite
   Sprite=Texture2D‘EngineResources.S_SkyLight‘
End Object

动态地创建组件

要想动态地创建组建的实例，请使用UnrealScript的new操作符，并调用actor 的AttachComponent方法来把新的组件附加到actor 上。

New操作符的参数是在其中创建组件的外部容器对象；这应该是组件要附加到的actor。这样确保了组件的Outer(外部容器)引用不会再没有对要附加到的actor上进行垃圾回收之前不必要地阻止对另一个actor进行垃圾回收。

local StaticMeshComponent NewComponent;
NewComponent = new(self) class‘StaticMeshComponent‘;
// 在这里设置静态网格物体组件的属性。
AttachComponent(NewComponent);

要想分离或释放您先前附加的组件，请使用actor的DetachComponent方法。一旦到这个组件的引用不存在了，那么将会对它进行垃圾回收。

一般的PrimitiveComponent(图元组件)选项

Actor 碰撞和PrimitiveComponents(图元组件)

对于附加到actor 上的所有碰撞PrimitiveComponents(图元组件)都要执行碰撞测试，但是当actor移动时，它将仅对一个单独的PrimitiveComponent(图元组件)执行测试。这个PrimitiveComponent通过设置Actor属性 CollisionComponent 指向用于actor运动的碰撞检测的组件来选择。当actor移动时，它将会获取CollisionComponent所引用的组件的包围盒，然后使用它对所有的碰撞PrimitiveComponents进行检测。

内置的组件类型

• PrimitiveComponent(图元组件)
  • ArrowComponent(箭头组件)
  • CameraConeComponent(相机锥体组件)
  • CylinderComponent(圆柱体组件)
  • DrawFrustumComponent(描画平截头体组件)
  • MeshComponent(网格物体组件)
    • StaticMeshComponent(静态网格物体组件)
    • SkeletalMeshComponent(骨架网格物体专组件)
  • ParticleSystemComponent(粒子系统组件)
  • SpriteComponent(平面粒子组件)
• LightComponent(光源组件)
  • DirectionalLightComponent(直接光源组件)
  • PointLightComponent(点光源组件)
    • SpotLightComponent(聚光源组件)
  • SkyLightComponent(天空光源组件)
• AudioComponent(音频组件)
• HeightFogComponent(高空雾组件)
• SceneCaptureComponent(场景截图组件)
  • SceneCapture2DComponent(场景截图2D组件)
  • SceneCaptureCubeMapComponent(场景截图贴图组件)
  • SceneCaptureParaboloidComponent(场景截图抛物面组件)
  • SceneCaptureReflectComponent(场景截图反射组件)

创建新的组件类型

要想实现新的组件类型，您可以重写这些ActorComponent函数来处理附加、分离和移动。

SetParentToWorld

无论何时当要附加到的组件发生改变时调用这个 UActorComponent::SetParentToWorld 函数。将总是有一个到Attach 或UpdateTransform的调用函数跟随它。

Attach

当最初附加组件时调用这个UActorComponent::Attach函数。它将总是设置了UActorComponent::Scene或调用了SetParentToWorld后被调用。另外，如果UActorComponent::IsValidComponent返回false，它将永远不会被调用。

UpdateTransform

无论何时当发生要附加到的组件移动的变换时调用UActorComponent::UpdateTransform。它将总是在调用SetParentToWorld之前进行处理，并且将永远不会在没有附加的组件上调用这个函数。

Detach

U当分离组件时调用UActorComponent::Detach。将永远不会在没有附加的组件上调用这个函数

IsValidComponent

可以重写 UActorComponent::IsValidComponent函数来在组件属性上执行额外的参数验证。如果返回值为false，那么将不会附加组件。

其它注意事项

附加

先前，在虚幻引擎2中可以把Actors附加到骨架网格物体的骨骼上。但虚幻引擎3仅允许把Actor组件附加到骨架网格物体骨骼上。

对于附加来说，不是指把组件添加到Components(组件)数组中，而是向SkeletalMeshComponent的默认属性汇总的Attachments数组中添加一个元素。可替换地，可以像组件中添加一个实例化的引用，然后在脚本中使用SkeletalMeshComponent的AttachComponent和DetachComponent函数来附加组件。

垃圾回收

一般， 被销毁的 Actors会被添加到一个列表中。它周期性地(基于ini选项TimeBetweenPurgingPendingKillObjects) 清除到列表中的actors的引用，释放actors并清空列表。

Actor Components(Actor组件)的删除是Actor垃圾回收的一个扩展。组件会随着它们的Actor的删除而删除。在删除组件之前将会清除从Actors到那些组件的引用。

请参照垃圾回收页面获得更多信息。

（转载）虚幻引擎3--Actor 组件