GameObject
Описание
Базовый класс для всех объектов, которые могут существовать в сцене. Добавляйте компоненты к GameObject, чтобы управлять его внешним видом и поведением.
GameObject является фундаментальным типом объекта в Unity. Использование GameObject чтобы представить все в вашем проекте, включая персонажей, реквизит и декорации. GameObject действует в качестве контейнера для функциональных components которые определяют, как GameObject выглядит и ведет себя.
Любой скрипт, производный от MonoBehaviour могут быть добавлены к GameObject в качестве компонента. Используйте Component.gameObject свойство от вашего MonoBehaviour код для доступа к GameObject к которому прикреплен компонент.MonoBehaviour функции событий такие как регулярный на кадр MonoBehaviour.Update позволяют сделать объект реагирующим на события. Для получения этих обратных вызовов событий GameObject должен быть активным в сцене, что означает, что и activeSelf и activeInHierarchy свойства должны быть true.
Вы можете создать пустую GameObject из кода путем вызывания одного из constructors. Однако более распространенным методом является создание экземпляра GameObject в Префаб форма с предварительно настроенными компонентами, значениями свойств и дочерними объектами. Дополнительные сведения см. в разделе Создание экземпляра Префабы во время выполнения в Руководстве.
Многие свойства этого класса можно менять в редакторе через окно Inspector. Более полное руководство по работе с классом GameObject см. в GameObject в Руководстве.
В следующем примере создается GameObject названный "myExampleGO" и добавляет компонент типа AudioSource:
using UnityEngine;
public class Example_GameObject : MonoBehaviour { private void Start() { GameObject myExampleGO = new GameObject("myExampleGO", typeof(AudioSource)); } }
Дополнительные ресурсы: ,Component,.
Свойства
| Свойство | Описание |
|---|---|
| activeInHierarchy | Активное состояние GameObject в иерархии сцены. True — активен, false — неактивен. (Только для чтения) |
| activeSelf | Локальное активное состояние GameObject. True — активен, false — неактивен. (Только для чтения) |
| isStatic | Установлены ли для GameObject какие-либо Флаги Статического Редактора. |
| layer | Целое число, идентифицирующее слой, которому назначен GameObject. |
| scene | Scene, который содержит GameObject. |
| sceneCullingMask | Маска удаления Scene, определенная для GameObject. (только для чтения) |
| tag | Тег, назначенный GameObject. |
| transform | Transform присоединен к GameObject (только для чтения). |
| transformHandle | TransformHandle из GameObject (только для чтения). |
Конструкторы
| Конструктор | Описание |
|---|---|
| GameObject | Создает новый файл GameObject с дополнительными параметрами для указания имени и набора компонентов для присоединения. |
Открытые методы
| Метод | Описание |
|---|---|
| AddComponent | Добавление компонента указанного типа в GameObject. |
| BroadcastMessage | Вызывает указанный метод на каждом MonoBehaviour, присоединенном к GameObject или любому из его дочерей. |
| CompareTag | Проверяет, прикреплен ли указанный тег к GameObject. |
| GetComponent | Получает ссылку на компонент указанного типа, предоставляя тип компонента в качестве параметра типа для общего метода. |
| GetComponentAtIndex | Получает ссылку на компонент в указанном индексе массива компонентов GameObject. |
| GetComponentCount | Получает общее число компонентов, в настоящее время подключенных к GameObject. |
| GetComponentInChildren | Получает ссылку на компонент типа T на указанном GameObject или любом дочернем GameObject. |
| GetComponentIndex | Получает индекс указанного компонента в массиве компонентов, присоединенных к GameObject. |
| GetComponentInParent | Получает ссылку на компонент типа T на указанном GameObject или любом родителе GameObject. |
| GetComponents | Получает ссылки на все компоненты типа T на указанном GameObject. |
| GetComponentsInChildren | Получает ссылки на все компоненты типа T на указанном GameObject и любом дочернем GameObject. |
| GetComponentsInParent | Получает ссылки на все компоненты типа T на указанном GameObject и любом родителе GameObject. |
| SendMessage | Вызывает указанный метод на каждом MonoBehaviour, подключенном к GameObject. |
| SendMessageUpwards | Вызывает указанный метод на каждом MonoBehaviour, присоединенном к GameObject, и на каждом предшественнике поведения. |
| SetActive | Активирует или деактивирует GameObject локально, в зависимости от значения предоставленного параметра. |
| TryGetComponent | Получает компонент указанного типа, если он существует. |
Статические методы
| Метод | Описание |
|---|---|
| CreatePrimitive | Создает GameObject из указанного PrimtiveType с помощью рендеринга сетки и соответствующего коллайдера. |
| Find | Находит и возвращает GameObject с указанным именем или путем к иерархии. |
| FindGameObjectsWithTag | Получает массив всех активных GameObjects, помеченных указанной меткой. Возвращает пустое массиво, если ни один GameObjects не имеет метки. |
| FindWithTag | Получает первый активный GameObject, помеченный указанной меткой. Возвращает null, если GameObject не имеет метки. |
| GetScene | Получает Scene, который содержит GameObject с указанным экземпляром ID. |
| InstantiateGameObjects | Создает указанное количество экземпляров GameObject, идентифицируемых его экземпляром ID, и заполняет NativeArrays экземпляром IDs новых GameObjects и их компонентов Transform. |
| SetGameObjectsActive | Активирует или деактивирует несколько GameObjects, идентифицируемых экземпляром ID. |
Унаследованные члены 4
Свойства
| Свойство | Описание |
|---|---|
| hideFlags | Должен ли объект быть скрытым, сохраняться с Scene или изменяться пользователем? |
| name | Имя объекта. |
Открытые методы
| Метод | Описание |
|---|---|
| GetInstanceID | Получает экземпляр ID объекта. |
| ToString | Возвращает имя объекта. |
Статические методы
| Метод | Описание |
|---|---|
| Destroy | Удаляет GameObject, компонент или ресурс. |
| DestroyImmediate | Немедленно уничтожает указанный объект. Используйте с осторожностью и только в режиме редактирования. |
| DontDestroyOnLoad | Не уничтожать целевой Объект при загрузке нового Scene. |
| FindAnyObjectByType | Получает любой активный загруженный объект типа Type. |
| FindFirstObjectByType | Получает первый активный загруженный объект типа Type. |
| FindObjectsByType | Получает список всех загруженных объектов типа Type. |
| Instantiate | Клонирует исходный объект и возвращает клон. |
| InstantiateAsync | Захватывает моментальный снимок первоначального объекта (который должен быть связан с каким-либо GameObject) и возвращает AsyncInstantiateOperation. |
Операторы
| Оператор | Описание |
|---|---|
| bool | Существует ли объект? |
| оператор!= | Сравнивает, если два объекта ссылаются на разные объекты. |
| оператор == | Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту. |