HEOFieldの使い方
HEOFieldを使うことで、ビルド後のシーンにUnity上のオブジェクトを反映することができますが、使い方を誤るとエラーが発生したり、オブジェクトが思わぬ位置に現れたりします。
本記事ではHEOFieldの使い方を解説していきます。
基本的な使い方
上記のようなHEOFieldをアタッチしたオブジェクトにObjectA、ObjectB、ObjectC、ObjectC2、ObjectC3を子オブジェクトに入れた場合、これらのオブジェクトはHEOFieldによって生成されるアイテムに含まれ、シーン上に表示されます。(ここでの「アイテム」については Itemクラス を参照)
一方、HEOFieldの子オブジェクトではないObjectDはアイテムに含まれず、シーン上に表示されません。
また、この状態でのObjectA、ObjectB、ObjectC、ObjectC2、ObjectC3は「ノード」と呼ばれる状態になっており、Show/HideNode、 Enable/DisableCollider、 Enable/DisableClickableNodeアクションの対象とすることができます。
上記のように、HEOFieldをアタッチしたHEOField2にObjectD、ObjectE、ObjectF、ObjectF2を子オブジェクトに入れた場合、これらのオブジェクトはHEOFieldによって生成されるアイテム「HEOField2」に含まれ、シーン上に表示されます。
HEOField2はObjectD、ObjectE、ObjectF、ObjectF2をノードに持ちます。
したがって、これらのノードに対し表示/非表示を行う時のアクション設定は下記画像のようになります：
1つ目のTargetにノードが所属するアイテムが入るため、親オブジェクトとなるHEOField2が入り、2つ目のTargetにアクションの対象となるオブジェクトが入ります。
この時、1つ目のTargetがHEOFieldなのに2つ目のTargetがObjectEといった、アイテムとノードの組み合わせが正しくない状態だと動作しません。
間違った使い方
以下の使い方は正しくないので注意してください。
1. HEOFieldの親子構造
上記画像のようにHEOFieldを持ったオブジェクトの子オブジェクトの中にHEOFieldを持ったオブジェクトを入れるのは誤りです。
HEOFieldを入れるのは最上位オブジェクトのみ、と覚えておきましょう。
2. オブジェクトごとにHEOFieldをアタッチする
「HEOFieldをアタッチすることでシーン上にオブジェクトが表示される」ことから、このような実装をやってしまいがちですが、HEOFieldは動的ローディングを実装しない場合、基本的に1つだけで大丈夫です。
ビルド時にHEOFieldをアタッチしたオブジェクトを元に.heoファイルが生成されます。 上記のような実装を行うと大量に.heoファイルが生成され、容量を大幅に取ってしまいます。
可能な限り、HEOFieldを使う数は最小に抑えましょう。
3. HEOFieldをアタッチしたオブジェクトに他のアイテム生成系HEOコンポーネントをアタッチする
上記画像のように、HEOFieldとHEOAudioを同じオブジェクトにアタッチした状態でビルドすると、同一のオブジェクトが別アイテムとして二重計上されてしまいます。
同名のアイテムが存在する場合、誤作動が起きてしまうので、このような実装はNGです。
OKな組み合わせ
1. +HEOScript
HEOFieldで定義したアイテムにHEOScriptで定義したComponentを入れることができます。
HEOFieldとHEOReflectionProbeも併用可能です。
ReflectionProbe本体にHEOFieldは付けないでください。
まとめ
HEOFieldの使い方
- 基本1シーンにつき1つ
- 最上位オブジェクトにアタッチする(空のオブジェクトが好ましい)
- 動的ローディングを使う時は2つ以上HEOFieldを使う