イベント

イベントグラフ内の個々のネットワークの実行を開始するためにゲームプレイ コードから呼び出されるノードについて説明します

Choose your operating system:

Windows

macOS

Linux

イベント は、 EventGraph 内の個々のネットワークの実行を開始するために ゲームプレイ コードから呼び出されるノードです。これらにより、ブループリントは、ゲームの開始、レベルのリセット、 ダメージなどのゲーム内で生じる一定のイベントに反応して一連のアクションを実行できるようになります。

イベントにはブループリント内でアクセスして、新規機能を実装したり、デフォルト機能をオーバーライドまたは補強したりできます。1 つの EventGraph 内で イベント をいくつでも使用できますが、それぞれの種類から 1 つずつしか使用できません。

1 つのイベントが実行できるオブジェクトは 1 つです。1 つのイベントから複数のアクションをトリガーしたい場合、それらをまとめて線形に並べる必要があります。

Blueprint Class Events Expanded Level Blueprint Events Expanded

Event Level Reset

この Blueprint Event ノードは Level ブループリントのみで使用できます。

この Blueprint Event ノードはサーバー上でのみ実行します。シングル プレイヤー ゲームの場合、クライアントがサーバーと見なされます。

LevelReset.png

LevelReset イベントはレベルの再起動時に実行シグナルを送ります。プレイヤーが消滅するとレベルをリロードする必要がないようなゲームの状態など、 レベルがリロードされると 何かをトリガーする必要のある場合に便利です。

LevelReset_Example.png

Event Actor Begin Overlap

BeginOverlap.png

いくつもの条件が同時に一致すると、このイベントが実行されます。

  • アクタ間のコリジョン反応がオーバーラップできること。

  • イベントを実行するアクタは両方とも Generate Overlap Events が true に設定されていること。

  • 最後に、両方のアクタのコリジョンがオーバーラップを開始します。一緒に動くか、一方が他方にオーバーラップするように作成されます。

コリジョンの詳細については、「 コリジョン反応 」を参照してください。

BeginOverlapEX.png

このブループリント アクタが Player Actor 変数に格納されているアクタとオーバーラップすると、整数型のカウンタ変数をインクリメントします。

項目

説明

出力ピン

Other Actor

このブループリントにオーバーラップするアクタです。

Event Actor End Overlap

EndOverlap.png

いくつもの条件が同時に一致すると、このイベントが実行されます。

  • アクタ間のコリジョン反応がオーバーラップできること。

  • イベントを実行するアクタは両方とも Generate Overlap Events が true に設定されていること。

  • そして、両方のアクタのコリジョンがバラバラに動くか、一方が破壊されて、オーバーラップを停止すること。

コリジョンの詳細については、「 コリジョン反応 」を参照してください。

EndOverlapEX.png

このブループリント アクタが Player Actor 変数に格納されているアクタ以外のアクタとのオーバーラップを停止すると、オーバーラップされていた側のアクタを破壊します。

項目

説明

出力ピン

Other Actor

Actor - このブループリントにオーバーラップするアクタです。

Event Hit

EventHit.png

このイベントは、コリジョンに関わアクタの片方のコリジョン設定の Simulation Generates Hit Events が true である限り実行されます。

Sweeps を使って移動する場合、フラグを選択していなくてもこのイベントを使います。Sweep がブロックしているオブジェクトを通り過ぎないようにしている限り、そのようになります。

項目

説明

出力ピン

My Comp

PrimitiveComponent - ヒットされた実行中のアクタ上のコンポーネント。

Other

Actor - コリジョンに関わるもう一方のアクタ。

Other Comp

PrimitiveComponent - ヒットされたコリジョンに関わるもう一方のアクタ上のコンポーネント。

Self Moved

Boolean - 別のオブジェクトの移動からヒットを受けた際に使用し (false の場合)、Hit Normal と Hit Impact を調整して、ヒット対象となったオブジェクトに対するもう一方のオブジェクトからの力を示します。

Hit Location

Vector - 衝突する 2 つのアクタ間のコンタクト位置。

Hit Normal

Vector - コリジョンの方向です。

Normal Impulse

Vector - アクタが衝突する力。

Hit

Struct Hit 内に収集されたすべてのデータである HitResult を引っ張り出し、この結果を「細分化して」個々のデータへのアクセスすることができます。

EventHitEX.png

Hit

Event Any Damage

この Blueprint Event ノードはサーバー上でのみ実行します。シングル プレイヤー ゲームの場合、クライアントがサーバーと見なされます。

AnyDamage.png

このイベントは、一般的なダメージを与えるべき時にパスされます。ポイント ダメージやラジアル ダメージとは全く違う、水死や環境的なダメージなどです。

項目

説明

出力ピン

Damage

Float - アクタへ渡されているダメージの量です。

Damage Type

Object 'DamageType - 与えられているダメージ上に追加データを含むオブジェクトです。

Instigated By

Actor - ダメージを仕掛けるアクタです。ダメージを与えるために銃を発砲したり手榴弾を投げたりするアクタになります。

Damage Causer

Actor - ダメージを引き起こすアクタです。弾丸や爆発などがこれにあたります。

アクタに与えられているダメージが水から発生した場合、ヘルス値が減算され画面に警告が表示されます。

Event Point Damage

この Blueprint Event ノードはサーバー上でのみ実行します。シングル プレイヤー ゲームの場合、クライアントがサーバーと見なされます。

PointDamage.png

Point Damage とは、発射物、即着弾武器、そして近接武器などのことをいいます。

項目

説明

出力ピン

Damage

Float - アクタへ渡されているダメージの量です。

Damage Type

Object 'DamageType - 与えられているダメージ上に追加データを含むオブジェクトです。

Hit Location

Vector - ダメージが適用されている位置です。

Hit Normal

Vector - コリジョンの方向です。

Hit Component

PrimitiveComponent - ヒットされた実行中のアクタ上のコンポーネントです。

Bone Name

Name - 撃たれたボーンの名前です。

Shot from Direction

Vector - ダメージが与えられた方向です。

Instigated By

Actor - ダメージを仕掛けるアクタです。ダメージを与えるために銃を発砲したり手榴弾を投げたりするアクタになります。

Damage Causer

Actor - ダメージを引き起こすアクタです。弾丸や爆発などがこれにあたります。

このサンプルでは、ダメージを受けた時、与えられたダメージがアクタのヘルス値から減算されますが、アクタの頭が撃たれた場合、アクタのヘルス値は -1 に設定されます。

Event Radial Damage

この Blueprint Event ノードはサーバー上でのみ実行します。シングル プレイヤー ゲームの場合、クライアントがサーバーと見なされます。

RadialDamage.png

このシーケンスに対する親アクタがラジアル ダメージを受けるたびに RadiusDamage アクタが呼び出されます。爆発によるダメージや、間接的に引き起こされたダメージに合わせてイベント処理する場合に便利です。

項目

説明

出力ピン

Damage

Float - イベントから受け取ったダメージの量です。

Damage Type

Object 'DamageType - 与えられているダメージ上に追加データを含むオブジェクトです。

Origin

Vector - もともとダメージがあった 3D 空間における位置を与えます。

Hit Info

Struct HitResult - Hit 内に収集されたすべてのデータです。この結果を「細分化して」個々のデータへのアクセスすることができます。

Instigated By

Controller - ダメージを仕掛けるコントローラー (AI またはプレイヤー) です。

Damage Causer

Actor - ダメージを引き起こすアクタです。弾丸、ロケット、レーザー、相手にパンチするキャラクターなどがこれに当たります。

Event Actor Begin Cursor Over

BeginCursorOver.png

マウス インターフェースを使用中、マウスのカーソルがアクタ上に移動するとこのイベントが実行されます。

BeginCursorOverEX.png

このアクタの上にマウスを当てると、Highlight on the Dynamic Material Instance という名前のスカラー パラメータが 1.0 に設定されます。

Event Actor End Cursor Over

EndCursorOver.png

マウス インターフェースを使用中にマウスのカーソルがアクタ上から外れると、のイベントが実行されます。

EndCursorOverEX.png Target Notification

Event Begin Play

BeginPlay.png

ゲームが開始されると、このイベントがすべてのアクタにトリガーされます。ゲーム開始後にスポーンされたすべてのアクタがこのイベントを直ちに呼び出します。

BeginPlayEX.png

プレイの開始に伴い、アクタはヘルス値を 1000 に、スコアを 0 に設定します。

Event End Play

EndPlay.png

アクタが破壊されると実行されるイベントです。

EndPlayEX.png

アクタがワールドから消えると、 String が出力され、イベントの呼び出し理由が表示されます。

項目

説明

出力ピン

End Play Reason

enum EEndPlayReason - Event End Play の呼び出し理由を表示する列挙型変数です。

Event Destroyed

Destroyed.png

アクタが破壊されると実行されるイベントです。

DestroyedEX.png Score の変数が Value プラス Score

Destroyed Event は、今後のリリースノートで非推奨となります。Destroyed 関数の機能は Endplay 関数に組み込まれています。

Event Tick

Tick.png

ゲームプレイのフレームごとに呼び出される単純なイベントです。

項目

説明

出力ピン

Delta Seconds

Float - フレーム間の合計時間を出力します。

TickEX.png

このサンプルでは、Delta Seconds を使って「発射!」直前のティックでログに表示するカウントダウン タイマーを作ります。

Event Receive Draw HUD

このイベントは、HUD クラスから派生する Blueprint クラスのみで利用できます。

DrawHud.png

このイベントは、ブループリントが HUD に描画できるようにするための指定イベントです。 HUD 描画ノードからは、このイベントそのものをノード作成用イベントにするように要求されます。

項目

説明

出力ピン

Size X

Int - レンダリング ウィンドウの幅 (ピクセル数)。

Size X

Int - レンダリング ウィンドウの高さ (ピクセル数)。

ヒット ボックス

Custom Event

Custom Event Node

カスタム イベント ノードは専用のワークフローを持つ特殊なノードです。

詳細は以下を参照してください。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
閉じる