Legacy Documentation: Version 2017.1 (Go to current version)
言語English
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

RequireComponent

class in UnityEngine

フィードバック

ありがとうございます

この度はドキュメントの品質向上のためにご意見・ご要望をお寄せいただき、誠にありがとうございます。頂いた内容をドキュメントチームで確認し、必要に応じて修正を致します。

閉じる

送信に失敗しました

なんらかのエラーが発生したため送信が出来ませんでした。しばらく経ってから<a>もう一度送信</a>してください。ドキュメントの品質向上のために時間を割いて頂き誠にありがとうございます。

閉じる

キャンセル

マニュアルに切り替える

説明

RequireComponent 属性は、必要なコンポーネントを依存関係として自動的に加えます。

RequireComponent を使ったスクリプトをゲームオブジェクトにアタッチすると、必要なコンポーネントが自動的にそのゲームオブジェクトに加えられるようになります。 これはセットアップエラーを回避するのに役に立ちます。 例えば、あるスクリプトでは Rigidbody が同じゲームオブジェクトに常に加えられる必要があるとします。 RequireComponent を使用することでこれを自動的に実行し、セットアップで間違えることがなくなります。 RequireComponent は、コンポーネントがゲームオブジェクトに加えられる時点で、欠落している依存関係のみを検知します。ゲームオブジェクトに新しい依存関係が欠落していても、そのコンポーネントのすでに存在しているインスタンスにそれらの欠落した依存関係が自動的に加えられるわけではありません。

// PlayerScript requires the GameObject to have Rigidbody component
@script RequireComponent(Rigidbody)

var rb: Rigidbody;

function Start() { rb = GetComponent.<Rigidbody>(); }

function FixedUpdate() { rb.AddForce(Vector3.up); }
using UnityEngine;

// PlayerScript requires the GameObject to have a Rigidbody component [RequireComponent(typeof(Rigidbody))] public class PlayerScript : MonoBehaviour { Rigidbody rb;

void Start() { rb = GetComponent<Rigidbody>(); }

void FixedUpdate() { rb.AddForce(Vector3.up); } }

コンストラクタ

RequireComponent1 つのコンポーネントを必要とします