프로그램에서 [장면 분석](/performance-optimization/scene-analysis) 도구의 기본 성능 데이터에 접근할 수 있도록 합니다.


로드된 애니메이션 클립 메모리를 반환합니다. 여러 Animator에 의해 공유되는 동일한 자산은 한번만 나타나며, 모든 소유자가 나열됩니다.

#### 루트 사전

| 키        | 유형   | 설명                                                       |
| ---------- | ------ | ---------------------------------------------------------- |
| `Name`     | string | 항상 `"AnimationMemory"`입니다.                           |
| `Size`     | number | 로드된 클립 메모리의 총 크기(바이트 단위)입니다.         |
| `Children` | array  | 클립 항목의 배열과 선택적으로 데이터 모델 그룹 출력.     |

#### 클립 항목

`Children`의 각 자식은 클립 항목이거나 "데이터 모델에 없음" 그룹입니다 (아래 참조).

| 키       | 유형   | 설명                                                    |
| --------- | ------ | ------------------------------------------------------- |
| `Name`    | string | 자산 ID (예: `"rbxassetid://111"`)입니다.              |
| `Size`    | number | 클립 메모리 (바이트 단위)입니다.                       |
| `AssetId` | string | 자산 ID 문자열 (값은 `Name`과 동일합니다).             |
| `Owners`  | array  | 이 클립을 재생하는 모든 Animator의 소유자가 포함된 배열입니다. |

#### 소유자 항목

| 키         | 유형   | 설명                                                             |
| ----------- | ------ | ----------------------------------------------------------------- |
| `Name`      | string | 소유 Animator의 전체 경로 (예: `"Workspace.NPC.Humanoid.Animator"`)입니다. |
| `ClassName` | string | 소유자의 클래스 이름 (예: `"Animator"`)입니다.                   |

#### "데이터 모델에 없음" 그룹

Lua에 의해만 보유된 Animator의 클립은 단일 그룹 항목으로 수집됩니다.

| 키        | 유형   | 설명                                     |
| ---------- | ------ | ----------------------------------------- |
| `Name`     | string | 항상 `"Not In DataModel"`입니다.          |
| `Size`     | number | 이 그룹에서 클립 바이트의 합계입니다.     |
| `Children` | array  | 클립 항목 배열 (위와 동일한 스키마).    |

#### 예시

```lua
{
  Name = "AnimationMemory",
  Size = 1048576,
  Children = {
    { Name = "rbxassetid://111", Size = 32768, AssetId = "rbxassetid://111",
      Owners = {
        { Name = "Workspace.Player.Humanoid.Animator", ClassName = "Animator" },
    }},
    { Name = "rbxassetid://444", Size = 65536, AssetId = "rbxassetid://444",
      Owners = {
        { Name = "Workspace.NPC1.Humanoid.Animator", ClassName = "Animator" },
        { Name = "Workspace.NPC2.Humanoid.Animator", ClassName = "Animator" },
    }},
    { Name = "Not In DataModel", Size = 32768, Children = {
        { Name = "rbxassetid://555", Size = 32768, AssetId = "rbxassetid://555",
          Owners = {
            { Name = "Animator", ClassName = "Animator" },
        }},
    }},
  }
}
```


SceneAnalysisService:GetAnimationMemoryAsync

클립에 의해 중복 제거된 로드된 애니메이션 클립 메모리의 사전 트리입니다.


자산 ID에 의해 중복 제거된 로드된 오디오 자산 메모리를 반환합니다. 소유자가 동일한 부모를 공유하는 자산은 해당 부모 경로 아래에서 구성됩니다 — 자식이 하나일 때는 평면화되고, 여러 개일 때는 중첩됩니다. 서로 다른 부모에 걸쳐 있는 소유자를 가진 자산은 `Owners` 배열로 공유 항목으로 나타납니다.

#### 루트 사전

| 키        | 유형   | 설명                                               |
| ---------- | ------ | -------------------------------------------------- |
| `Name`     | string | 항상 `"AudioMemory"`입니다.                      |
| `Size`     | number | 로드된 오디오 메모리의 총 크기(바이트 단위)입니다. |
| `Children` | array  | 평면 항목과 부모 그룹 및 공유 항목의 혼합입니다. |

#### 평면 자산 항목

부모가 정확히 하나의 오디오 자식을 가질 때 방출됩니다.

| 키       | 유형   | 설명                                             |
| --------- | ------ | ------------------------------------------------ |
| `Name`    | string | 전체 인스턴스 경로 (예: `"Workspace.Map.BGMusic"`)입니다. |
| `Size`    | number | 자산 메모리 (바이트 단위)입니다.                |
| `AssetId` | string | 오디오 자산 ID입니다.                           |

#### 부모 그룹

부모가 여러 개의 오디오 자식을 가질 때 방출됩니다.

| 키        | 유형   | 설명                                                                |
| ---------- | ------ | -------------------------------------------------------------------- |
| `Name`     | string | 부모 경로 (예: `"Workspace.Map.SFX"`)입니다.                        |
| `Size`     | number | 자식 자산의 바이트 합계입니다.                                     |
| `Children` | array  | 평면 자산 항목 배열 (각 항목에 `Name`, `Size`, `AssetId` 포함).  |

#### 공유 자산 항목

자산의 소유자가 서로 다른 부모 아래에 있을 때 방출됩니다.

| 키       | 유형   | 설명                                    |
| --------- | ------ | ---------------------------------------- |
| `Name`    | string | 자산 ID입니다.                          |
| `Size`    | number | 자산 메모리 (바이트 단위)입니다.       |
| `AssetId` | string | 자산 ID 문자열 (값은 `Name`과 동일합니다). |
| `Owners`  | array  | 소유자 항목 배열입니다.                |

#### 소유자 항목

| 키         | 유형   | 설명                                            |
| ----------- | ------ | ------------------------------------------------|
| `Name`      | string | 전체 인스턴스 경로 (예: `"Workspace.Zone1.Ambient"`)입니다. |
| `ClassName` | string | `"Sound"` 또는 `"AudioPlayer"`입니다.           |

#### 예시

```lua
{
  Name = "AudioMemory",
  Size = 5242880,
  Children = {
    -- 고유 부모 아래의 단일 오디오 (평면)
    { Name = "Workspace.Map.BGMusic", Size = 2097152,
      AssetId = "rbxassetid://111" },

    -- 동일한 부모 아래의 여러 오디오 (그룹화)
    { Name = "Workspace.Map.SFX", Size = 1048576, Children = {
        { Name = "Workspace.Map.SFX.Explosion", Size = 524288, AssetId = "rbxassetid://222" },
        { Name = "Workspace.Map.SFX.Gunshot",   Size = 524288, AssetId = "rbxassetid://333" },
    }},

    -- 공유 자산 (소유자가 서로 다른 위치에 있음)
    { Name = "rbxassetid://444", Size = 2097152, AssetId = "rbxassetid://444",
      Owners = {
        { Name = "Workspace.Zone1.Ambient", ClassName = "Sound" },
        { Name = "Workspace.Zone2.Ambient", ClassName = "Sound" },
    }},
  }
}
```


SceneAnalysisService:GetAudioMemoryAsync

자산 ID에 의해 중복 제거된 로드된 오디오 자산 메모리의 사전 트리입니다.


데이터 모델 트리에서 카테고리 및 클래스별 인스턴스 수를 반환합니다. Workspace, Players, Lighting, MaterialService, ReplicatedFirst, ReplicatedStorage, ServerScriptService, ServerStorage, StarterGui, StarterPack, StarterPlayer, Teams, SoundService, 및 TextChatService의 하위 요소를 스캔합니다. 각 인스턴스는 클래스 계층 구조에 따라 아래의 카테고리 중 하나에 분류됩니다.

#### 루트 사전

| 키        | 유형   | 설명                                           |
| ---------- | ------ | ----------------------------------------------- |
| `Name`     | string | 항상 `"InstanceComposition"`입니다.            |
| `Size`     | number | 스캔된 모든 서비스에서의 총 인스턴스 수입니다. |
| `Children` | array  | 카테고리 항목 배열입니다.                     |

#### 카테고리 항목

| 키        | 유형   | 설명                      |
| ---------- | ------ | -------------------------- |
| `Name`     | string | 카테고리 이름 (아래 표 참조). |
| `Size`     | number | 이 카테고리의 총 인스턴스 수입니다. |
| `Children` | array  | 클래스 항목 배열입니다.                   |

#### 클래스 항목 (리프)

| 키    | 유형   | 설명                                                       |
| ------ | ------ | ---------------------------------------------------------- |
| `Name` | string | 클래스 이름 (예: `"Part"`, `"Script"`, `"Frame"`)입니다. |
| `Size` | number | 이 클래스의 인스턴스 수입니다.                           |

#### 카테고리

| 카테고리          | 대표 유형                                                                  |
| ------------------ | ------------------------------------------------------------------------ |
| 3D 객체            | BasePart, Model, Camera                                               |
| 물리               | Attachment, Constraint, JointInstance, WeldConstraint, ControllerManager, SensorBase |
| UI                 | GuiBase, BasePlayerGui, UIBase, ProximityPrompt, ClickDetector, TextChannel |
| 조명               | Light                                                                    |
| 후처리             | PostEffect, Highlight, Atmosphere, Sky, Clouds                        |
| 스크립트           | LuaSourceContainer, BindableEvent, RemoteEvent, RemoteFunction          |
| 오디오             | Sound, SoundEffect, AudioPlayer, Wire, SoundGroup, AudioEmitter        |
| 애니메이션         | Animator, AnimationController, Animation, KeyframeSequence, IKControl    |
| 값                 | ValueBase                                                              |
| 캐릭터             | CharacterAppearance, Humanoid, HumanoidDescription, BaseWrap, FaceControls |
| 텍스처             | FaceInstance, SurfaceAppearance, MaterialVariant                       |
| 메시               | DataModelMesh                                                          |
| 입자               | ParticleEmitter, Fire, Trail, Beam, Explosion                         |
| 서비스 및 스토리지 | Player, Folder, Configuration                                          |
| 기타               | Tool, Backpack, Team, ForceField, PathfindingModifier, PackageLink, HapticEffect |
| 분류되지 않음      | 위와 일치하지 않는 모든 것                                           |

#### 예시

```lua
{
  Name = "InstanceComposition",
  Size = 12450,
  Children = {
    { Name = "3D Objects", Size = 5200, Children = {
        { Name = "Part", Size = 3100 },
        { Name = "MeshPart", Size = 1800 },
        { Name = "Model", Size = 300 },
    }},
    { Name = "UI", Size = 2100, Children = {
        { Name = "Frame", Size = 900 },
        { Name = "TextLabel", Size = 700 },
        { Name = "UIListLayout", Size = 500 },
    }},
  }
}
```


SceneAnalysisService:GetInstanceCompositionAsync

카테고리 및 클래스 이름별로 그룹화된 인스턴스 수의 사전 트리입니다.


스크립트별 Luau VM 힙 메모리 사용량을 바이트 단위로 반환합니다. 스크립트는 먼저 포함된 서비스별로 그룹화되고 (점 경로의 첫 번째 부분에서 유래됨), 그 다음 인스턴스의 클래스에 따라 `"ModuleScripts"`와 `"Scripts"` 하위 그룹으로 나뉩니다.

#### 루트 사전

| 키        | 유형   | 설명                          |
| ---------- | ------ | ------------------------------ |
| `Name`     | string | 항상 `"ScriptMemory"`입니다.  |
| `Size`     | number | 총 Luau VM 메모리 (바이트 단위)입니다. |
| `Children` | array  | 서비스 카테고리 항목 배열입니다. |

#### 서비스 카테고리 항목

| 키        | 유형   | 설명                                                             |
| ---------- | ------ | --------------------------------------------------------------- |
| `Name`     | string | 서비스 이름 (예: `"ServerScriptService"`, `"ReplicatedStorage"`)입니다. |
| `Size`     | number | 이 서비스의 모든 스크립트 메모리의 합계 (바이트 단위)입니다.  |
| `Children` | array  | 하나 또는 두 개의 스크립트 유형 그룹 항목 (`"ModuleScripts"` 및/또는 `"Scripts"`).|

#### 스크립트 유형 그룹 항목

| 키        | 유형   | 설명                                   |
| ---------- | ------ | --------------------------------------- |
| `Name`     | string | `"ModuleScripts"` 또는 `"Scripts"` 중 하나입니다.  |
| `Size`     | number | 이 그룹의 스크립트 메모리의 합계 (바이트 단위)입니다.  |
| `Children` | array  | 개별 스크립트 항목 배열입니다.                               |

#### 스크립트 항목 (리프)

| 키    | 유형   | 설명                                                              |
| ------ | ------ | --------------------------------------------------------------- |
| `Name` | string | 스크립트에 대한 점 경로 (예: `"ServerScriptService.Shared.Utils"`)입니다. |
| `Size` | number | 이 스크립트가 사용한 힙 메모리 (바이트 단위)입니다.             |

#### 예시

```lua
{
  Name = "ScriptMemory",
  Size = 8388608,
  Children = {
    { Name = "ServerScriptService", Size = 524288, Children = {
        { Name = "ModuleScripts", Size = 409600, Children = {
            { Name = "ServerScriptService.Shared.Utils", Size = 204800 },
            { Name = "ServerScriptService.Shared.Config", Size = 204800 },
        }},
        { Name = "Scripts", Size = 114688, Children = {
            { Name = "ServerScriptService.MainScript", Size = 114688 },
        }},
    }},
    { Name = "ReplicatedStorage", Size = 262144, Children = {
        { Name = "ModuleScripts", Size = 262144, Children = {
            { Name = "ReplicatedStorage.SharedModule", Size = 262144 },
        }},
    }},
  }
}
```


SceneAnalysisService:GetScriptMemoryAsync

서비스 및 스크립트 유형별로 그룹화된 스크립트당 Luau VM 힙 메모리의 사전 트리입니다.


렌더 패스별 삼각형 및 드로우 콜 수를 `StatsService` 성능 데이터에서 반환합니다. 다른 쿼리와 달리, 이 쿼리는 단일 `Size` 필드 대신 `Sizes` 사전 (키가 `Triangles` 및 `Drawcalls`인)을 사용합니다. 삼각형과 드로우 콜이 0인 렌더 패스 항목은 생략됩니다.

#### 루트 사전

| 키        | 유형       | 설명                                                           |
| ---------- | ---------- | --------------------------------------------------------------- |
| `Name`     | string     | 항상 `"TriangleComposition"`입니다.                             |
| `Sizes`    | dictionary | `{ Triangles: number, Drawcalls: number }` — 모든 패스의 총 수치입니다. |
| `Children` | array      | 렌더 패스 항목 배열입니다.                                     |

#### 렌더 패스 항목 (리프)

| 키     | 유형       | 설명                                         |
| ------- | ---------- | --------------------------------------------- |
| `Name`  | string     | 렌더 패스 유형 (아래 표 참조).                |
| `Sizes` | dictionary | `{ Triangles: number, Drawcalls: number }` — 이 패스에 대한 정보입니다. |

#### 렌더 패스 유형

| 이름                | 설명                              |
| ------------------ | ---------------------------------- |
| 불투명             | 불투명 기하학                      |
| 투명               | 투명 기하학                        |
| 지형               | 복셀/매끄러운 지형                 |
| 풀초              | 지형 풀 장식                       |
| UI                 | 화면 공간 UI                      |
| 데칼               | 데칼 렌더링                        |
| 구름              | 볼륨 구름                         |
| 일반 후처리       | 일반 후처리                       |
| SSAO               | 화면 공간 환경 광원 음영                |
| DOF                | 심도 효과                         |
| 입자               | 입자 시스템                       |
| 하늘               | 하늘박스                           |
| 그림자             | 그림자 맵 렌더링                 |
| 정의되지 않음      | 분류되지 않음                     |

#### 예시

```lua
{
  Name = "TriangleComposition",
  Sizes = { Triangles = 245000, Drawcalls = 1200 },
  Children = {
    { Name = "Opaque",      Sizes = { Triangles = 180000, Drawcalls = 800 } },
    { Name = "Transparent", Sizes = { Triangles = 25000,  Drawcalls = 150 } },
    { Name = "Shadows",     Sizes = { Triangles = 30000,  Drawcalls = 200 } },
    { Name = "UI",          Sizes = { Triangles = 10000,  Drawcalls = 50  } },
  }
}
```


SceneAnalysisService:GetTriangleCompositionAsync

렌더 패스 유형별로 나누어진 삼각형 및 드로우 콜 수의 사전 트리입니다.


Luau에 의해 보유되지만 더 이상 데이터 모델에 없는 인스턴스를 반환하며, 호스트 스크립트별로 그룹화됩니다. 각 부모가 없는 인스턴스는 해당 참조를 보유하는 스크립트로 추적됩니다.

가비지 수집을 위해 플래그가 지정된 부모가 없는 인스턴스는 아직 삭제되지 않은 상태로 `Unknown`의 부모를 잠시 표시합니다. 이는 가비지 수집이 작동하는 방식의 부작용이며 문제를 나타내는 것이 아닙니다.

#### 루트 사전

| 키        | 유형   | 설명                                   |
| ---------- | ------ | --------------------------------------- |
| `Name`     | string | 항상 `"UnparentedInstances"`입니다.   |
| `Size`     | number | 부모가 없는 인스턴스의 총 수입니다.   |
| `Children` | array  | 호스트 스크립트 항목 배열입니다.       |

#### 호스트 스크립트 항목

| 키        | 유형   | 설명                                                                             |
| ---------- | ------ | ---------------------------------------------------------------------------------|
| `Name`     | string | 스크립트 경로 (예: `"ServerScriptService.Gameplay.Combat"`) 또는 추적할 수 없는 경우 `"(unknown)"`입니다. |
| `Size`     | number | 이 스크립트가 보유하는 부모가 없는 인스턴스 수입니다.                           |
| `Children` | array  | 클래스 항목 배열입니다.                                                         |

#### 클래스 항목 (리프)

| 키    | 유형   | 설명                                                               |
| ------ | ------ | ------------------------------------------------------------------- |
| `Name` | string | 부모가 없는 인스턴스의 클래스 이름 (예: `"Part"`, `"Frame"`, `"Sound"`)입니다. |
| `Size` | number | 이 호스트 스크립트의 이 클래스의 부모가 없는 인스턴스 수입니다.        |

#### 예시

```lua
{
  Name = "UnparentedInstances",
  Size = 47,
  Children = {
    { Name = "ServerScriptService.Gameplay.Combat", Size = 30, Children = {
        { Name = "Part", Size = 22 },
        { Name = "Attachment", Size = 8 },
    }},
    { Name = "(unknown)", Size = 17, Children = {
        { Name = "Frame", Size = 12 },
        { Name = "Sound", Size = 5 },
    }},
  }
}
```


SceneAnalysisService:GetUnparentedInstancesAsync

참조를 보유하고 있는 호스트 스크립트별로 그룹화된 부모가 없는 인스턴스의 사전 트리입니다.


SceneAnalysisService

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리에 포함될 수 있습니다.

루트 `Instance` 객체를 직접 생성할 수는 없지만, 특수한
`Datatype.Instance.new()` 생성자는 코드로 객체를 생성하며,
클래스의 이름을 매개변수로 받아 생성된 객체를 반환합니다.

인스턴스의 조상을 변경하는 것을 감지하기 위해 `Class.Instance.AncestryChanged` 이벤트에 연결하는 방법을 보여줍니다.

ChangingPart의 부모는 시간이 지남에 따라 다른 값으로 설정됩니다. 파트의 부모는 파트의 조상이므로, `Class.Instance.AncestryChanged` 이벤트는 변경될 때마다 발생합니다.


이 인스턴스가 재부모화되거나 그 조상 중 하나가 재부모화될 때 발생합니다.

이 이벤트를 사용하여 탐색기에서 수동으로 삭제하거나 플러그인을 통해 인스턴스가 삭제되는 것을 추적할 수 있습니다. `Class.Instance:Destroy()`를 사용하여 인스턴스가 파괴될 때를 감지해야 하는 경우 대신 `Class.Instance.Destroying` 이벤트를 사용하십시오.

Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` 속성이 변경된 인스턴스입니다. 이는 이 인스턴스이거나 더 먼 조상일 수 있으며, **반드시** 핸들러가 연결된 인스턴스는 아닙니다.

parent

`child` 매개변수의 새 부모입니다.

이 객체 또는 그 조상의 `Class.Instance.Parent` 속성이 변경될 때 발생합니다.

이 이벤트는 인스턴스의 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때를 포함합니다. 변경된 속성의 이름이 연결된 함수에 전달됩니다.

예를 들어, 다음 코드는 부분의 속성이 변경될 때마다 `attributeChanged()` 함수를 연결하는 예입니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "변경됨")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 속성이 변경될 때 발생하는 이벤트인 `Class.Instance:GetAttributeChangedSignal()`도 참조하십시오.

Instance.AttributeChanged

attribute

`Class.Instance`에서 속성이 변경될 때마다 발생합니다.

이 코드는 객체가 작업 공간에 추가될 때 그 이름을 출력합니다:

`Class.Instance`에 자식이 추가된 후 발생합니다.

클라이언트에서 서버에서 생성된 개체를 감지하기 위해 이 방법을 사용할 때는 해당 개체의 자손을 인덱싱할 때 `Class.Instance:WaitForChild()`를 사용해야 합니다. 이는 개체와 그 자손이 서버에서 클라이언트로 동시에 복제될 것이라는 보장이 없기 때문입니다. 예를 들어:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 자손이 아직 복제되지 않았을 수 있으므로 WaitForChild() 사용
	local head = child:WaitForChild("Head")
end)
```
이 이벤트는 `Class.Instance`의 즉각적인 자식에게만 작동합니다. 모든 자손을 포착하는 이벤트가 필요하면 `Class.Instance.DescendantAdded`를 사용하세요.

또한 `Class.Instance.ChildRemoved`도 참조하십시오.

Instance.ChildAdded

`Class.Instance`에 자식이 추가된 후 발생합니다.

Instance.childAdded

이 코드 조각은 객체가 작업공간에서 제거될 때 그 이름을 출력합니다:

`Class.Instance`에서 자식이 제거된 후 발생합니다.

제거는 개체의 부모가 이 `Class.Instance`에서 다른 무엇인가로 변경될 때를 의미합니다. 참고로, 이 이벤트는 자식이 파괴될 때( `Class.Instance:Destroy()` 호출 시)도 발생합니다. 파괴 함수는 개체의 부모를 `nil`로 설정하므로 발생합니다.

이 이벤트는 `Class.Instance`의 즉각적인 자식에게만 작동합니다. 모든 자손을 포착하는 이벤트가 필요하면 `Class.Instance.DescendantRemoving`을 사용하세요.

또한 `Class.Instance.ChildAdded`도 참조하십시오.

Instance.ChildRemoved

`Class.Instance`에서 자식이 제거된 후 발생합니다.

다음 예제는 Workspace에 추가되는 모든 객체의 이름을 출력합니다:

이 이벤트는 `Class.Instance`에 자손이 추가된 후 발생합니다.

모든 자손에 대해 발생하므로 개체를 `Class.Instance`에 부모화하면 이 개체와 모든 자손에 대해 개별적으로 이벤트가 발생합니다.

`Class.Instance`의 **직접 자식**에만 관심이 있다면 대신 `Class.Instance.ChildAdded`를 사용하세요.

또한 `Class.Instance.DescendantRemoving`도 참조하십시오.

Instance.DescendantAdded

descendant

`Class.Instance`에 자손이 추가된 후 발생합니다.

다음 예제는 Workspace에서 제거되는 하위 항목의 이름을 출력합니다:

이 이벤트는 부모 `Class.Instance`가 변경되어 **자손** 인스턴스가 더 이상 자손이 되지 않기 **직전**에 발생합니다. `Class.Instance:Destroy()|Destroy()`는 인스턴스의 `Class.Instance.Parent|Parent`를 `nil`로 변경하므로, 부모의 자손에 대해 이 메서드를 호출하면 이 이벤트가 발생합니다.

이 이벤트가 발생할 때 자손의 부모는 변경되지 않습니다. 자손이 부모의 **직접 자식**인 경우, 이 이벤트는 `Class.Instance.ChildRemoved`보다 먼저 발생합니다.

자손이 자식이 있는 경우, 이 이벤트는 자손을 먼저 발생시키고, 그 다음 자손에 대해 발생합니다.

#### 경고

이 이벤트는 제거되는 자손 개체와 함께 발생합니다. 자손의 `Class.Instance.Parent|Parent`를 다른 것으로 변경하려고 하면 실패합니다. 다음 예는 이를 보여줍니다:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 이 함수에서는 자손의 부모를 조작하지 마십시오!
	-- 이 이벤트는 부모가 조작되어 발생하며, 변경된 사항이 아직 발생하지 않았습니다.
	-- 따라서 부모를 이렇게 변경하는 것은 문제입니다:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
또한 `Class.Instance.DescendantAdded|DescendantAdded`도 참조하십시오.

Instance.DescendantRemoving

`Class.Instance`의 자손이 제거되기 직전에 발생합니다.

이 샘플은 즉시 신호 동작을 사용할 때 인스턴스가 파괴되더라도 연결된 함수가 yield될 때까지 그대로 유지된다는 것을 보여줍니다.


이 샘플은 Deferred 신호 동작을 사용할 때, 인스턴스가 신호가 발생하기 전에 어떻게 파괴되는지를 보여줍니다.


`Class.Instance`는 연결된 함수가 여전히 사용하고 있는 동안 메모리에서 삭제되지 않습니다. 그러나 함수가 어떤 시점에서 블록되면 `Class.Instance`와 그 자손은 `nil`로 부모가 설정됩니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Immediate`로 설정되어 있는 경우, 이 이벤트는 `Class.Instance`나 그 조상의 파괴 직전에 발생합니다. `Class.Instance:Destroy()`로 파괴됩니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Deferred`로 설정되어 있는 경우, 이 이벤트는 다음 재개 지점에서 발생하며, 이 재개 지점은 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴된 후입니다.

`Enum.SignalBehavior.Deferred|Deferred` 동작을 사용할 경우, 스크립트를 자신의 `Class.Instance.Destroying` 이벤트에 연결하는 것은 문제가 될 수 있습니다. 스크립트는 콜백이 호출되기 전에 파괴되기 때문입니다(즉, 실행되지 않음).

스튜디오에서 `Class.Instance`를 삭제할 때, 탐색기를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신, 부모가 `nil`로 설정되며, 이는 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.

Instance.Destroying

`Class.Instance:Destroy()`를 통해 인스턴스가 파괴되기 직전에 발생합니다.

이 이벤트는 인스턴스의 속성 스타일이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때를 포함합니다.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경됨")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

인스턴스에서 속성 스타일이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때를 포함합니다.

이 메서드는 인스턴스에 태그를 적용하며, 태그가 이미 적용된 경우에는 아무 효과가 없습니다. 태그를 성공적으로 추가하면,
주어진 태그와 관련된 `Class.CollectionService:GetInstanceAddedSignal()`로 생성된 신호가 발생합니다.

#### 경고

- 클라이언트 측에서 추가된 인스턴스의 태그는 서버가 나중에 해당 인스턴스에 태그를 추가하거나 제거하면 제거됩니다. 서버는 모든 태그를 함께 복제하고,
이전 태그를 덮어씁니다.

- 인스턴스에 태그를 추가할 때는, 태그의 기능을 부여하기 위해 일부 리소스가 사용되는 것이 일반적입니다. 이벤트 연결이나 테이블 같은 것입니다.
메모리 누수를 방지하려면 태그가 더 이상 필요하지 않은 경우 이들을 정리하는 것이 좋습니다(연결 끊기,
`nil`로 설정 등). `Class.Instance:RemoveTag()`를 호출할 때, `Class.Instance:Destroy()`를 호출할 때,
또는 `Class.CollectionService:GetInstanceRemovedSignal()`에 의해 반환된 신호와 관련된 함수에서 이렇게 하십시오.

Instance:AddTag

인스턴스에 태그를 적용합니다.

자식 함수는 객체의 자식 배열을 반환합니다.

Instance:children

자식 객체/인스턴스의 배열입니다.

객체의 자식 배열을 반환합니다.

이 메서드는 인스턴스의 모든 자식과 자손을 제거합니다.

```
local part = Instance.new("Part")

-- 약간의 반짝임 추가
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
모든 자식 및 자손을 제거하고 싶지 않다면 `Class.Instance:GetChildren()` 또는
`Class.Instance:GetDescendants()`를 사용하여 이러한 자식/자손을 반복하고 제거할 것을 선택합니다.
예를 들어, 다음 코드 샘플은 `Class.BasePart|BaseParts` 모든 객체를 제거합니다:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

이 메서드는 인스턴스의 모든 자식을 제거합니다.

 `Class.Instance:Clone()` 를 사용하여 모델을 복제하는 방법을 보여줍니다.


`Clone()`은 인스턴스와 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`이 아닌 인스턴스는 무시합니다. 루트 인스턴스의 복사본은
이 메서드에 의해 반환되며, `Class.Instance.Parent|Parent`는 `nil`로 설정됩니다. 해당 인스턴스가
`Class.Instance.Archivable|Archivable`가 `false`로 설정되어 있는 경우, 이 메서드는
`nil`을 반환합니다.

`Class.ObjectValue.Value`와 같은 참조 속성이 복제된 인스턴스에서 설정되면, 복사본의 속성 값은
원본의 값에 따라 달라집니다:

- 참조 속성이 **또한** 복제된 인스턴스를 참조하면, 복사본은 그 복사본을 참조합니다.
- 참조 속성이 **복제되지 않은** 인스턴스를 참조하면, 동일한 값이 복사본에 유지됩니다.

Instance:Clone

인스턴스와 모든 자손의 복사본을 생성하며, `Class.Instance.Archivable|Archivable`이 아닌 인스턴스는 무시합니다.

Instance:clone

`Class.Instance:Destroy()` 함수를 사용하여 Part를 파괴하는 방법을 보여줍니다.

이 함수는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.


`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 끊고,
모든 자식에 대해 `Destroy()`를 호출합니다. 이 방법은 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

필요하지 않은 객체를 처리하는 것은 중요합니다. 왜냐하면 특히 장소에서 불필요한 객체와
연결이 메모리를 사용하여 시간이 지남에 따라 심각한 성능 문제를 유발할 수 있기 때문입니다.

`Destroy()`를 호출한 후 Best Practice로, 객체를 참조하는 모든 변수를(또는 자손)
`nil`로 설정하는 것이 좋습니다. 이렇게 하면 코드에서 해당 객체와 관련된 것을
액세스하는 것을 방지할 수 있습니다.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 아래는 하지 마세요:
print(part.Name)  --> "Hello, world"
-- 위의 줄이 작동하지 않도록 하려면 이렇게 하세요:
part = nil
```
한번 `Class.Instance`가 이 방법으로 제거되면, `Class.Instance.Parent` 속성이 잠겨 있기 때문에
다시 사용할 수 없습니다. 객체를 제거하는 대신 **일시적으로** 제거하려면,
`Class.Instance.Parent|Parent`를 `nil`로 설정하십시오. 예를 들어:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
정해진 시간 후에 객체를 제거하려면,
`Class.Debris:AddItem()`을 사용하십시오.

Instance:Destroy

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 끊고,
모든 자식에 대해 `Destroy()`를 호출합니다.

Instance:destroy

주어진 이름과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위쪽으로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

다음 코드 조각은 객체 이름이 `Car`인 첫 번째 조상을 찾습니다.

```
local car = object:FindFirstAncestor("Car")
```
특정 클래스의 조상을 찾는 이 메서드의 변형은 `Class.Instance:FindFirstAncestorOfClass()`와
`Class.Instance:FindFirstAncestorWhichIsA()`를 참조하십시오.

Instance:FindFirstAncestor

name

주어진 이름과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.

주어진 className과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위쪽으로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

이 메서드의 전형적인 사용은 `Class.BasePart`가 속한 `Class.Model`을 찾는 것입니다. 예:

```
local model = part:FindFirstAncestorOfClass("Model")
```
이 메서드는 `Class.Instance:FindFirstAncestor()`의 변형으로,
`Class.Object.ClassName` 속성을 검사하고 `Class.Instance.Name` 대신작동합니다. `Class.Instance:FindFirstAncestorWhichIsA()`도 존재하며,
상속을 고려하여 `Class.Object:IsA()` 메서드를 대신 사용합니다.

Instance:FindFirstAncestorOfClass

className

찾을 `Class.Object.ClassName`입니다.

주어진 className과 동일한 `Class.Object.ClassName`의 첫 번째 조상을 반환합니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 조상을 반환합니다.

이 메서드는 위쪽으로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

`Class.Instance:FindFirstAncestorOfClass()`와는 달리, 이 메서드는
`Class.Object:IsA()`를 사용하는데, 이는 클래스 상속을 고려합니다. 예:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
따라서 다음 코드 샘플은 첫 번째 `Class.BasePart` 조상을 반환하며, 이는 `Class.WedgePart`,
`Class.MeshPart` 또는 `Class.Part`인지 여부에 관계없이 반환됩니다.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
또한 `Class.Instance:FindFirstAncestor()`와 관련이 있습니다.

Instance:FindFirstAncestorWhichIsA

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 조상을 반환합니다.

아래 코드는 Workspace에서 객체 이름 "Brick"을 찾습니다. 찾으면,
객체의 이름을 "Foo"로 변경합니다.

지정한 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환하며,
해당 자식이 존재하지 않으면 `nil`을 반환합니다. 선택적 `recursive` 매개변수가
`true`인 경우 메서드는 `Class.Instance`의 즉각적인 자식뿐 아니라 모든 자손을 검색합니다.

#### 객체 존재 확인

`FindFirstChild()`는 이어서 진행하기 전에 객체가 존재하는지 확인해야 할 경우에
필요합니다. 점 연산자를 사용하여 이름으로 자식을 인덱싱하려고 하면,
해당 자식이 존재하지 않으면 오류가 발생합니다.

```lua
local Workspace = game:GetService("Workspace")

-- 다음 줄은 파트가 작업 공간에 존재하지 않으면 오류가 발생합니다.
Workspace.Part.Transparency = 0.5
```
더 나은 접근 방식은 `FindFirstChild()`를 사용하여 먼저 `Part`를 확인한 후,
그렇다면 필요로 하는 코드를 실행하는 `if` 문을 사용하는 것입니다.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### 속성이 일치하는 자식 찾기

때때로 객체의 `Class.Instance.Name|Name`이 `Class.Instance.Parent|Parent`의 속성과
동일할 수 있습니다. 점 연산자를 사용할 때는 이름을 공유하는 경우 속성이 자식보다
우선합니다.

다음 예에서 `Color`라는 `Class.Folder`가 `Class.Part`에 추가되고,
여기에도 `Class.Part.Color` 속성이 있습니다. `part.Color`는 자식 `Class.Folder` 인스턴스가 아닌
`Datatype.Color3` 속성 값을 참조하는 것을 참고하세요. `Class.Instance:FindFirstChild()|FindFirstChild()` 사용의
이점은 새로운 속성이 도입되어도 코드에 위험을 주지 않는다는 점입니다.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 속성
local c2 = part:FindFirstChild("Color")  -- 자식 폴더
```

#### 성능 주의 사항

`Class.Instance:FindFirstChild()|FindFirstChild()`는 점 연산자 사용보다 약 20% 더 오래 걸리며,
대부분의 객체를 참조로 저장하는 것보다 약 8배 더 오래 걸립니다. 그러므로 성능 의존 코드에서,
좁은 루프나 `Class.RunService.Heartbeat` 및 `Class.RunService.PreRender`와 관련된 함수 내에서
호출하는 것을 피해야 합니다. 대신, 결과를 변수에 저장하거나
`Class.Instance.ChildAdded|ChildAdded` 또는 `Class.Instance:WaitForChild()|WaitForChild()`를 사용하여
지정한 이름의 자식이 사용 가능해질 때를 파악하는 것을 고려하십시오.

Instance:FindFirstChild

검색할 `Class.Instance.Name`입니다.

recursive

검색이 재귀적으로 수행되어야 하는지 여부입니다.

지정한 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.

Instance:findFirstChild

주어진 `className`과 동일한 `Class.Instance`의 첫 번째 자식을 반환합니다.
`Class.Instance:FindFirstChildWhichIsA()`와는 달리, 이 메서드는
클래스 상속을 무시하고 클래스가 `className`과 일치하는 객체만 반환합니다.
일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다.

Instance:FindFirstChildOfClass

주어진 className과 동일한 `Class.Object.ClassName|ClassName`을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 자식을 반환합니다.

일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다. 선택적
재귀 매개변수는 true인 경우, 이는 `Class.Instance`의 직접적인 자식뿐 아니라
모든 자손을 검색합니다.

`Class.Instance:FindFirstChildOfClass()`와는 달리, 이 메서드는
`Class.Object:IsA()`를 사용하여 클래스 상속을 존중합니다. 예:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
따라서 다음 코드 샘플은 첫 번째 `Class.BasePart` 자식을 반환하며, 이는 `Class.WedgePart`,
`Class.MeshPart` 또는 `Class.Part`인지 여부와 관계없이 반환될 것입니다.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
이름으로 자식을 찾고자 하는 개발자는 대신 `Class.Instance:FindFirstChild()`를 사용해야 합니다.

Instance:FindFirstChildWhichIsA

검색할 `Class.Object.ClassName`입니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 자식을 반환합니다.

지정된 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

이 메서드는 비활성화되어 사용할 수 없습니다. 인스턴스의 첫 번째 자손을 찾으려면,
대신 `Class.Instance:FindFirstChild()`의 `recursive` 매개변수를 사용하는 것이 좋습니다.

Instance:FindFirstDescendant

지정된 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

`Class.Instance`가 `Class.Actor`인 경우,
`Class.Actor` 자체가 반환됩니다. 그렇지 않은 경우 가장 가까운 조상인 `Class.Actor`가 반환됩니다.
조상이 `Class.Actor`가 없는 경우, 결과는 `nil`이 됩니다.

Instance:GetActor

`Instance`와 연결된 `Class.Actor`를 반환합니다(존재하는 경우).

이 메서드는 주어진 속성 이름에 할당된 값을 반환합니다. 속성이 할당되지 않은 경우,
`nil`을 반환합니다.

예를 들어 다음 코드 조각은 인스턴스의 `InitialPosition` 속성을 설정한 다음 값을 가져옵니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### 참조

- 주어진 이름으로 속성을 설정하는 `Class.Instance:SetAttribute()`.
- 인스턴스의 각 속성에 대한 키-값 쌍의 사전을 반환하는 `Class.Instance:GetAttributes()`입니다.

Instance:GetAttribute

주어진 속성 이름에 할당된 값입니다. 속성이 할당되지 않은 경우,
`nil`을 반환합니다.

주어진 속성 이름에 할당된 값을 반환합니다.

이 메서드는 특정 속성이 변경될 때 발생하는 이벤트를 반환합니다. `Class.Object.Changed|Changed`
이벤트와 정확히 동일하게 작동하지만, 특정 주어진 속성이 변경될 때만 발생합니다.

일반적으로 속성 이름을 확인하는 함수와 함께 `Class.Object.Changed|Changed`에 대한 연결 대신 이
메서드를 사용하는 것이 좋습니다. 동일한 객체에서 동일한 속성 이름을 가진 다음 호출되는 이 메서드는 동일한 이벤트를 반환합니다.

다음 코드 예는 파트의 `InitialPosition` 속성이 변경될 때 `attributeChanged()` 함수를 발생시킵니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
또한 인스턴스의 변경 속성이 발생할 때마다 발생하는 `Class.Instance.AttributeChanged`도 참조하십시오.

Instance:GetAttributeChangedSignal

변경 신호가 반환되는 지정된 속성의 이름입니다.

주어진 속성이 변경될 때 발생하는 이벤트입니다.

지정된 속성이 변경될 때 발생하는 이벤트를 반환합니다.

이 메서드는 각 속성에 대한 키-값 쌍의 사전을 반환합니다. 여기서 키는 속성 이름이며,
값은 비-`nil` 값입니다.

예를 들어 다음 코드 조각은 인스턴스의 속성과 값을 출력합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
주어진 속성 이름에 할당된 값을 반환하는 `Class.Instance:GetAttribute()`도 참조하세요.

Instance:GetAttributes

각 속성에 대해 문자열 → 변형 쌍의 사전입니다. 여기서 문자열은 속성의 이름이고, 변형은 비-`nil` 값입니다.

인스턴스의 속성 사전을 반환합니다.

아래 코드는 실행 시 워크스페이스에 있는 모든 객체의 이름을 출력합니다.

인스턴스의 모든 직접적인 자식을 포함하는 배열(숫자 색인 표)을 반환하거나,
`Class.Instance`는 객체에서 `Class.Instance.Parent|Parent`와 동일합니다. 배열은 숫자 또는 일반 `for` 루프를 사용하여 반복할 수 있습니다:

```lua
local Workspace = game:GetService("Workspace")

-- 숫자 루프 예
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " is child number " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- 일반 루프 예
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. i)
end
```
반환된 배열은 특정 순서로 **정렬되지 않는다**는 점에 유의해야 하며,
이 메서드에서 반환된 자식을 정렬하고자 할 경우 수동 정렬(`Library.table.sort()`)을 권장합니다.

또한 `Class.Instance:GetDescendants()|GetDescendants()` 메서드도 참조하세요.

Instance:GetChildren

인스턴스 자식을 포함하는 배열입니다.

인스턴스의 모든 자식을 포함하는 배열을 반환합니다.

Instance:getChildren

로블록스에서 내부적으로 사용되는 디버그 ID의 인코딩 문자열을 반환합니다. 다음과 같이:

- 이 항목은 보호됩니다. `Class.Script` 또는 `Class.LocalScript` 내에서 사용할 경우 오류가 발생합니다.
- 디버그 ID는 디버깅 프로세스에 사용되는 ID입니다. 이는 디버거가
응용 프로그램이 프로세스 하기 전에 각 명령을 읽을 수 있도록 합니다. 로블록스의 모든 객체는
프로세스처럼 작동하며 디버그할 수 있는 각 실행 명령(또는 '코드')을 가지고 있습니다.
- 유사한 객체를 구별해야 하는 플러그인에 도움이 될 수 있습니다.
(예: 이름이 같은 객체들)

Instance:GetDebugId

scopeLength

로블록스에서 내부적으로 사용되는 디버그 ID의 인코딩 문자열을 반환합니다.

GetDescendants는 특정 유형의 객체에 속한 모든 자손에게 무언가를 수행하는 데 자주 사용됩니다. 이 예제의 코드는 GetDescendants와
`Class.Instance:IsA()`를 사용하여 작업 공간의 모든 부품을 찾아 녹색으로 변경합니다.

이 객체 메서드는 객체의 모든 자손을 포함하는 배열을 반환합니다.
`Class.Instance:GetChildren()`와는 달리,
객체의 직접 자식만 반환하지 않고, 객체의 모든 자식,
자식의 모든 자식 등을 찾습니다.

반환된 배열은 특정 순서로 **정렬되지 않으므로**, 수동 정렬(`Library.table.sort()`)을 권장합니다.
이 메서드의 반환된 자손을 포괄적으로 쿼리하려면 `Class.Instance:QueryDescendants()|QueryDescendants()` 메서드를 고려하세요.

Instance:GetDescendants

인스턴스의 자손을 포함하는 배열입니다.

인스턴스의 모든 자손을 포함하는 배열을 반환합니다.

이 코드 샘플은 `Class.Instance:GetFullName()`의 동작을 보여줍니다.
`DataModel` 계층에 없는 객체에서 호출될 때 함수가 어떻게 작동하는지 보여주며, 
반환값이 특수 문자를 탈출하지 않는 방법도 보여줍니다.

이 코드 샘플은 `Class.Instance:GetFullName()` 함수를 Lua로 다시 구현합니다.

인스턴스의 계보를 설명하는 문자열을 반환합니다. 문자열은 `Class.Instance.Name|Name`과
조상들을 마침표로 구분하여 연결한 것입니다. `Class.DataModel`(`game`)은 고려되지 않습니다.
예를 들어, `Class.Workspace`의 `Class.Part`가 `Class.Workspace.Part`를 반환할 수 있습니다.

`Class.DataModel`의 자손이 아닌 `Class.Instance`에서 이 메서드를 호출하면, 이 메서드는
가장 위쪽의 `Class.Instance.Parent|Parent`가 없는 조상까지 고려하게 됩니다.

이 메서드는 로깅 및 디버깅에 유용합니다. 반환된 문자열을 유용한 작업을 위해 구문 분석하려고 시도하는 것은
하지 말아야 합니다. 이 메서드는 객체 이름에서 마침표(또는 다른 기호)를 이스케이프하지 않습니다.
즉, 출력은 종종 유효한 Luau 식별자로 보이지만 보장되지 않습니다.

Instance:GetFullName

`Class.Instance`의 전체 이름입니다.

인스턴스의 계보를 설명하는 문자열을 반환합니다.

이 메서드는 지정된 속성의 스타일이 지정된 값이나 명시적으로 수정된 값을 반환합니다. 그렇지 않다면,
수정되지 않은 기본 속성 값을 반환합니다. 이는 `[GuiObject].Rotation`과 같이 속성 값을 직접 액세스할 때와
약간 다릅니다. 기본 또는 수정된 속성의 값을 반환합니다.

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- 버튼에 대한 참조
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (기본값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 규칙 속성을 통해 회전 적용
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (규칙을 기반으로 한 스타일 값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 속성을 명시적으로 수정/재정의
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (수정된 값)
print(button.Rotation) --> 45 (수정된 값)
```

Instance:GetStyled

selector

인스턴스에서 타겟팅할 의사 인스턴스에 대한 선택적 선택자입니다.

지정된 속성의 스타일이 지정된 또는 명시적으로 수정된 값. 수정되지 않은 경우,
기본 속성 값을 반환합니다.

지정된 속성의 스타일이 지정된 값이나 명시적으로 수정된 값을 반환하거나,
수정되지 않은 경우 기본 속성 값을 반환합니다.

이 메서드는 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 이벤트와 정확히
동일하게 동작하는 이벤트를 반환하지만, 주어진 스타일 속성이 변경될 경우에만 발생합니다.
일반적으로 이 메서드를 사용하는 것이 속성 이름을 확인하는 함수와 함께
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`에 대한 연결을 사용하는 것보다 좋습니다.
동일한 객체에서 동일한 속성 이름을 가진 다음 호출되는 이 메서드는 동일한 이벤트를 반환합니다.

다음 코드 조각은 `AnchorPoint` 속성이 변경될 때 `stylePropertyChanged()` 함수가 발생하는
신호를 반환합니다:

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경되었습니다!")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```

Instance:GetStyledPropertyChangedSignal

property

변경 사항을 듣고 싶은 스타일 속성 이름입니다.

주어진 스타일 속성이 변경될 경우 발생하는 이벤트입니다.

이 메서드는 주어진 인스턴스에 적용된 태그의 문자열 배열을 반환합니다.
태그를 추가하려면 스튜디오에서 [속성](/studio/properties) 창을 사용하거나,
`Class.Instance:AddTag()|AddTag()`로 런타임에서 추가할 수 있습니다.

이 메서드는 인스턴스의 여러 태그에 동시에 작업을 수행할 때 유용합니다. 그러나
단일 태그의 존재를 확인하는 데는 비효율적이므로, 특정 태그를 확인하려면
`Class.Instance:HasTag()|HasTag()`을 사용하세요.

Instance:GetTags

인스턴스에 적용된 모든 태그의 배열을 가져옵니다.

이 메서드는 제공된 태그가 객체에 추가된 경우에는 `true`를 반환합니다.
태그는 스튜디오에서 [속성](/studio/properties) 창을 사용하거나,
런타임에 `Class.Instance:AddTag()|AddTag()`로 추가할 수 있습니다.

Instance:HasTag

인스턴스에 주어진 태그가 있는지 확인합니다.

하나의 인스턴스가 다른 인스턴스의 조상인지 확인하는 방법을 보여줍니다.
`Class.Instance:IsAncestorOf()`

Workspace와 SpawnLocation은 SpawnLocation의 데칼의 조상입니다.
Workspace는 SpawnLocation의 조상입니다.

SpawnLocation과 그 데칼은 Workspace의 자손이지 조상이 아닙니다.
Decal은 SpawnLocation의 자손이지 조상이 아닙니다.


`Class.Instance`가 주어진 자손의 조상인지 확인합니다.

`Class.Instance`는 객체의 `Class.Instance.Parent` 또는 부모 `Class.Instance.Parent`
가 `Class.Instance`로 설정된 경우에는 그 객체의 조상으로 간주됩니다.

또한, `Class.Instance:IsDescendantOf()`를 참조하세요.

Instance:IsAncestorOf

주어진 자손의 조상이면 `true`입니다.

`Class.Instance`가 주어진 자손의 조상인지 확인합니다.

`Class.Instance`가 주어진 조상의 자손인지 확인합니다.

`IsDescendantOf()`는 `nil` 매개변수를 사용하여 객체가 제거되었는지를 확인할 수 없습니다.

또한 `Class.Instance:IsAncestorOf()`를 참조하세요.

Instance:IsDescendantOf

ancestor

주어진 조상의 자손이면 `true`입니다.

`Class.Instance`가 주어진 조상의 자손인지 확인합니다.

Instance:isDescendantOf

이 메서드는 특정 속성이 코드로 생성된 기본값으로부터 수정되었는지를 표시합니다.
코드(`Datatype.Instance.new()`)를 통해 새로 생성된 인스턴스에서 호출하면 이 메서드는 `false`를 반환합니다.
스튜디오 작업 흐름 중
[Explorer](/studio/explorer) 창 삽입으로 새로 생성된 객체에서는 결과가 달라질 수 있습니다.

예를 들어 [Explorer](/studio/explorer) 창을 통해 삽입된 `Class.TextLabel`의
`Class.TextLabel.BackgroundColor3|BackgroundColor3` 속성을 쿼리하면 `true`를 반환하지만,
`Datatype.Instance.new()`로 생성된 같은 속성의 경우 `false`를 반환합니다.
다른 변경이 없다면 말입니다.

이 메서드는 서비스 및 사용자 생성 인스턴스에만 유용한 결과를 반환한다는 점에 유의하십시오.
`Class.PackageLink`와 같은 시스템이 채운 속성에 대한 반환값은 정의되지 않은 동작입니다.

이 메서드가 `true`를 반환하는 경우, 스타일링은 **속성**에 영향을 미치지 않으며,
속성을 수정하는 것이 스타일링을 우선시합니다. 속성을 코드로 생성된 기본값으로 초기화하고,
스타일링 할 수 있게 하려면 `Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`을 사용하십시오.

Instance:IsPropertyModified

속성이 수정되었는지 여부를 나타내는 부울입니다.

지정된 속성에 저장된 값이 코드로 생성된 기본값과 같지 않을 경우 `true`를 반환합니다.

이 객체 메서드는 제공된 `selector` 문자열과 일치하는 객체의 모든 자식 요소를 포함하는 배열을 반환합니다. `selector`는 클래스 이름, 인스턴스 이름, 계층 관계와 같은 특성을 일치시키기 위해 여러 선택자 및 조합자를 포함할 수 있으며, 인스턴스 속성 및 특성의 특정 값도 포함할 수 있습니다. `selector` 문법은 `Class.StyleRule`에서 사용되는 문법과 유사하지만, 지원되는 부분이나 지원되지 않는 부분에 몇 가지 차이가 있습니다.

#### 선택자

- `ClassName` — 지정된 클래스의 인스턴스와 `Class.Object:IsA()` 관계가 일치합니다.
- `.Tag` — `Class.CollectionService` 태그가 있는 인스턴스와 일치합니다.
- `#Name` — 특정 `Class.Instance.Name`의 인스턴스와 일치합니다.
- `[property = value]` — 지정된 속성이 있으며 해당 속성이 지정된 값인 인스턴스와 일치합니다. 불린, 숫자, 및 문자열 값이 지원됩니다. 문자, 숫자, `_`, 및 `-`는 값에 따옴표를 넣지 않고 사용할 수 있습니다.
- `[$attribute]` — 지정된 [속성](/studio/properties#instance-attributes)이 설정된 인스턴스와 일치합니다.
- `[$attribute = value]` — 지정된 속성이 **그리고** 해당 속성이 지정된 값인 인스턴스와 일치합니다. 속성 선택자와 동일한 제한이 적용됩니다. 속성이 없음을 확인하려면 `nil`로 쿼리하지 마십시오. 대신 `:not` 의사 클래스를 사용하여 `:not([$attribute])`처럼 사용하세요.

선택자는 조합할 수도 있습니다. 예를 들어,
`Model.Apple[$Variety = Fuji][$Flavor = 4]`는 `Class.Model`로 태그된 `Apple` 인스턴스 중 `Variety` 속성이 `Fuji`와 같고 `Flavor` 속성이 `4`와 같은 인스턴스와 일치합니다.

```lua
local Workspace = game:GetService("Workspace")

-- 모든 MeshPart 자식 요소 가져오기
print(Workspace:QueryDescendants("MeshPart"))

-- "Fruit"로 태그된 모든 자식 요소 가져오기
print(Workspace:QueryDescendants(".Fruit"))

-- 이름이 "RedTree"인 모든 자식 요소 가져오기
print(Workspace:QueryDescendants("#RedTree"))

-- CanCollide 속성이 false로 설정된 모든 자식 요소 가져오기
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- "FuelCapacity" 속성이 할당된 모든 자식 요소 가져오기
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- "FuelCapacity" 속성이 75로 설정된 모든 자식 요소 가져오기
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### 조합자

조합자는 기본 선택자를 혼합하여 더 깊은 계층 관계를 일치시킬 수 있습니다.

- `>` — 이전 필터 일치 요소의 **직계 자식** 인스턴스와 일치합니다.

- `>>` — 이전 필터 일치 요소의 **자식** 인스턴스와 일치합니다. 이는 기본 첫 번째 필터로, `SpotLight.Red`는 `>> SpotLight.Red`와 동일합니다.

- `,` — 자식 쿼리를 위한 여러 독립 선택자의 목록을 지정합니다. 필터와 일치하는 요소만 반환 배열에 포함되며, 쿼리 목록에서 일치하지 않는 경우 `nil`은 포함되지 않습니다.

```lua
local Workspace = game:GetService("Workspace")

-- "SwordPart"로 태그된 어떤 모델의 직계 자식 가져오기
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Part이고 "Apple"로 태그된 직계 자식 가져오기
print(Workspace:QueryDescendants("> Part.Apple"))

-- "OnFire" 속성이 true로 설정된 어떤 모델의 자식 가져오기
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- "SwordPart"로 태그된 MeshPart 자식 또는 "OnFire" 속성이 true로 설정된 자식 가져오기
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### 의사 클래스 선택자

- `:not(complex-selector-list)` — 안의 선택자 중 어떤 것도 **일치하지 않는** 인스턴스를 선택할 수 있습니다. 선택자의 부정 수행이 가능합니다. 내부 표현식은 복합 선택자 목록이므로, 여러 조건에 따라 필터링하는 것이 가능합니다.

- `:has(relative-selector-list)` — 내부에 포함된 인스턴스에 따라 인스턴스를 선택할 수 있습니다. 선택자 목록은 각 인스턴스에 대해 상대적으로 평가됩니다.

```lua
local Workspace = game:GetService("Workspace")

-- 클래스 SpotLight가 아닌 모든 자식 요소 가져오기
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- 클래스 SpotLight 또는 PointLight가 아닌 모든 자식 요소 가져오기
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- "OnFire" 속성이 없는 모든 자식 요소 가져오기
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- "SwordPart"로 태그된 모델의 자식을 제외한 모든 자식 요소 가져오기
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Tool 인스턴스를 자신의 자식으로 포함하고 있는 자식 가져오기
print(Workspace:QueryDescendants(":has(Tool)"))
-- "SwordPart"로 태그된 직계 자식을 포함하는 MeshPart 자식 가져오기
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- SurfaceAppearance 또는 Texture 클래스가 아닌 직계 자식을 가진 MeshPart 자식 가져오기
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

요소를 필터링하는 데 사용되는 선택자 문자열입니다.

인스턴스 배열(선택 시스템과 일치하지 않는 경우 비어 있음)입니다.

지정된 `selector` 문자열과 일치하는 인스턴스의 모든 자식 요소를 포함하는 배열을 반환합니다.


다음 코드는 부품이 제거된 후 데이터 모델에 다시 추가되는 방법을 보여줍니다:

이 메서드는 객체의 `Class.Instance.Parent`를 `nil`로 설정하고, 모든 자손에 대해 똑같이 수행합니다.

객체가 제거되기 전에 참조되는 경우, 나중에 객체를 다시 가져올 수 있습니다.

Instance:Remove

객체의 `Parent`를 `nil`로 설정하고, 모든 자손의 `Parent`도 같습니다.

Instance:remove

이 메서드는 인스턴스에서 태그를 제거합니다. 객체가 태그를 가지고 있지 않은 경우에는 오류를 발생시키지 않습니다.
태그를 성공적으로 제거하면, 주어진 태그를 가진 `Class.CollectionService:GetInstanceRemovedSignal()`로 생성된 신호가 발생합니다.

인스턴스에 태그를 추가할 때는, 태그의 기능성을 부여하기 위해 일부 리소스를 사용하는 것이 일반적입니다.
예를 들어 이벤트 연결이나 테이블 등이 있습니다. 메모리 누수를 예방하려면, 태그가 더 이상 필요하지 않을 경우 이들을 정리
(disconnect, `nil`로 설정 등)하는 것이 좋습니다.

Instance:RemoveTag

인스턴스에서 태그를 제거합니다.

속성을 기본값으로 재설정합니다. 예를 들어, `Class.TextLabel`에서 `ResetPropertyToDefault("Rotation")`를 호출하는 것은 `Class.TextLabel.Rotation|Rotation`을 `0`(속성의 기본값)으로 설정하는 것과 동일합니다. 이 방법은 스타일링이 이 속성의 기본값을 덮어쓰도록 보장하는 데 사용할 수 있습니다.

Instance:ResetPropertyToDefault

속성을 기본값으로 재설정합니다.

이 방법은 주어진 이름으로 속성을 주어진 값으로 설정합니다. `nil`이 주어지면 속성이 제거되고, 기본적으로 `nil`이 반환됩니다.

예를 들어, 다음 코드는 인스턴스의 `InitialPosition` 속성을 `Datatype.Vector3|Vector3.new(0, 10, 0)`으로 설정합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

#### 제약 사항

이름 요구사항 및 제한사항:

- 이름은 알파벳과 숫자만 사용해야 합니다.
  - 마침표, 하이픈, 슬래시 및 밑줄을 포함할 수 있습니다.
- 공백이나 고유 기호(@, ~, !)는 허용되지 않습니다.
- 문자열은 100자 이하이어야 합니다.
- **RBX**로 시작하는 이름은 허용되지 않으며, 호출자가 Roblox의 핵심 스크립트인 경우에만 사용 가능합니다(로블록스 전용).

지원되지 않는 타입으로 속성을 설정하려고 하면 오류가 발생합니다.

#### 참조

- `Class.Instance:GetAttribute()`는 주어진 속성 이름에 할당된 값을 반환합니다.
- `Class.Instance:GetAttributes()`는 인스턴스의 각 속성에 대한 키-값 쌍의 딕셔너리를 반환합니다.

Instance:SetAttribute

value

지정된 속성에 설정할 값입니다.

주어진 이름으로 속성을 주어진 값으로 설정합니다.

다음 코드는 "Part"라는 이름의 인스턴스가
Workspace에 추가될 때까지 기다립니다.

주어진 이름을 가진 `Class.Instance`의 자식을 반환합니다. 자식이 존재하지 않으면 존재할 때까지 현재 스레드를 블록합니다. `timeOut` 매개변수가 지정된 경우 이 방법은 지정된 초 후에 타임아웃되고 `nil`을 반환합니다.

#### 주요 사용법

`Class.Instance:WaitForChild()|WaitForChild()`는 `Class.LocalScript`에서 클라이언트가 실행하는 코드를 작업할 때 매우 중요합니다. Roblox 엔진은 서버에서 클라이언트로 개체가 복제되는 시간이나 순서를 보장하지 않습니다. 또한, 경험이 `Class.Workspace.StreamingEnabled`가 true로 설정된 경우 플레이어의 캐릭터에서 멀리 떨어진 `Class.BasePart|BaseParts`가 클라이언트에 스트리밍되지 않을 수 있으므로 클라이언트에 아직 존재하지 않는 개체를 인덱스할 때 스크립트가 제대로 작동하지 않을 수 있습니다.

#### 참고 사항

- 이 메서드는 호출 시 주어진 이름의 자식이 존재하는 경우 블록하지 않습니다.
- `Class.Instance:FindFirstChild()`는 존재할 것으로 가정되는 개체에 대해 `Class.Instance:WaitForChild()|WaitForChild()`보다 더 효율적인 대안입니다.
- 이 방법의 호출이 반환 없이 5초를 초과하면 스레드가 무한히 블록될 수 있다는 경고가 출력됩니다.

Instance:WaitForChild

주어진 이름을 가진 `Class.Instance`의 자식을 반환합니다. 자식이 존재하지 않으면 존재할 때까지 현재 스레드를 블록합니다.

Instance

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리에 포함될 수 있습니다.

/reference/engine/classes/SceneAnalysisService.yaml