1. Epic GamesDeveloper
  3. 8. プレイヤーが持つ目標のアイテムを視覚化する

8. プレイヤーが持つ目標のアイテムを視覚化する

プレイヤーが持つ目標のアイテムを見つけやすくするビジュアルを作成します。

8. プレイヤーが持つ目標のアイテムを視覚化する
Prerequisite topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

Infiltrator の不可視性によって、Infiltrator が Defender の目標のアイテムを持っているときに興味深い問題が引き起こされます。 Defender は、自分が目標とするアイテムを基地に持ち帰ろうとしている可能性のある不可視のプレイヤーを、どのようにして見つけることができるのでしょうか？ この問題を解決するために、何らかのビジュアル エイド、この例では小道具を使って、Infiltrator の居場所を Defender に示すことができます。

以下の手順では、プレイヤーが目標のアイテムを持っているときに、プレイヤーの頭上に浮かぶオブジェクトを作成する方法を示します。

Item Capture Manager を作成する

  1. item_capture_manager という名前の新しい Verse の仕掛けを Verse Explorer で作成し、その仕掛けをレベルにドラッグします。
  2. item_capture_manager ファイルの冒頭に次を追加します。
    1. using { /UnrealEngine.com/Temporary/SpatialMath} を追加して vector3 構造体にアクセスします。これを使用して、プレイヤーの頭上に浮かぶインジケータをどこにテレポートするかを取得します。using { /Fortnite.com/Characters}も追加して、プレイヤーの fort_character にアクセスします。 
       using { /Fortnite.com/Devices}
 using { /Verse.org/Simulation}
 using { /Fortnite.com/Characters}
 using { /UnrealEngine.com/Temporary/Diagnostics}
 using { /UnrealEngine.com/Temporary/SpatialMath}
  3. item_capture_manager クラス定義に以下のフィールドを追加します。
    1. CaptureItemSpawners という名前のキャプチャー アイテム スポナーの仕掛けの、編集可能な配列。この配列には、Infiltrator 用のキャプチャー アイテム スポナー仕掛けが保持されます。 
       item_capture_manager := class(creative_device):

     Logger:log = log{Channel := triad_item_capture_log_channel}

     # キャプチャーするためのアイテムをスポーンするアイテム スポナーをキャプチャーします。
     @editable
     CaptureItemSpawner:capture_item_spawner_device = capture_item_spawner_device{}
    2. CaptureItemIndicator という名前の編集可能なクリエイティブ小道具。これが、Infiltrator が目標のアイテムを手に入れたときに Infiltrator の頭上に浮かぶ小道具です。 
       # キャプチャーするためのアイテムをスポーンするアイテム スポナーをキャプチャーします。
 @editable
 CaptureItemSpawner:capture_item_spawner_device = capture_item_spawner_device{}
    
 # CaptureItemSpawner のアイテムを保持している場合に、プレイヤーの 
 # 頭上に浮かぶ小道具。
 @editable
 CaptureItemIndicator:creative_prop = creative_prop{}
    3. MapIndicator という名前の編集可能なマップ インジケータの仕掛け。これは、レベル内の CaptureItemSpawner の下に配置され、各チームの目標のアイテムがあるマップに表示されます。 
       # CaptureItemSpawner のアイテムを保持している場合に、プレイヤーの 
 # 頭上に浮かぶ小道具。
 @editable
 CaptureItemIndicator:creative_prop = creative_prop{}

 # 各チームの目標のアイテムがあるマップに表示されるインジケータ
 @editable
 MapIndicator:map_indicator_device = map_indicator_device{}
    4. UpdateRateSeconds と VerticalOffset の 2 つの編集可能な浮動小数値。1 つ目は CaptureItemIndicator の位置がどれくらいすばやく変化するかを制御し、2 つ目は CaptureItemIndicator がプレイヤーの頭からどれくらい離れて浮かぶかを制御します。 
       # 各チームの目標のアイテムがあるマップに表示されるインジケータ
 @editable
 MapIndicator:map_indicator_device = map_indicator_device{}

 # CaptureItemIndicator がその位置を更新する頻度。
 @editable
 UpdateRateSeconds:float = 0.15

 # CaptureItemIndicator がプレイヤーの頭上を浮かぶ高さ。
 @editable
 VerticalOffset:float = 180.0
    5. ItemGrabbedMessageDevice という名前の編集可能な HUD メッセージの仕掛け。目標のアイテムがピックアップされた場合に、各プレイヤーにメッセージを送信します。 
       # CaptureItemIndicator がプレイヤーの頭上を浮かぶ高さ。
 @editable
 VerticalOffset:float = 180.0

 # プレイヤーがキャプチャー アイテムを取得すると、メッセージを表示します。
 @editable
 ItemGrabbedMessageDevice:hud_message_device = hud_message_device{}
    6. ScoreManagerDevice という名前の編集可能なスコア マネージャーの仕掛け。プレイヤーが目標のアイテムをキャプチャーすると、チームにスコアを付与します。 
       # プレイヤーがキャプチャー アイテムを取得すると、メッセージを表示します。
 @editable
 ItemGrabbedMessageDevice:hud_message_device = hud_message_device{}
    
 # プレイヤーがキャプチャー アイテムを取得すると、スコアを付与します。
 @editable
 ScoreManagerDevice:score_manager_device = score_manager_device{}
    7. ReturnTime という名前の編集可能な浮動小数値。CaptureItemSpawner に戻す前の時間がキャプチャー アイテムにある場合、インジケータを CaptureItemSpawner に戻すタイミングを把握するため、その戻す時間の長さをトラックする必要があります。
  4. 新しい FollowCharacter() メソッドを item_capture_manager クラス定義に追加します。このメソッドは fort_character を受け取り、プレイヤーの頭上に浮かぶインジケータを使ってそれらをトラックします。この関数に <suspends> 指定子を追加します。プレイヤーが目標のアイテムを持っているときにいつでも、これらのいずれかをスポーンできるようにするためです。 
     # CaptureItemIndicator がプレイヤーの頭上を継続的に追跡するようにします。
 # CaptureItemIndictator の更新ループ、およびプレイヤーがアイテムをキャプチャするか、
 # ドロップするか、撃破されるかの間でレースを行います。
 FollowCharacter(FortCharacter:fort_character)<suspends>:void=
     Logger.Print("Spawned FollowCharacter function")

目標のアイテムを持ちながらレースを続ける

プレイヤーが目標のアイテムを手に入れたときにどうなるかを考えることが重要です。 プレイヤーは以下の行動を取ることができます。

  • 動き回る。この場合は、CaptureItem およびマップ インジケータをプレイヤーの位置に継続的に更新する必要があります。これはループで処理できます。
  • 目標のアイテムをキャプチャする。この場合は、インジケータが視界外のどこかの CaptureItemSpawner に戻されるようにする必要があります。このインジケータは、プレイヤーがキャプチャー アイテムを持たない限り可視にはならないためです。
  • 目標のアイテムをドロップするか、撃破される。この場合、インジケータはアイテムがドロップされた場所に置かれたままになり、キャプチャー アイテムが戻される際に CaptureItemSpawner に戻されます。

これを実現するために race 式 を設定します。これらの 3 つの条件の間で race を使用することで、プレイヤーが目標のアイテムをドロップまたはキャプチャーするまで待機しながら、インジケータの位置を継続的に更新できます。

  1. FollowCharacter() に race 式を追加します。 CaptureItemSpawner の ItemCapturedEvent の Await()、CaptureItemSpawner の ItemCapturedDroppedEvent の Await()、および FortCharacter の EliminatedEvent() の Await() という loop の間で実行されるように race を設定します。 
     FollowCharacter(FortCharacter:fort_character)<suspends>:void=
     Logger.Print("Spawned FollowCharacter function")
     race:
         loop:
         CaptureItemSpawner.ItemCapturedEvent.Await()
         CaptureItemSpawner.ItemDroppedEvent.Await()
         FortCharacter.EliminatedEvent().Await()
  2. loop 内で、FortCharacter の位置を取得して、それを Transform 変数に保存します。 
     loop:
     Transform := FortCharacter.GetTransform()
  3. 次に、MoveTo() をスポーンし、前に設定した VerticalOffset を Transform の 平行移動と回転に加えた位置に、CaptureItemIndicator と MapIndicator の両方を、UpdateRateSeconds の時間数だけ移動させます。Spawn{} の両方の MoveTo() 関数を実行します。互いの式が完了するまで待機するのではなく、CaptureItemIndicator と MapIndicator の両方を正確に同じタイミングで移動させる必要があるためです。平行移動は X、Y、Z の座標から成る vector3 であるため、VerticalOffset を新しい vector3 内で加える必要があります。VerticalOffset はプレイヤーの頭上での垂直方向の距離であるため、それを vector3 の Z 値として設定します。 
    loop:
     Transform := FortCharacter.GetTransform()
     spawn{CaptureItemIndicator.MoveTo(Transform.Translation + vector3{Z := VerticalOffset}, Transform.Rotation, UpdateRateSeconds)}
     spawn{MapIndicator.MoveTo(Transform.Translation + vector3{Z := VerticalOffset}, Transform.Rotation, UpdateRateSeconds)}
  4. 最後に、0.0 秒間のスリープを行います。これにより、シミュレーションの更新 ごとに一度だけループが実行され、スポーンを行う MoveTo() 関数が制御ができなくならないようにします。FollowCharacter() コードは次のようになります。 
     # CaptureItemIndicator がプレイヤーの頭上を継続的に追跡するようにします。
 # CaptureItemIndictator の更新ループ、およびプレイヤーがアイテムをキャプチャするか、
 # ドロップするか、撃破されるかの間でレースを行います。
 FollowCharacter(FortCharacter:fort_character)<suspends>:void=
     Logger.Print("Spawned FollowCharacter function")
     race:
         loop:
             Transform := FortCharacter.GetTransform()
             spawn{CaptureItemIndicator.MoveTo(Transform.Translation + vector3{Z := VerticalOffset}, Transform.Rotation, UpdateRateSeconds)}
             spawn{MapIndicator.MoveTo(Transform.Translation + vector3{Z := VerticalOffset}, Transform.Rotation, UpdateRateSeconds)}
             # このループは、シミュレーションの更新ごとに一度だけループが実行されるようにするため、ゲーム ティック 1 つ分だけスリープを行います。
             Sleep(0.0)
         CaptureItemSpawner.ItemCapturedEvent.Await()
         CaptureItemSpawner.ItemDroppedEvent.Await()
         FortCharacter.EliminatedEvent().Await()
     Logger.Print("Objective dropped or captured")

    インジケータをリセットする

  5. キャプチャー アイテムがキャプチャーまたは戻された場合、インジケータを視界外のどこかの CaptureItemSpawner に戻す必要があります。その場合、CaptureItemSpawner の上の高い位置にテレポートさせます。これを行うには、ReturnIndicators() という名前の関数を item_capture_manager クラス定義に追加します。 
     # マップおよびキャプチャー アイテム インジケータをスポナーの上の初期位置に戻します。
 ReturnIndicators(InAgent:agent):void=
  6. CaptureItemSpawner のトランスフォームを取得し、それを SpawnerTransform 変数に保存します。次に、CaptureItemIndicator および MapIndicator の MoveTo() をスポーンし、CaptureItemSpawner の平行移動と回転に VerticalOffset を加えた位置に移動します (loop で CaptuerItemSpawnwer の上にこれらを配置したのと同様)。小道具を視界外の遠い位置に置きたい場合は、VerticalOffset を大きな数 (たとえば「10」) で乗算できます完成した ReturnIndicators() メソッドは次のようになるはずです。 
    # マップおよびキャプチャー アイテム インジケータをスポナーの上の初期位置に戻します。
ReturnIndicators():void=
 SpawnerTransform := CaptureItemSpawner.GetTransform()
 # テレポートしてスポナーに戻り、CaptureItemIndicator および MapIndicator はマップの上の視野外で非表示にします。
 spawn{CaptureItemIndicator.MoveTo(SpawnerTransform.Translation + vector3{Z := VerticalOffset * 10.0}, SpawnerTransform.Rotation, UpdateRateSeconds)}
 spawn{MapIndicator.MoveTo(SpawnerTransform.Translation + vector3{Z := VerticalOffset * 10.0}, SpawnerTransform.Rotation, UpdateRateSeconds)}
 Logger.Print("Returned Indicators to capture spawner")

プレイヤーによる目標のアイテムの取得、ドロップ、およびキャプチャーを処理する

  1. 新しい OnItemPickedUp() メソッドを item_capture_manager クラス定義に追加します。このメソッドは agent を受け取り、そのキャラクターの FollowCharacter() のインスタンスをスポーンします。 
     # プレイヤーが目標のアイテムを取得すると、各プレイヤーに信号を送信します
 OnItemPickedUp(InAgent:agent):void=
     Logger.Print("Objective Grabbed")
  2. InAgent の FortCharacter を取得して、その FortCharacter を使って FollowCharacter() 関数をスポーンします。完成した OnItemPickedUp() メソッドは次のようになるはずです。 
     # プレイヤーが目標のアイテムを取得すると、各プレイヤーに信号を送信します
 OnItemPickedUp(InAgent:agent):void=
     Logger.Print("Objective Grabbed")
     if(FortCharacter := InAgent.GetFortCharacter[]):
         ItemGrabbedMessageDevice.Show()
         spawn{FollowCharacter(FortCharacter)}
  3. 新しい OnItemCaptured() メソッドを item_capture_manager クラス定義に追加します。このメソッドは、目標のアイテムを取得した agent を取得します。 
     # アイテムがキャプチャーされると、キャプチャーしているチームにスコアが付与され、インジケータを戻します。
 OnItemCaptured(CapturingAgent:agent):void=
     Logger.Print("Objective Captured")
  4. OnItemCaptured() で、ScoreManagerDevice を有効にしてキャプチャーしているプレイヤーのチームのスコアを付与し、ReturnIndicators() を呼び出してインジケータを戻します。 
     # アイテムがキャプチャーされると、キャプチャーしているチームにスコアが付与され、インジケータを戻します。
 OnItemCaptured(CapturingAgent:agent):void=
     Logger.Print("Objective Captured")
     ScoreManagerDevice.Activate()
     ReturnIndicators()
  5. 新しい OnItemDropped() メソッドを item_capture_manager クラス定義に追加します。このメソッドは、アイテムをドロップした agent を取得します。 
     # プレイヤーがアイテムをドロップすると、ReturnTime が 0 より大きい場合に
 # WaitForReturn() 関数をスポーンします。
 OnItemDropped(InAgent:agent):void=
     Logger.Print("Objective Dropped")
  6. 目標のアイテムがドロップされた場合、インジケータは、目標のアイテムがピックアップされるか、CaptureItemSpawner に戻るまで目標のアイテム付近にとどまる必要があります。インジケーターが戻るタイミングを把握するには、先ほど設定した ReturnTime 変数を使用します。ReturnTime が 0.0 に等しい場合は、その時間数だけ待機してから、インジケーターを戻します。ReturnTime が負の数の場合、目標のアイテムは戻る時間がないため、インジケーターを動かす必要はありません。インジケータを動かして戻す場合は、次のステップで定義する、WaitForReturn() という名前の新しいヘルパー関数をスポーンします。 
     # プレイヤーがアイテムをドロップすると、ReturnTime が 0 より大きい場合に
 # WaitForReturn() 関数をスポーンします。
 OnItemDropped(InAgent:agent):void=
     Logger.Print("Objective Dropped")
     if(ReturnTime >= 0.0):
         spawn{WaitForReturn()}
     else:
         Logger.Print("The dropped objective does not return")
  7. 新しい WaitForReturn() メソッドを item_capture_manager クラス定義に追加します。この関数は、ReturnTime の時間数だけ待機し、待機が完了する前に目標のアイテムがピックアップされなかった場合にアイテムを戻します。このメソッドに <suspends> モディファイアを追加し、Sleep() の実行を許可します。 
     # ReturnTime の時間数だけ待機し、インジケータを戻します。
 WaitForReturn()<suspends>:void=
     Logger.Print("Waiting to return the indicators...")
  8. インジケータを戻す必要があるか、または ReturnTime が終了する前に目標のアイテムがピックアップされることに依存しないか。ピックアップされた場合、インジケーターは即座にプレイヤーに戻されてしまって不自然なビジュアルになるため、戻さないようにします。これを解決するため、値がレースの結果に等しいロジック変数を使用します。 
     # ReturnTime の時間数だけ待機し、インジケータを戻します。
 WaitForReturn()<suspends>:void=
     Logger.Print("Waiting to return the indicators...")
     # 時間切れになる前にキャプチャー アイテムがピックアップされなかった場合、
     # CaptureItem とマップ インジケータを戻します。
     ShouldReturn:logic := race:
  9. WaitForReturn() 関数は、2 つの条件の間でレースを行う必要があります。ReturnTime がなくなり、目標のアイテムが CaptureItemSpawner に戻った場合、インジケータを戻す必要があり、ShouldReturn は true になる必要があります。または、ReturnTime の期限が切れる前に目標のアイテムがピックアップされた場合、ShouldReturn は false になる必要があります。これらの各条件が値を返すため、2 つの異なる blocks を使用してレースを実行します。 
     ShouldReturn:logic := race:
     block:
     block:
  10. 最初のブロックでは、ReturnTime の時間数の間だけ Sleep() を呼び出し、true を返します。2 番目のブロックでは、CaptureItemSpawner.ItemPickedUpEvent に対して Await() を実行し、false を返します。これで、ShouldReturn 変数は、これらのいずれかが完了すると初期化されます。 
     ShouldReturn:logic := race:
     block:
         Sleep(ReturnTime)
         true
     block:
         CaptureItemSpawner.ItemPickedUpEvent.Await()
         false
  11. ShouldReturn が true の場合、インジケータを戻す必要があります。ShouldReturn が true と評価された場合、ReturnIndicators() を呼び出します。完了した WaitForReturn() コードは、次のようになるはずです。 
     # ReturnTime の時間数だけ待機し、インジケータを戻します。
 WaitForReturn()<suspends>:void=
     Logger.Print("Waiting to return the indicators...")
     # 時間切れになる前にキャプチャー アイテムがピックアップされなかった場合、
     # CaptureItem とマップ インジケータを戻します。
     ShouldReturn:logic := race:
         block:
             Sleep(ReturnTime)
             true
         block:
             CaptureItemSpawner.ItemPickedUpEvent.Await()
             false
        
     if(ShouldReturn?):
         ReturnIndicators()
  12. 次に OnBegin() で、CaptureItemSpawner の ItemPickedUpEvent を OnItemPickedUp() に、ItemCapturedEvent を OnItemCaptured() に、および ItemDroppedEvent を OnItemDropped() にサブスクライブします。 
     OnBegin<override>()<suspends>:void=
     CaptureItemSpawner.ItemPickedUpEvent.Subscribe(OnItemPickedUp)
     CaptureItemSpawner.ItemCapturedEvent.Subscribe(OnItemCaptured)
     CaptureItemSpawner.ItemDroppedEvent.Subscribe(OnItemDropped)
     SpawnerTransform := CaptureItemSpawner.GetTransform()
  13. 最後に、OnBegin() 内で、CaptureItemIndicator および MapIndicator で MoveTo() を呼び出すことでスクリプトが実行された場合、開始位置にインジケータを配置します。OnBegin() コードは次のようになります。 
     OnBegin<override>()<suspends>:void=
     CaptureItemSpawner.ItemPickedUpEvent.Subscribe(OnItemPickedUp)
     CaptureItemSpawner.ItemCapturedEvent.Subscribe(OnItemCaptured)
     CaptureItemSpawner.ItemDroppedEvent.Subscribe(OnItemDropped)
     SpawnerTransform := CaptureItemSpawner.GetTransform()
        
     # テレポートしてスポナーに戻り、CaptureItemIndicator をマップの下の視野外で非表示にします。
     CaptureItemIndicator.MoveTo(SpawnerTransform.Translation + vector3{Z := VerticalOffset * 10.0}, SpawnerTransform.Rotation, UpdateRateSeconds)
     MapIndicator.MoveTo(SpawnerTransform.Translation + vector3{Z := VerticalOffset * 10.0}, SpawnerTransform.Rotation, UpdateRateSeconds)

  14. エディタに戻り、スクリプトを保存してビルドし、その仕掛けをレベル内にドラッグします。CaptureItemIndicator として使用する適切な小道具を選択して、レベル内に取り込みます。この小道具は、明確に目に見えるものであれば何でもかまいません。この例では「Diamond (ダイヤモンド)」を使用します。[Details (詳細)] パネルで、CaptureItemSpawner を InfiltratorCaptureSpawner に、CaptureItemIndicator を選択した小道具に割り当てます。また、MapIndicator を Infiltrator のマップ インジケーターに、ItemGrabbedMessageDevice を Infiltrator の HUD メッセージの仕掛けに、および ScoreManagerDevice を Infiltrator のスコア マネージャーに割り当てます。ReturnTime を負の数に設定します。Infiltrator のキャプチャー アイテムは戻されないためです。

    Attacker 用に item_capture_manager のインスタンスを設定する必要もあります。CaptureItemIndicator を Infiltrator の小道具とは異なる小道具に変更して、チームが混乱しないようにしてください。また、その他すべての仕掛けを割り当ててください。ReturnTime を正の数に設定します。Attacker のキャプチャー アイテムは設定された時間後に戻るからです。
  15. UEFN ツールバーの [Launch Session (セッションを起動)] をクリックし、レベルをプレイテストします。レベルをプレイテストすると、プレイヤーが目標のアイテムを持った際に、その頭上に小道具が現れるはずです。この小道具はプレイヤーとともに移動し、プレイヤーが目標のアイテムをドロップまたはキャプチャーすると、テレポートしてキャプチャー アイテム スポナーに戻ります。
Visualize Objective

次のステップ

このチュートリアルの 次のステップ では、ゲーム内で何をすべきかをプレイヤーにすばやく伝える方法と、プレイヤー体験を向上させる際に何に重点を置くべきかについて説明します。

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page