Variant Manager の設定をスクリプティングする

シーン バリアントの設定に最も重要なノードは [Blueprint] パレットの Variant Manager カテゴリにあります。このカテゴリのノードによって、新しい Level Variant Sets アセットを作成してバリアント セットとバリアントをアセットに追加し、アクタをバリアントにバインドして、これらのアクタのプロパティ値をキャプチャすることができます。

以下は、最も頻繁に使うノードのいくつかを説明しています。

	Create Level Variant Sets Asset	コンテンツ ブラウザで、名前とパスを指定して新しい空の Level Variant Sets アセットを作成します。プロジェクトのコンテンツ フォルダに新しいアセットを保存するために、パスが常に /Game/ で始まるようにしてください。
	Add Variant Set	指定したバリアント セットを Level Variant Sets アセットに追加します。これは、Variant Manager の画面で [+ Variant Set (バリアント セットを追加)] ボタンをクリックするのと同等の処理です。ゼロから新しいVariant Set を作成する方法は以下のヒントを参照してください。
	Add Actor Binding	指定したアクタを指定したバリアントに追加します。これは、アクタを [World Outliner (アウトライナ)] からドラッグして Variant Manager 画面のバリアントにドロップする操作と同等の処理です。
	Get Capturable Properties	特定のアクタに対して Variant Manager で制御可能なすべてのプロパティの名前を返します。Capture Property ノード の呼び出し時には、これらの値のいずれも使用することができます。
	Capture Property	特定のバリアントでアクタに対して指定したプロパティの値を保存します。
	Add Variant	指定したバリアントを特定のバリアント セットの子として追加します。

ブループリントの例

以下のエディタ ユーティリティ ウィジェットのグラフでは、 Variant Manager がプログラム的にどうのように設定されているのかを示しています。まず、作業するための新しい Actor ブループリントを作成します。次に新しい Level Variant Sets Asset を作成し、新しい Variant Set を使ってそれを設定します。最後に、2 つの Variant をその Variant Set に追加します。1 てゃアクタが視覚化され、もう 1 つはアクタが非表示となります。

この例を実行すると、レベルの元のポイントにキューブが作成されています。また、Variant を切り替えることでそのキューブの表示/非表示を可能にする新しい Level Variant Sets Asset ができています。

シーン バリアントの設定に最も重要なクラスは unreal.VariantManagerLibrary です。このクラスによって、新しい Level Variant Sets アセットを作成してバリアント セットとバリアントをアセットに追加し、アクタをバリアントにバインドして、これらのアクタのプロパティ値をキャプチャすることができます。

以下の表には、頻繁に使用する関数が示されています。これらの関数の詳細と、VariantManagerLibrary によって提供される他の関数については、「Python API リファレンス」 を参照してください。

Python の例

次の例では、まったく新しい状態の Level Variant Sets アセットを設定する方法を示しています。

最初にキューブと球体で構成されたシーンを設定し、次にこれらのアクタの位置と可視性を変更するよう Variant Manager を設定します。

    import math
    import unreal

    # スクリプトのこのセクションでは、10 個の親アクタを含む基本的なオープニング シーンを設定します。
    # それぞれの親アクタのシーン階層には、キューブと球体の 2 つの子アクタが含まれています。
    sphere_mesh = unreal.EditorAssetLibrary.load_asset('/Engine/BasicShapes/Sphere')
    cube_mesh = unreal.EditorAssetLibrary.load_asset('/Engine/BasicShapes/Cube')

    parent_actors = []
    sphere_actors = []
    cube_actors = []
    for i in range(0,10):
        parent_actor = unreal.EditorLevelLibrary.spawn_actor_from_class(unreal.StaticMeshActor, unreal.Vector(0, 0, 0), unreal.Rotator(0, 0, 0))
        parent_actor.root_component.set_editor_property("mobility", unreal.ComponentMobility.MOVABLE)
        parent_actor.set_actor_label("actor_" + str(i).zfill(3))
        sphere_actor = unreal.EditorLevelLibrary.spawn_actor_from_class(unreal.StaticMeshActor, unreal.Vector(0, 0, 0), unreal.Rotator(0, 0, 0))
        sphere_actor.static_mesh_component.set_static_mesh(sphere_mesh)
        sphere_actor.root_component.set_editor_property("mobility", unreal.ComponentMobility.MOVABLE)
        sphere_actor.attach_to_actor(parent_actor, unreal.Name(), unreal.AttachmentRule.KEEP_WORLD, unreal.AttachmentRule.KEEP_WORLD, unreal.AttachmentRule.KEEP_WORLD, False)
        sphere_actor.set_actor_label("sphere_" + str(i).zfill(3))
        cube_actor = unreal.EditorLevelLibrary.spawn_actor_from_class(unreal.StaticMeshActor, unreal.Vector(0, 0, 0), unreal.Rotator(0, 0, 0))
        cube_actor.static_mesh_component.set_static_mesh(cube_mesh)
        cube_actor.root_component.set_editor_property("mobility", unreal.ComponentMobility.MOVABLE)
        cube_actor.attach_to_component(parent_actor.root_component, unreal.Name(), unreal.AttachmentRule.KEEP_WORLD, unreal.AttachmentRule.KEEP_WORLD, unreal.AttachmentRule.KEEP_WORLD, False)
        cube_actor.set_actor_label("cube_" + str(i).zfill(3))
        parent_actors.append(parent_actor)
        sphere_actors.append(sphere_actor)
        cube_actors.append(cube_actor)

    # Create a Level Variant Set Asset with the specified name and path in the Content Browser.
    # The path should always begin with /Game/.
    lvs = unreal.VariantManagerLibrary.create_level_variant_sets_asset('ProceduralVariants', '/Game')

    # Create a new Variant Set to manage position variants.
    position_variant_set = unreal.VariantSet()
    position_variant_set.set_display_text('Position')
    # Add the empty Variant Set to the Level Variant Sets Asset.
    unreal.VariantManagerLibrary.add_variant_set(lvs, position_variant_set)

    # This section sets up a new Variant that will position the parent Actors in a line.
    # First, create the Variant.
    position_variant_0 = unreal.Variant()
    position_variant_0.set_display_text('Line')
    # For each parent Actor...
    for i, actor in enumerate(parent_actors):
        # Position the Actor in line along the X axis.
        actor.set_actor_location_and_rotation(unreal.Vector(i*200, 0, 0), unreal.Rotator(0, 0, 0), False, True)
        # Bind the Actor to the Variant.
        unreal.VariantManagerLibrary.add_actor_binding(position_variant_0, actor)
        # Capture the relative location and rotation properties of the Actor's Static Mesh Component, and store their current values.
        unreal.VariantManagerLibrary.capture_property(position_variant_0, actor, 'Static Mesh Component / Relative Location')
        unreal.VariantManagerLibrary.capture_property(position_variant_0, actor, 'Static Mesh Component / Relative Rotation')
    # Now that the Variant is set up, add it to the Variant Set.
    unreal.VariantManagerLibrary.add_variant(position_variant_set, position_variant_0)

    # This section follows the same process to set up a second Variant,
    # but this time it positions the parent Actors in a circle rather than a line.
    position_variant_1 = unreal.Variant()
    position_variant_1.set_display_text('Circle')
    for i, actor in enumerate(parent_actors):
        actor.set_actor_location_and_rotation(unreal.Vector(1000*math.cos(i*360.0/(len(parent_actors)-1)), 1000*math.sin(i*360.0/(len(parent_actors)-1)), 0), unreal.Rotator(0, 0, 0), False, True)
        unreal.VariantManagerLibrary.add_actor_binding(position_variant_1, actor)
        unreal.VariantManagerLibrary.capture_property(position_variant_1, actor, 'Static Mesh Component / Relative Location')
        unreal.VariantManagerLibrary.capture_property(position_variant_1, actor, 'Static Mesh Component / Relative Rotation')
    unreal.VariantManagerLibrary.add_variant(position_variant_set, position_variant_1)

    # Create a new Variant Set to manage showing and hiding Actors with different shapes.
    shape_variant_set = unreal.VariantSet()
    shape_variant_set.set_display_text('Shape')
    unreal.VariantManagerLibrary.add_variant_set(lvs, shape_variant_set)

    # Create two Variants: one that shows the spheres and hides the cubes, and the other
    # that shows the cubes and hides the spheres.
    shape_variant_0 = unreal.Variant()
    shape_variant_0.set_display_text('Sphere')
    shape_variant_1 = unreal.Variant()
    shape_variant_1.set_display_text('Cube')
    # Bind each sphere Actor to the two Variants, and capture the Visible property of its Static Mesh Component.
    for i, actor in enumerate(sphere_actors):
        actor.root_component.set_visibility(True)
        unreal.VariantManagerLibrary.add_actor_binding(shape_variant_0, actor)
        unreal.VariantManagerLibrary.capture_property(shape_variant_0, actor, 'Static Mesh Component / Visible')
        actor.root_component.set_visibility(False)
        unreal.VariantManagerLibrary.add_actor_binding(shape_variant_1, actor)
        unreal.VariantManagerLibrary.capture_property(shape_variant_1, actor, 'Static Mesh Component / Visible')
    # Bind each sphere Actor to the two Variants, and capture the Visible property of its Static Mesh Component,
    # but save the opposite visibility values from the sphere Actors above.
    for i, actor in enumerate(cube_actors):
        actor.root_component.set_visibility(False)
        unreal.VariantManagerLibrary.add_actor_binding(shape_variant_0, actor)
        unreal.VariantManagerLibrary.capture_property(shape_variant_0, actor, 'Static Mesh Component / Visible')
        actor.root_component.set_visibility(True)
        unreal.VariantManagerLibrary.add_actor_binding(shape_variant_1, actor)
        unreal.VariantManagerLibrary.capture_property(shape_variant_1, actor, 'Static Mesh Component / Visible')
    # Finally, add the two Variants to the Variant Set.
    unreal.VariantManagerLibrary.add_variant(shape_variant_set, shape_variant_0)
    unreal.VariantManagerLibrary.add_variant(shape_variant_set, shape_variant_1) 

    # Add the Level Variants Sets Asset to the current Level, so that you can use it from Blueprints at runtime.
    lvs_actor = unreal.VariantManagerLibrary.create_level_variant_sets_actor(lvs)

Copy full snippet

その結果、それぞれ 2 つのバリアントのあるバリアント セットが 2 つできます。

• 1 つめのバリアント セットは、直線または円の中にアクタを入れるために、3D 空間の中でアクタの位置を切り替えます。

• 1 つめのバリアント セットは、キューブ メッシュと球体メッシュの間でアクタを入れ替えます。