Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

> プログラミングとスクリプト処理 > ブループリントビジュアルスクリプティング > スクリプト処理の基礎 > イベント

Light Theme

Dark Theme

イベント

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

Choose your operating system:

Windows

macOS

Linux

Event Level Reset

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

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

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

Event Actor Begin Overlap

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

アクタ間のコリジョン反応がオーバーラップできること。
イベントを実行するアクタは両方とも Generate Overlap Events が true に設定されていること。
最後に、両方のアクタのコリジョンがオーバーラップを開始します。一緒に動くか、一方が他方にオーバーラップするように作成されます。

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

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


項目	説明
出力ピン
Other Actor	このブループリントにオーバーラップするアクタです。

Event Actor End Overlap

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

アクタ間のコリジョン反応がオーバーラップできること。
イベントを実行するアクタは両方とも Generate Overlap Events が true に設定されていること。
そして、両方のアクタのコリジョンがバラバラに動くか、一方が破壊されて、オーバーラップを停止すること。

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

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


項目	説明
出力ピン
Other Actor	Actor - このブループリントにオーバーラップするアクタです。

Event Hit

このイベントは、コリジョンに関わアクタの片方のコリジョン設定の 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 を引っ張り出し、この結果を「細分化して」個々のデータへのアクセスすることができます。

Hit

Event Any Damage

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

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


項目	説明
出力ピン
Damage	Float - アクタへ渡されているダメージの量です。
Damage Type	Object 'DamageType - 与えられているダメージ上に追加データを含むオブジェクトです。
Instigated By	Actor - ダメージを仕掛けるアクタです。ダメージを与えるために銃を発砲したり手榴弾を投げたりするアクタになります。
Damage Causer	Actor - ダメージを引き起こすアクタです。弾丸や爆発などがこれにあたります。

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

Event Point Damage

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

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 ノードはサーバー上でのみ実行します。シングルプレイヤーゲームの場合、クライアントがサーバーと見なされます。

このシーケンスに対する親アクタがラジアルダメージを受けるたびに 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

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

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

Event Actor End Cursor Over

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

Target Notification

Event Begin Play

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

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

Event End Play

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

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


項目	説明
出力ピン
End Play Reason	enum EEndPlayReason - Event End Play の呼び出し理由を表示する列挙型変数です。

Event Destroyed

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

Score の変数が Value プラス Score

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

Event Tick

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


項目	説明
出力ピン
Delta Seconds	Float - フレーム間の合計時間を出力します。

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

Event Receive Draw HUD

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

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


項目	説明
出力ピン
Size X	Int - レンダリングウィンドウの幅 (ピクセル数)。
Size X	Int - レンダリングウィンドウの高さ (ピクセル数)。