Unity 6.3
0 онлайн 3 гостей 3 в системе
Вход

GameObject

класс в UnityEngine

Наследуется от:Object

Выполнено в:UnityEngine.CoreModule

Описание

Базовый класс для всех объектов, которые могут существовать в сцене. Добавляйте компоненты к 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.
sceneScene, который содержит GameObject.
sceneCullingMaskМаска удаления Scene, определенная для GameObject. (только для чтения)
tagТег, назначенный GameObject.
transformTransform присоединен к GameObject (только для чтения).
transformHandleTransformHandle из 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Существует ли объект?
оператор!=Сравнивает, если два объекта ссылаются на разные объекты.
оператор ==Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту.