【Unity】コンポーネントをC#スクリプトから取得する「GetComponent系関数」の使い方

この記事はUnityの基本的な使い方を解説するシリーズの一つで、今回はゲームオブジェクトにアタッチされているコンポーネントへの参照をC#スクリプトから取得する方法について詳しくご説明します。

コンポーネントを取得できる「GetComponent系関数」の使い方

では早速ですがゲームオブジェクトにアタッチされているコンポーネントを取得できる関数（いずれも「GetComponent」という名前がついているので、ここでは便宜的に「GetComponent系関数」と呼ぶことにします）の使い方をご紹介していきます。

まず、あるゲームオブジェクトにアタッチされているコンポーネントを一つだけ取得する場合には次のような関数を使うと便利です。

GetComponent関数を使えば指定したゲームオブジェクトにアタッチされている特定のコンポーネントへの参照を1つ取得することができます。

例えば、スクリプトがアタッチされているのと同じゲームオブジェクトにアタッチされているRigidbodyコンポーネントを取得する場合は次のように書きます。

Rigidbody rb = GetComponent<Rigidbody>();

なお、もし同じ種類のコンポーネントが複数アタッチされている場合は最初のコンポーネントを取得するようです。

GetComponentInChildren関数は、あるゲームオブジェクトの子のゲームオブジェクトにアタッチされているコンポーネントを1つ取得するメソッドです。使い方はGetComponent関数と同じです。

GetComponentInParent関数は上のGetComponentInChildren関数の逆で、あるゲームオブジェクトの親のゲームオブジェクトにアタッチされているコンポーネントを1つ取得するメソッドです。使い方はGetComponent関数と同じです。

次に複数のコンポーネントをまとめて取得するには、先ほどの3つの関数とほぼ同じ使い方ができるメソッドを使います。

1つだけ取得する場合との違いは、戻り値が配列になることだけです。

最後に、コンポーネントを取得する関数を使う際には1つ注意点があります。それはコンポーネントの取得処理は比較的重い処理だということです。

といった工夫をした方がよいでしょう。

以上、UnityでゲームオブジェクトにアタッチされているコンポーネントをC#スクリプトから検索する方法についてご説明しました。

コンポーネントの取得処理も（ゲームオブジェクトの検索処理と同様に）なるべく使わないほうがスマートですが、使いこなせると便利ではあるのでぜひ上記の内容を参考にしていただければと思います。