하나의 `InputBinding`은 부모 `Class.InputAction`을 트리거해야 하는 하드웨어 바인딩을 정의합니다.
예를 들어, 키 누르기, 게임패드 버튼, 또는 터치 가능한 장치에서의 탭 등이 있습니다. 여러 개의 `InputBinding` 인스턴스가 `Class.InputAction`에 부모로 존재할 수 있습니다.

주어진 상태로 부모 `Class.InputAction`을 프로그래밍 방식으로 업데이트하고,
적절한 신호(`Class.InputAction.Pressed|Pressed`,
`Class.InputAction.Released|Released`,
`Class.InputAction.StateChanged|StateChanged`)를 발생시킵니다.

이 메서드는
`Class.InputBinding.Type|Type`이 `Enum.InputBindingType|Scriptable`로 설정된
바인딩에 대해서만 호출할 수 있습니다.
`Enum.InputBindingType|Automatic` 바인딩에서 호출하면
오류가 발생합니다.

`state` 매개변수는 부모 `Class.InputAction`의
`Class.InputAction.Type|Type`과 일치해야 합니다:

- `Enum.InputActionType|Bool`는 `boolean`을 기대합니다.
- `Enum.InputActionType|Direction1D`는 `number`를 기대합니다.
- `Enum.InputActionType|Direction2D`는 `Datatype.Vector2`를 기대합니다.
- `Enum.InputActionType|Direction3D`는 `Datatype.Vector3`를 기대합니다.
- `Enum.InputActionType|ViewportPosition`은 `Datatype.Vector2`를 기대합니다.

불일치가 발생하면 오류가 발생합니다. 이 메서드는 하드웨어 입력과 같은 중복 제거 규칙을 준수하며,
같은 상태 값에 대한 연속 호출은 이벤트를 재발생시키지 않습니다.

부모 `Class.InputAction`은 `Class.InputAction.Enabled|Enabled`
여야 하며, 그 조상 `Class.InputContext`도
`Class.InputContext.Enabled|Enabled`여야 하므로,
그렇지 않으면 호출은 조용히 무시됩니다.

InputBinding:Fire

state

적용할 상태 값; 부모 동작의
`Class.InputAction.Type|Type`과 일치해야 합니다.

이 바인딩을 통해 부모 `Class.InputAction` 상태를 프로그래밍 방식으로 업데이트합니다.

InputBinding

방향적으로 "뒤쪽" 입력을 `Class.InputAction:GetState()|GetState()` 및 부모 `Class.InputAction`의 `Class.InputAction.StateChanged|StateChanged` 이벤트에 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다. 부모 동작의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction3D`인 경우에만 적용되며, 이 경우 전송된 값은 `Datatype.Vector3`이며 `Datatype.Vector3.Z|Z` 구성 요소는 `0`과 `1` 사이에 위치합니다.

InputBinding.Backward

부모 `Class.InputAction`에 방향성 "뒤로" 입력을 분배하기 위한 대체 `Enum.KeyCode`를 지정합니다.

결합된 복합 방향 벡터가 그 길이를 초과할 경우에만 최대 크기 `1`로 정규화되는지 여부를 결정합니다. 이는 대각선 복합 입력(예: `Class.InputBinding.Up|Up`과 `Class.InputBinding.Right|Right`가 동시에 눌리는 경우)이 `1`을 초과하는 크기를 생성하지 않도록 하여, 눌린 키에 관계없이 일관된 이동 속도를 보장합니다. 기본값은 `true`입니다.

이 속성은 부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction1D`, `Enum.InputActionType|Direction2D` 또는 `Enum.InputActionType|Direction3D`일 때만 적용됩니다.

입력 축이 서로 독립적으로 유지되어야 할 때(예: 3D 자유 카메라 이동) 또는 원시 값이 `1`을 초과할 수 있는 입력을 결합할 때(예: 마우스 휠 속도) 이 값을 `false`로 설정하여 스케일링을 직접 처리할 수 있습니다.


InputBinding.ClampMagnitudeToOne

복합 방향 입력을 최대 크기 `1`로 정규화하는 방법을 지정합니다.


이 바인딩을 시각적으로 나타내는 사용자 정의 `Datatype.Content` 이미지 자산입니다(예: 게임패드 버튼 이미지 또는 스타일화된 키 그래픽).

비어 있을 경우(기본값), 사용자 정의 이미지가 제공되지 않습니다. 개발자는 `Class.UserInputService:GetImageForKeyCode()`를 사용하여 플랫폼에 적합한 이미지를 얻을 수 있습니다. 이를 `Class.InputAction.PreferredBinding`과 함께 사용하여 플레이어의 활성 입력 장치를 자동으로 반영하는 키 바인딩 UI를 구축할 수 있습니다.


InputBinding.DisplayImage

이 바인딩에 대해 표시할 사용자 정의 이미지 자산입니다.


UI 요소에서 이 바인딩에 대해 표시되는 이름을 재정의하는 사용자 정의 문자열입니다(예: 기본 키 이름 "F" 대신 "FIGHT"로 표시).

비어 있을 경우(기본값), 사용자 정의 이름이 제공되지 않습니다. 개발자는 `Class.UserInputService:GetStringForKeyCode()`를 사용하여 플랫폼에 적합한 키 이름을 얻을 수 있습니다. 이를 `Class.InputAction.PreferredBinding`과 함께 사용하여 플레이어의 활성 입력 장치를 자동으로 반영하는 키 바인딩 UI를 구축할 수 있습니다.


InputBinding.DisplayName

이 바인딩에 대한 사용자 정의 표시 텍스트입니다.


부모 `Class.InputAction`의 `Class.InputAction:GetState()|GetState()` 및 `Class.InputAction.StateChanged|StateChanged` 이벤트에 방향적으로 "아래" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction1D`일 때, 전송된 값은 `0`과 `-1` 사이의 숫자가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction2D`일 때, 전송된 값은 `Datatype.Vector2`로, 그 `Datatype.Vector2.Y|Y` 구성 요소는 `0`과 `-1` 사이가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction3D`일 때, 전송된 값은 `Datatype.Vector3`로, 그 `Datatype.Vector3.Y|Y` 구성 요소는 `0`과 `-1` 사이가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Bool`일 때는 적용되지 않습니다.


InputBinding.Down

부모 `Class.InputAction`에 방향적으로 "아래" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.


부모 `Class.InputAction`의 `Class.InputAction:GetState()|GetState()` 및 `Class.InputAction.StateChanged|StateChanged` 이벤트에 방향적으로 "앞" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다. 부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction3D`일 때만 적용되며, 이 경우 전송된 값은 `Datatype.Vector3`로, 그 `Datatype.Vector3.Z|Z` 구성 요소는 `0`과 `-1` 사이가 됩니다.


InputBinding.Forward

부모 `Class.InputAction`에 방향적으로 "앞" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.


부모 `Class.InputAction`을 트리거하는 `Enum.KeyCode`를 지정합니다. 코드 유형은 입력 액션의 `Class.InputAction.Type|Type`과 일치해야 하며, 예를 들어 `Enum.InputActionType|Bool`의 경우 `Enum.KeyCode.E`, `Enum.InputActionType|Direction2D`의 경우 `Enum.KeyCode.Thumbstick1`이 됩니다. 유형 불일치는 `Class.InputAction`을 트리거하지 않거나 `Class.InputAction.StateChanged|StateChanged` 이벤트가 변환된 값을 수신하게 됩니다.


InputBinding.KeyCode

부모 `Class.InputAction`을 트리거하는 `Enum.KeyCode`를 지정합니다.


부모 `Class.InputAction`의 `Class.InputAction:GetState()|GetState()` 및 `Class.InputAction.StateChanged|StateChanged` 이벤트에 방향적으로 "왼쪽" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction2D`일 때, 전송된 값은 `Datatype.Vector2`로, 그 `Datatype.Vector2.X|X` 구성 요소는 `0`과 `-1` 사이가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction3D`일 때, 전송된 값은 `Datatype.Vector3`로, 그 `Datatype.Vector3.X|X` 구성 요소는 `0`과 `-1` 사이가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction1D` 또는 `Enum.InputActionType|Bool`일 때는 적용되지 않습니다.


InputBinding.Left

부모 `Class.InputAction`에 방향적으로 "왼쪽" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.


InputBinding.PointerIndex

`Class.InputAction`을 트리거하기 위한 숫자 값으로, `Class.InputAction.Type|Type`이 `Enum.InputActionType|Bool`입니다. 예를 들어 게임패드 트리거인 `Enum.KeyCode.ButtonL2`가 `0.5`를 초과할 때(반쯤 눌림)입니다. 기본값은 `0.5`입니다.

이 속성은 `Class.InputBinding.ReleasedThreshold|ReleasedThreshold`보다 크거나 같아야 하며, 그렇지 않으면 `Class.InputBinding.ReleasedThreshold|ReleasedThreshold`로 제한됩니다.


InputBinding.PressedThreshold

`Class.InputAction`을 트리거하기 위한 숫자 값으로, `Class.InputAction.Type|Type`이 `Enum.InputActionType|Bool`입니다.


바인딩에 대한 필수 수정자로 작용하는 `Enum.KeyCode`를 지정합니다. `Class.InputBinding`은 이 입력이 `Class.InputBinding.KeyCode|KeyCode`, `Class.InputBinding.UIButton|UIButton` 또는 복합 방향보다 먼저 눌릴 경우에만 부모 `Class.InputAction`을 트리거합니다.

`Class.InputBinding.PrimaryModifier|PrimaryModifier`와 `Class.InputBinding.SecondaryModifier|SecondaryModifier` 간에는 순서 요구 사항이 없습니다. 두 속성이 모두 설정된 경우 두 수정자가 모두 눌려야 바인딩이 활성화되지만, 눌리는 순서는 중요하지 않습니다.

`Enum.KeyCode.Unknown`으로 설정된 경우, 기본 수정자가 필요하지 않습니다.


InputBinding.PrimaryModifier

바인딩을 활성화하기 위해 눌러야 하는 기본 `Enum.KeyCode`를 지정합니다.


`Class.InputAction`을 트리거하기 위한 숫자 값으로, `Class.InputAction.Type|Type`이 `Enum.InputActionType|Bool`입니다. 예를 들어 게임패드 트리거인 `Enum.KeyCode.ButtonL2`가 `0.5` 미만일 때(반쯤 눌리지 않음)입니다. 기본값은 `0.2`입니다.

이 속성은 `Class.InputBinding.PressedThreshold|PressedThreshold`보다 작거나 같아야 하며, 그렇지 않으면 `Class.InputBinding.PressedThreshold|PressedThreshold`로 제한됩니다.


InputBinding.ReleasedThreshold

게임패드 스틱 입력의 민감도를 제어하기 위해 제곱 응답 곡선을 적용하는 숫자 값입니다. 일반적으로 카메라 제어에 사용되어 작은 스틱 입력을 더 정밀하게 만들고, 큰 움직임을 허용하기 위해 빠르게 증가합니다.

`1`에서 `10` 사이의 범위이며, 더 높은 값은 더 강한 곡선을 제공합니다. 기본값은 `1`이며, 이 경우 입력은 수신된 대로 반환됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction2D`이고 `Class.InputBinding.KeyCode|KeyCode`가 `Enum.KeyCode.Thumbstick1|Thumbstick1` 또는 `Enum.KeyCode.Thumbstick2|Thumbstick2`일 때만 적용됩니다.


InputBinding.ResponseCurve

더 정밀한 스틱 조준을 위한 스케일링을 구성하는 숫자 값입니다.


부모 `Class.InputAction`의 `Class.InputAction:GetState()|GetState()` 및 `Class.InputAction.StateChanged|StateChanged` 이벤트에 방향적으로 "오른쪽" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction2D`일 때, 전송된 값은 `Datatype.Vector2`로, 그 `Datatype.Vector2.X|X` 구성 요소는 `0`과 `1` 사이가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction3D`일 때, 전송된 값은 `Datatype.Vector3`로, 그 `Datatype.Vector3.X|X` 구성 요소는 `0`과 `1` 사이가 됩니다.

부모 액션의 `Class.InputAction.Type|Type`이 `Enum.InputActionType|Direction1D` 또는 `Enum.InputActionType|Bool`일 때는 적용되지 않습니다.


InputBinding.Right

부모 `Class.InputAction`에 방향적으로 "오른쪽" 입력을 전송하기 위한 대체 `Enum.KeyCode`를 지정합니다.


출력 값의 모든 구성 요소에 균일하게 적용되는 스칼라 배수입니다. `Class.InputAction` 유형 `Enum.InputActionType|Direction1D`, `Enum.InputActionType|Direction2D`, 및 `Enum.InputActionType|Direction3D`에 적용됩니다.

개별 구성 요소를 독립적으로 스케일링하려면 `Class.InputBinding.Vector2Scale|Vector2Scale`(예: `Enum.InputActionType|Direction2D`) 또는 `Class.InputBinding.Vector3Scale|Vector3Scale`(예: `Enum.InputActionType|Direction3D`)를 사용하십시오. `Scale`과 벡터 스케일이 모두 설정된 경우 두 가지 모두 적용됩니다.


InputBinding.Scale

방향 `Class.InputAction`의 출력의 모든 구성 요소에 균일하게 적용되는 스칼라 배수입니다.


바인딩에 대한 필수 수정자로 작용하는 `Enum.KeyCode`를 지정합니다. `Class.InputBinding`은 이 입력이 `Class.InputBinding.KeyCode|KeyCode`, `Class.InputBinding.UIButton|UIButton` 또는 복합 방향보다 먼저 눌릴 경우에만 부모 `Class.InputAction`을 트리거합니다.

`Class.InputBinding.PrimaryModifier|PrimaryModifier`와 `Class.InputBinding.SecondaryModifier|SecondaryModifier` 간에는 순서 요구 사항이 없습니다. 두 속성이 모두 설정된 경우 두 수정자가 모두 눌려야 바인딩이 활성화되지만, 눌리는 순서는 중요하지 않습니다.

`Enum.KeyCode.Unknown`으로 설정된 경우, 보조 수정자가 필요하지 않습니다.


InputBinding.SecondaryModifier

바인딩을 활성화하기 위해 눌러야 하는 보조 `Enum.KeyCode`를 지정합니다.


이 `InputBinding`이 하드웨어 입력(`Enum.InputBindingType|Automatic`)에 의해 트리거되는지 또는 `Class.InputBinding:Fire()|Fire()`를 통해 프로그래밍적으로 트리거되는지를 결정합니다(`Enum.InputBindingType|Scriptable`).

`Enum.InputBindingType|Automatic`(기본값)으로 설정되면, 바인딩은 물리적 입력 장치(키보드, 마우스, 게임패드, 터치)에 반응하며, 이는 `Class.InputBinding.KeyCode|KeyCode` 또는 복합 방향 또는 UI 버튼 속성에 기반합니다.

`Enum.InputBindingType|Scriptable`로 설정되면, 바인딩은 하드웨어 입력을 무시하고 대신 `Class.InputBinding:Fire()|Fire()` 메서드를 통해 상태 업데이트를 독점적으로 수신합니다.


InputBinding.Type

이 바인딩이 하드웨어 입력에 의해 트리거되는지 아니면 `Class.InputBinding:Fire()|Fire()`를 통해 프로그래밍적으로 트리거되는지를 결정합니다.


`Class.GuiButton`은 불리언 액션에 연결됩니다.

InputBinding.UIButton

`Class.GuiButton`을 불리언 액션에 연결합니다.

부모 `Class.InputAction`을 트리거하기 위해 눌러야 하는 `Class.GuiButton`을 지정합니다. 이는 `Class.InputBinding.PrimaryModifier|PrimaryModifier` 및 `Class.InputBinding.SecondaryModifier|SecondaryModifier`와 유사하게 작동하지만, `Enum.KeyCode` 대신 UI 버튼 참조를 수용합니다.

이는 터치 입력에 특히 유용하며, 관련 상호작용이 화면의 터치 시작 위치에 의해 정의됩니다. 예를 들어 특정 UI 영역 내에서 시작된 터치에만 반응해야 하는 동적 스틱과 같은 경우입니다.

`nil`인 경우, 수정자가 필요하지 않습니다.


InputBinding.UIModifier

바인딩이 활성화되기 위해 활성화되어야 하는 `Class.GuiButton`을 지정합니다.

상위 `Class.InputAction`의
`Class.InputAction:GetState()|GetState()` 및
`Class.InputAction.StateChanged|StateChanged` 이벤트에 대해 방향적으로 "위" 입력을 전달하기 위한
대체 `Enum.KeyCode`를 지정합니다.

상위 액션의 `Class.InputAction.Type|Type`이
`Enum.InputActionType|Direction1D`인 경우, 전송된 값은
`0`과 `1` 사이의 숫자가 됩니다.

상위 액션의 `Class.InputAction.Type|Type`이
`Enum.InputActionType|Direction2D`인 경우, 전송된 값은
`Datatype.Vector2`이며 그 `Datatype.Vector2.Y|Y` 구성 요소는
`0`과 `1` 사이입니다.

상위 액션의 `Class.InputAction.Type|Type`이
`Enum.InputActionType|Direction3D`인 경우, 전송된 값은
`Datatype.Vector3`이며 그 `Datatype.Vector3.Y|Y` 구성 요소는
`0`과 `1` 사이입니다.

상위 액션의 `Class.InputAction.Type|Type`이
`Enum.InputActionType|Bool`인 경우에는 적용되지 않습니다.

InputBinding.Up

상위 `Class.InputAction`에 방향적으로 "위" 입력을 전달하기 위한 대체 `Enum.KeyCode`를 지정합니다.

출력의 각 구성 요소가 독립적으로 선형적으로 스케일링되는 양입니다. 이는 상위 액션의
`Class.InputAction.Type|Type`가 `Enum.InputActionType|Direction2D`일 때만 적용됩니다.

InputBinding.Vector2Scale

`Enum.InputActionType|Direction2D` 액션의 출력에 적용되는 각 구성 요소 스케일입니다.

출력의 각 구성 요소가 독립적으로 선형적으로 스케일링되는 양입니다. 이는 상위 액션의
`Class.InputAction.Type|Type`가 `Enum.InputActionType|Direction3D`일 때만 적용됩니다.

InputBinding.Vector3Scale

 `Enum.InputActionType|Direction3D` 액션의 출력에 적용되는 각 구성 요소 스케일입니다.

모든 하드웨어 바인딩이 부모 `Class.InputAction`을 트리거해야 함을 정의합니다.

`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, "changed")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 속성이 변경될 때 발생하는 이벤트를 반환하는 `Class.Instance:GetAttributeChangedSignal()`도 참조하세요.


Instance.AttributeChanged

attribute

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


이 코드 조각은 객체가 Workspace에 추가될 때 그 이름을 출력합니다:


이 `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`가 아닌 다른 것으로 변경된 경우를 의미합니다. 이 이벤트는 자식이 파괴될 때도 발생합니다(`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`입니다.


이 `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`를 삭제할 때, 예를 들어 [탐색기](/studio/explorer)를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신 부모가 `nil`로 설정되며, 이는 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.


Instance.Destroying

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


 `Class.Instance.StyledPropertiesChanged`를 보여줍니다.


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


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.Model`에서 내려오는 모든
`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`가 아닐 경우 `nil`입니다.


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


Instance:clone

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

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

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

불필요한 객체를 처리하는 것은 중요합니다.
장소에 불필요한 객체와 연결이 있으면 메모리를 사용하여 시간이 지남에 따라 심각한 성능 문제를 초래할 수 있습니다.

`Destroy()`를 호출한 후에는,
객체(또는 그 자손)를 참조하는 모든 변수를 `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.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.Instance`의 첫 번째 조상을 반환합니다.


주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위로 작동하며,
인스턴스의 즉각적인 `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를 반환하는 `Class.Instance`의 첫 번째 조상을 반환합니다.


아래 코드는 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

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


Instance:FindFirstChildOfClass

주어진 `Class.Object.ClassName|ClassName`과 같은 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 자식을 반환합니다.

일치하는 자식이 없으면 이 메서드는 `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

주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

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


Instance:FindFirstDescendant

주어진 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.


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


Instance:GetActor

인스턴스와 연결된 `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:GetPropertyChangedSignal()|GetPropertyChangedSignal()`과 유사하지만,
속성에 대한 것입니다.

일반적으로 속성 이름을 확인하는 함수와 함께 `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("속성이 변경되었습니다.")
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`가 객체와 같은 모든 `Class.Instance`입니다.
배열은 숫자 또는 일반 `for` 루프를 사용하여 반복할 수 있습니다:

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

-- 숫자 루프 예제
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. "는 자식 번호 " .. i입니다.)
end
```

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

-- 일반 루프 예제
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. "는 자식 번호 " .. i입니다.)
end
```
반환된 배열은 **특정 순서로 정렬되지 않으므로**, 수동 정렬(예: `Library.table.sort()`)을 권장합니다.
이 메서드에 의해 반환된 자식을 정렬합니다.

또한 `Class.Instance:GetDescendants()|GetDescendants()` 메서드를 참조하십시오.


Instance:GetChildren

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


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


Instance:getChildren

Roblox에서 내부적으로 사용되는 디버그 ID의 코드화된 문자열을 반환합니다. 다음 사항에 유의하십시오:

- 이 항목은 보호됩니다. `Class.Script` 또는
  `Class.LocalScript`에서 사용하려고 하면 오류가 발생합니다.
- 디버그 ID는 디버깅 프로세스에서 사용되는 ID입니다. 디버거가 애플리케이션이 처리하기 전에 각 명령을 읽을 수 있게 해줍니다. Roblox의 모든 객체는 프로세스처럼 작동하며,
필요할 경우 디버깅할 수 있는 실행 명령(또는 '코드')을 실행합니다.
- 이는 유사한 객체를 구별해야 하는 플러그인에 유용할 수 있습니다.
(예: 동일한 이름을 공유하는 객체).


Instance:GetDebugId

scopeLength

Roblox에서 내부적으로 사용되는 디버그 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:GetStyled()`를 보여줍니다.


이 메서드는 지정된 속성의 스타일이 지정되거나 명시적으로 수정된 값을 반환합니다.
수정되지 않은 경우 기본 속성 값을 반환합니다. 이는 직접 속성 값을 접근하는 것과 약간 다릅니다.
예: `[GuiObject].Rotation`은 속성의 기본값 또는 수정된 값을 반환합니다.


Instance:GetStyled

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


Instance

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


/reference/engine/classes/InputBinding.yaml

요약