Script Graph ノード

Visual Scripting には以下の 4 つの種類のノードがあり、これらを使用して、ゲームオブジェクトとその Script Machine (スクリプトマシン) に添付された Script Graph (スクリプトグラフ) の識別と操作を行うことができます。

• Set Script Graph
• Has Script Graph
• Get Script Graph
• Get Script Graphs

Set Script Graph

Set Script Graph ノードを使用すると、特定の Script Machine あるいは、特定のゲームオブジェクトに添付された最初の Script Machine に、Script Graph を割り当てることができます。

項目		説明
ノードパラメーター
	Container Type	Target が GameObject か Script Machine かを指定します。
入力ポート
	Enter	(Input Trigger) ノードの実行入力トリガー
	Target	(GameObject または Script Machine) ノードが Graph を設定するゲームオブジェクトあるいは Script Machine
	Graph	(Script Graph Asset) ノードが Target に設定する Script Graph
出力ポート
	Exit	(Output Trigger) 実行出力トリガー
	Graph	(Script Graph Asset)(任意) Graph を出力します。

必要なノードパラメーターと入力の設定

Set Script Graph ノードには必要な入力パラメーターが 1 つあります。これは Container Type と呼ばれ、ノードのヘッダー内のドロップダウンメニューで設定されます。Container Type は、ノードがその Target の入力として受け取るコンポーネントの型を指定します。

• GameObject を選択すると、ノードはゲームオブジェクトの受け取りを待機し、そのゲームオブジェクトに添付された最初の Script Machine にグラフを割り当てます。

• Script Machine を選択すると、ノードは Script Machine の受け取りを待機します。Script Graph を設定したい特定の Script Machine を指定できます。

選択された Container Type に応じて、ノードの Target 入力ポートの横に表示されるアイコンが以下のように変化します。

Container Type	Target アイコン
GameObject
Script Machine

このノードは左側に 3 つの入力ポートを持っています。最初のポートは Enter で、これは Set Script Graph ノードの実行を開始するノードに接続されます。

他の 2 つのポートは、Set Script Graph ノードの必要とする以下の入力データを取得します。

• Target (Script Graph を設定したいゲームオブジェクトまたはスクリプトマシン)

• Graph (ゲームオブジェクトまたはスクリプトマシンを添付したい Script Graph)

出力

Set Script Graph ノードは右側に 2 つの出力ポートを持っています。

最初のポート Exit は、Set Script Graph ノードの終了後に実行するべきノードへの接続を確立します。

2 つ目のポート Graph は、このノードを使用して割り当てた Script Graph を出力できます。

Has Script Graph

Has Script Graph ノードを使用して、ゲームオブジェクトあるいは Script Machine に特定の Script Graph を割り当てるかどうかを設定できます。

項目		説明
ノードパラメーター
	Container Type	Target を GameObject にするか Script Machine にするか指定します。
入力ポート
	Enter	(Input Trigger) ノードの実行入力トリガー
	Target	(GameObject または Script Machine) ノードが Graph を探すべきゲームオブジェクトまたはスクリプトマシン
	Graph	(Script Graph Asset) ゲームオブジェクトまたはスクリプトマシン上で探すべき Script Graph
出力ポート
	Exit	(Output Trigger) 指定の Script Graph を探した後にフロー内の次のノードの実行を開始する、実行出力トリガー
	Has Graph	(Boolean) ノードが指定の Script Graph を見付けた場合は true を出力し、見付からなければ false を出力します。

必要なノードパラメーターと入力の設定

Has Script Graph ノードには必要な入力パラメーターが 1 つあり、これは Container Type と呼ばれ、ノードのヘッダー内のドロップダウンメニューで設定されます。Container Type は、ノードがその Target の入力として想定すべきコンポーネントの型を指定します。

• GameObject を選択すると、ノードはゲームオブジェクトの受け取りを想定し、ゲームオブジェクトに添付された最初の Script Machine 上のグラフを探します。

• Script Machine を選択すると、ノードは Script Machine の受け取りを想定します。見付けたい Script Graph がある特定の Script Machine を指定できます。

選択された Container Type に応じて、ノードの Target 入力ポートの横に表示されるアイコンが以下のように変化します。

Container Type	Target アイコン
GameObject
Script Machine

このノードは左側に 3 つの入力ポートを持っています。最初のポートは Enter で、これは Has Script Graph ノードの実行を開始するノードに接続されます。

他の 2 つのポートは、Has Script Graph ノードの必要とする以下の入力データを取得します。

• Target (Script Graph を設定したいゲームオブジェクトまたはスクリプトマシン)

• Graph (ゲームオブジェクトまたはスクリプトマシンを添付したい Script Graph)

出力

Has Script Graph ノードは、指定の Script Graph を見付けると true を返し、そうでなければ false を返します。

Has Script Graph の出力ポートに接続された制御ノードを使用して、Has Script Graph の結果に応じてスクリプトが次に実行する操作を変更できます。 制御ノードに関する詳細は、制御ノード を参照してください。

Get Script Graph

Get Script Graph ノードは、ゲームオブジェクトに添付された最初の Script Graph を返します。

項目		説明
入力ポート
	GameObject	(GameObject) ノードが取得する Script Graph が設定されたゲームオブジェクト
出力ポート
	Graph	(Script Graph Asset) ゲームオブジェクトに設定された最初の (あるいは唯一の) Script Graph を出力します。Script Graph が設定されていない場合は null を出力します。

必要なノードパラメーターと入力の設定

Get Script Graph ノードはデータノードです。これはスクリプト内のロジックを制御することはできず、データを返すためだけに使用されます。

このノードは左側に以下の 1 つの入力ポートを持っており、これはノードが必要とする入力データを取得します。

• ノードが取得すべき Script Graph の添付されたゲームオブジェクト。特定のゲームオブジェクトを選択するか、あるいはデフォルトの This を選択してスクリプトが現在実行しているゲームオブジェクトを使用することができます。

出力

Get Script Graph ノードは右側に 1 つの出力ポートを持っています。この出力ポートはゲームオブジェクトに設定された最初の Script Graph を返します。Script Graph が設定されていない場合は null を返します。

Note

Get Script Graph ノードは、ゲームオブジェクトに設定された最初の Script Graph のみを返します。ゲームオブジェクトに設定された全ての Script Graph を返すには Get Script Graphs ノード を使用してください。

Get Script Graphs

Get Script Graphs ノードは、ゲームオブジェクトに設定された全ての Script Graph のリストを返します。

項目		説明
入力ポート
	GameObject	(GameObject) ノードが取得する Script Graph のリストを持つゲームオブジェクト
出力ポート
	Graphs	(Script Graph Asset のリスト) ゲームオブジェクトに設定された全ての Script Graph のリストを出力します。設定された Script Graphs がない場合は空のリストを出力します。

必要なノードパラメーターと入力の設定

Get Script Graphs ノードはデータノードです。これはスクリプト内のロジックを制御することはできず、データを返すためだけに使用されます。

このノードは左側に以下の 1 つの入力ポートを持っており、これはノードが必要とする入力データを取得します。

• ノードが取得すべき Script Graph のリストを持つゲームオブジェクト。特定のゲームオブジェクトを選択するか、あるいはデフォルトの This を選択してスクリプトが現在実行しているゲームオブジェクトを使用することができます。

出力

Get Script Graphs ノードは出力ポートを 1 つ持っており、これは右側に配置されています。出力ポートは、ゲームオブジェクトに設定された全ての Script Graph のリストを返します。設定された Script Graph がない場合は空のリストを返します。