`Lighting` 서비스는 경험에서 전역 조명을 제어합니다.조정 가능한 속성의 범위를 포함하며, [조명 속성](/environment/lighting)에 요약된 것처럼 조명의 모양과 다른 개체와의 상호작용을 변경할 수 있습니다.

  <img src="../../../assets/lighting-and-effects/lighting-properties/TimeOfDay-17.jpg" width="800" />

  `Lighting` 에는 입자 밀도, 안개, 반사 및 색상을 포함하여 현실적인 대기 효과를 렌더링하기 위한 `Class.Atmosphere` 개체도 포함될 수 있습니다.자세한 내용은 [대기 효과](/environment/atmosphere)를 참조하십시오.

  <img src="../../../assets/lighting-and-effects/atmosphere/Offset-A.jpg" width="800" />

  또한, `Lighting` (함께 `Class.Workspace.CurrentCamera` )에는 [포스트 프로세싱 효과](/environment/post-processing-effects) (예: `Class.SunRaysEffect` 및 `Class.BlurEffect` )가 포함될 수 있습니다.

이 이벤트는 변경된 `Lighting` 속성이나 `Class.Sky` 가 추가되거나 제거되면서 `Lighting` 에서 몇 가지 예외:

  *   변경하는 `Class.Lighting.GlobalShadows|GlobalShadows` 이벤트는 발생하지 않습니다.
  *   안개 속성을 변경하는 것은 `Class.Lighting.FogColor|FogColor` , `Class.Lighting.FogStart|FogStart` 또는 `Class.Lighting.FogEnd|FogEnd` 이벤트를 발생시키지 않습니다.

  이 동작이 원하지 않는 경우 `Class.Object.Changed` 이벤트 또는 `Class.Object:GetPropertyChangedSignal()` 메서드를 사용할 수 있습니다.

Lighting.LightingChanged

skyChanged

이 이벤트는 변경된 `Lighting` 속성이나 `Class.Sky` 가 추가되거나 제거된 `Lighting` 에서 발생합니다.

조명 목적으로 자정 이후 지난 시간의 분 수를 반환합니다.이 숫자는 거의 다음과 같이 `Class.Lighting.ClockTime|ClockTime` 곱하기 `60` 로 변환됩니다.

  이 숫자는 현재 날의 자정 이후에 반환되기 때문에 `Class.Lighting:SetMinutesAfterMidnight()|SetMinutesAfterMidnight()`에 지정된 값과 항상 같지 않을 수 있습니다.

Lighting:GetMinutesAfterMidnight

조명 목적으로 자정 이후 지난 시간의 분 수를 반환합니다.

위치 `Datatype.Vector3` 에서 달의 방향을 나타내는 <Typography noWrap>`(0, 0, 0)`</Typography> 를 나타내는  반환합니다.달이 "설정"되어 더 이상 보이지 않을 때, 이 메서드에서 반환된  는 여전히 수평선 아래의 달을 가리킬 것입니다.

  `Class.Lighting:GetSunDirection()|GetSunDirection()`는 태양의 방향을 얻기 위한 이 메서드의 변형입니다.

Lighting:GetMoonDirection

`Datatype.Vector3` 달의 방향을 나타내는 것.

달의 방향을 나타내는 `Datatype.Vector3`를 반환합니다.

달의 현재 단계를 반환합니다. 달의 단계를 변경할 수 없으므로 항상 `0.75` 가 반환됩니다.

Lighting:GetMoonPhase

위치 `Datatype.Vector3` 에서 태양의 방향을 나타내는 <Typography noWrap>`(0, 0, 0)`</Typography> 을 나타내는  반환합니다.태양이 "설정"되어 더 이상 보이지 않을 때, 이 메서드에서 반환된  는 여전히 수평선 아래의 태양을 가리킬 것입니다.

  `Class.Lighting:GetMoonDirection()|GetMoonDirection()`는 달의 방향을 얻기 위한 이 메서드의 변형입니다.

Lighting:GetSunDirection

`Datatype.Vector3` 태양의 방향을 나타내는 것.

태양의 방향을 나타내는 `Datatype.Vector3`를 반환합니다.

자정 이후의 지정된 분 수에 `Class.Lighting.TimeOfDay|TimeOfDay` 및 `Class.Lighting.ClockTime|ClockTime` 를 설정합니다.

  이 메서드는 예를 들어 하루/밤 주기 `Class.Script` 에서 숫자 값을 사용할 수 있으며, 필요에 따라 `Class.Lighting.TimeOfDay|TimeOfDay` 에서 요구하는 형식으로 변환할 필요가 없습니다.또한 다음 날의 시간에 해당하는 24시간 이상의 값을 지정할 수도 있습니다.

  다음 코드 샘플에는 간단한 일/밤 주기 스크립트가 포함되어 있습니다.시간의 속도와 초기 시간은 `TIME_SPEED` 및 `START_TIME` 매개 변수를 사용하여 변경할 수 있습니다.

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

  local TIME_SPEED = 60  -- 1분 = 1시간
  local START_TIME = 9  -- 9 AM

  local minutesAfterMidnight = START_TIME * 60
  local waitTime = 60 / TIME_SPEED

  while true do
  	minutesAfterMidnight = minutesAfterMidnight + 1

  	Lighting:SetMinutesAfterMidnight(minutesAfterMidnight)

  	task.wait(waitTime)
  end
  ```

Lighting:SetMinutesAfterMidnight

minutes

자정 이후의 지정된 분 수에 `Class.Lighting.TimeOfDay|TimeOfDay` 및 `Class.Lighting.ClockTime|ClockTime` 를 설정합니다.

Lighting:getMinutesAfterMidnight

Lighting:setMinutesAfterMidnight

Lighting

`Ambient` 는 실내 영역과 같이 하늘에서 차단된 영역에 적용되는 조명 색상입니다.

  `Ambient` 기본값은 `[0, 0, 0]` (검정)입니다.이 속성의 빨간색, 녹색 및 파란색 채널이 `Class.Lighting.OutdoorAmbient|OutdoorAmbient`에서 해당 채널을 초과하지 않으면 색상의 변경은 태양/달로부터 차단된 지역에 보관됩니다.

  `Class.Lighting.GlobalShadows|GlobalShadows`가 비활성화되면 하늘에서 차단된 영역과 차단되지 않은 영역 사이에 구분이 없습니다.이 경우, `Class.Lighting.OutdoorAmbient|OutdoorAmbient` 가 무시되고 `Ambient` 속성의 색상이 모든 곳에 적용됩니다.

Lighting.Ambient

실내 영역과 같이 하늘에서 차단된 영역에 적용된 조명 색상.

플레이스조명 강도.

  이 값을 변경하면 플레이스조명에 대한 조명원(태양 또는 달)의 영향이 변화됩니다.참고로 `Class.Lighting.Ambient|Ambient` 및 `Class.Lighting.OutdoorAmbient|OutdoorAmbient` 는 장소의 밝기를 영향을 주는 데 사용할 수도 있습니다.예를 들어, 를 으로 설정하면 장소가 기본값인 보다 밝게 보이게 됩니다(더 하얀색이기 때문입니다).

Lighting.Brightness

`Lighting`에서 사용하는 현재 시간(시간)의 숫자 표현.이 속성은 실제 시간과 일치하지 않으며 스크립트에 의해 변경되지 않는 한 게임플레이 중에 변경되지 않습니다.

  24시간 문자열로 형식화된 측정값에 대해 `Lighting` 시간을 사용하고, `Class.Lighting.TimeOfDay|TimeOfDay` 를 사용합니다.변경 `Class.Lighting.TimeOfDay|TimeOfDay` 또는 사용 `Class.Lighting:SetMinutesAfterMidnight()|SetMinutesAfterMidnight()` 이 속성도 변경됩니다.

Lighting.ClockTime

`Lighting`에서 사용하는 현재 시간(시간)의 숫자 표현.

태양이나 달을 향하는 표면과 반대되는 표면에 빛에 반영된 색상입니다. The hue represented in light reflected in the opposite surfaces to those facing the sun or moon.

  에 영향을 미치는 표면은 태양이나 달의 위치에 대한 상대적 위치와 방향에 따라 달라집니다.태양이 바로 위에 있는 `Class.BasePart` 에 있을 때, 색상 변경은 하부 표면에만 적용됩니다.

  이 효과는 변경하여 증가하거나 줄일 수 있습니다 `Class.Lighting.Brightness|Brightness`.

  `Class.Lighting.ColorShift_Top|ColorShift_Top` 및 `ColorShift_Bottom` 가 더 크면 `Class.Lighting.Ambient|Ambient` 및 `Class.Lighting.OutdoorAmbient|OutdoorAmbient` 속성과 상호작용하고, <Typography noWrap>`[0, 0, 0]`</Typography> 이상이면 상호작용합니다.또한 `ColorShift_Bottom` 의 영향이 활성화될 때(기본값) `Class.Lighting.GlobalShadows|GlobalShadows` 를 식별하기 어려울 수 있다는 점에 유의하십시오.

Lighting.ColorShift_Bottom

태양이나 달을 향하는 표면과 반대되는 표면에 빛에 반영된 색상입니다. The hue represented in light reflected in the opposite surfaces to those facing the sun or moon.

태양이나 달을 향한 표면에서 반사된 빛에 나타나는 색상입니다. The hue represented in light reflected from surfaces facing the sun or moon.

  에 영향을 미치는 표면은 태양이나 달의 위치에 대한 상대적 위치와 방향에 따라 달라집니다.태양이 바로 위에 있는 `Class.BasePart` 에 있을 때, 색상 변경은 상부 표면에만 적용됩니다.

  이 효과는 변경하여 증가하거나 줄일 수 있습니다 `Class.Lighting.Brightness|Brightness`.

  `ColorShift_Top` 및 `Class.Lighting.ColorShift_Bottom|ColorShift_Bottom` 가 더 크면 `Class.Lighting.Ambient|Ambient` 및 `Class.Lighting.OutdoorAmbient|OutdoorAmbient` 속성과 상호작용하고, <Typography noWrap>`[0, 0, 0]`</Typography> 이상이면 상호작용합니다.

Lighting.ColorShift_Top

태양이나 달을 향한 표면에서 반사된 빛에 나타나는 색상입니다. The hue represented in light reflected from surfaces facing the sun or moon.

기본값이 `0`인 환경에서 파생된 주변 조명.이 속성은 `Class.Lighting.Ambient|Ambient` 및 `Class.Lighting.OutdoorAmbient|OutdoorAmbient`과 유사하지만 동적이며 하늘과 시간에 따라 변경할 수 있습니다.이 속성이 증가하면 `Class.Lighting.Ambient|Ambient` 및 `Class.Lighting.OutdoorAmbient|OutdoorAmbient` 을 적절히 줄이는 것이 좋습니다.

Lighting.EnvironmentDiffuseScale

기본값이 `0` 인 환경에서 파생된 반사 광.이 속성은 부드러운 개체가 환경을 반영하도록 하고 금속이 더 현실적으로 보이도록 만드는 것이 특히 중요합니다.

Lighting.EnvironmentSpecularScale

이 속성은 톤맵 단계 이전에 장면의 노출 수준에 편향을 적용하는 노출 보정 금액을 결정합니다.기본값은 `0` (노출 보정 없음)이고 범위는 `-5`에서 `5`입니다.값 `1` 은 두 배의 노출을 나타내고, `-1` 는 절반의 노출을 의미합니다.

Lighting.ExposureCompensation

A 값은 안개의 색상을 제공합니다. 안개 속성은 에 개체 가 포함되어 있을 때 숨겨집니다.

Lighting.FogColor

A 값으로 안개의 색상을 제공합니다.

안개가 완전히 불투명해지는 `Class.Workspace.CurrentCamera` 의 깊이, 스터드 단위에서.안개 속성은 `Lighting` 에 `Class.Atmosphere` 개체가 포함되어 있을 때 은폐됩니다.

Lighting.FogEnd

안개가 완전히 불투명해지는 `Class.Workspace.CurrentCamera` 의 깊이, 스터드 단위에서.

안개가 보다시작하는 스터드의 `Class.Workspace.CurrentCamera` 깊이.안개 속성은 `Lighting` 에 `Class.Atmosphere` 개체가 포함되어 있을 때 은폐됩니다.

Lighting.FogStart

안개가 보다시작하는 스터드의 `Class.Workspace.CurrentCamera` 깊이.

지리적 위도, 도 단위의 장면으로, 태양과 달의 위치에서 `Lighting` 시간의 결과에 영향을 미칩니다.태양의 위치를 계산할 때 지구의 기울기도 고려됩니다.

  변경하는 `GeographicLatitude` 는 모든 `Class.Lighting.TimeOfDay|TimeOfDay` 에서 태양의 위치를 변경합니다.태양이나 달의 위치를 얻으려는 경우 `Class.Lighting:GetSunDirection()|GetSunDirection()` 또는 `Class.Lighting:GetMoonDirection()|GetMoonDirection()` 을 사용하십시오.

Lighting.GeographicLatitude

지리적 위도, 도 단위의 장면으로, 태양과 달의 위치에서 `Lighting` 시간의 결과에 영향을 미칩니다.

플레이스볼륨 기반 동적 조명을 전환합니다.`true` 로 설정되면 태양과 달의 위치에 따라 보호된 영역에서 그림자가 렌더링됩니다.이러한 보호된 영역에 적용된 조명 색상은 속성 `Class.Lighting.Ambient|Ambient`에 의해 결정되고, 다른 모든 영역의 조명 색상은 속성 `Class.Lighting.OutdoorAmbient|OutdoorAmbient`에 의해 결정됩니다.

  When `false` , 그림자가 그려지지 않으며 실내 및 실외 영역 간에 구분이 이루어지지 않습니다.결과적으로, `Class.Lighting.Ambient|Ambient` 속성이 조명 색상을 결정하고 `Class.Lighting.OutdoorAmbient|OutdoorAmbient`는 아무 것도 하지 않습니다.

  그림자는 복셀 시스템을 사용하여 계산되며 각 조명 복셀은 4×4×4 스터드입니다.즉, 실제 그림자를 표시하려면 개체가 4×4×4 스터드보다 커야 합니다.그림자는 또한 이동할 때 다시 계산됩니다 `Class.BasePart|BaseParts`.

Lighting.GlobalShadows

플레이스대한 보벨 기반 동적 조명을 전환합니다.

Lighting.LightingStyle

`OutdoorAmbient` 는 야외 지역에 적용된 조명 색상입니다.

  `OutdoorAmbient` 기본값은 `[127, 127, 127]` 입니다.`Class.Lighting.Ambient|Ambient`의 빨간색, 녹색 및 파란색 채널이 `OutdoorAmbient`의 해당 채널을 초과하지 않으면 야외 지역의 조명 색상은 이 속성에 의해 결정됩니다.

  유효한 `OutdoorAmbient` 값은 모든 채널에서 `Class.Lighting.Ambient|Ambient` 보다 크거나 같아야 하므로, 채널의 `Class.Lighting.Ambient|Ambient` 가 해당 채널의 `OutdoorAmbient` 채널을 초과하면 색상의 `Class.Lighting.Ambient|Ambient` 가 야외 지역에 적용되기 시작합니다.

  `Class.Lighting.GlobalShadows|GlobalShadows`가 비활성화되면 하늘에서 차단된 영역과 차단되지 않은 영역 사이에 구분이 없습니다.이 경우, `OutdoorAmbient` 가 무시되고 `Class.Lighting.Ambient|Ambient` 속성의 색상이 모든 곳에 적용됩니다.

Lighting.OutdoorAmbient

야외 지역에 적용된 조명 색상.

이 속성은 플레이스윤곽이 활성화되었는지 비활성화되었는지를 결정합니다.

  개요는 이 속성 `Lighting`을 사용하여 전역 기준으로 비활성화될 수 있으며, 또는 다음과 같이 표면 기준으로 비활성화될 수 있습니다: `Class.BasePart|BaseParts` 을 사용하여 사용 중인 표면에 따라 사용 중인 `Enum.SurfaceType` .

  스크립트로 이 플레이스설정할 수는 있지만, 장소를 게시하기 전에 Roblox Studio에서 이 속성을 설정하는 것이 좋습니다.

Lighting.Outlines

플레이스윤곽이 활성화되었는지 비활성화되었는지 여부를 결정합니다.

Lighting.PrioritizeLightingQuality

이는 플레이어 그림자의 색상을 변경할 것으로 예상되지만 현재는 아무것도 하지 않습니다.

Lighting.ShadowColor

기본값인 `0.2` 으로 그림자가 흐린 정도를 제어합니다.이 속성은 `Class.Lighting.Technology|Technology``Enum.Technology|ShadowMap``Enum.Technology|Future` 장치가 그림자 맵을 렌더링할 수 있을 때만 작동합니다.

Lighting.ShadowSoftness

섀도우의 흐림 정도를 제어합니다.

3D 세계를 렌더링하는 조명 시스템을 결정합니다.이 속성은 스크립트할 수 없으며 스튜디오에서만 수정할 수 있습니다.사용 가능한 옵션은 `Enum.Technology` 참조하고, 각 옵션의 상세 설명과 시각적 효과는 [조명 기술](/environment/lighting#technology)에 참조하십시오.

Lighting.Technology

3D 세계를 렌더링하기 위한 조명 시스템을 결정합니다. 스크립트 불가능. .

`Lighting`에서 사용하는 24시간 문자열 표현 현재 시간입니다.이 속성은 실제 시간과 일치하지 않으며 스크립트에 의해 변경되지 않는 한 게임플레이 중에 변경되지 않습니다.

  숫자 측정값 `Lighting` 시간에는 `Class.Lighting.ClockTime|ClockTime` 를 사용하십시오. `Class.Lighting.ClockTime|ClockTime` 또는 `Class.Lighting:SetMinutesAfterMidnight()|SetMinutesAfterMidnight()` 을 변경하면 이 속성도 변경됩니다.

Lighting.TimeOfDay

`Lighting`에서 사용하는 24시간 문자열 표현 현재 시간입니다.

`Lighting` 서비스는 경험에서 전역 조명을 제어합니다.조명의 모양과 상호 작용 방식을 변경하는 데 사용할 수 있는 다양한 조정 가능한 속성을 포함합니다.

는 Roblox 클래스 계층에서 트리의 일부가 될 수 있는 모든 클래스의 기본 클래스입니다.

  루트 `Instance` 개체를 직접 만들 수는 없지만 특수한 `Datatype.Instance.new()` 생성자는 클래스 이름을 매개 변수로 사용하여 코드를 통해 개체를 만들고 생성된 개체를 반환합니다.

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

개체나 그 조상 중 하나의 `Class.Instance.Parent` 속성이 변경될 때 발생합니다.

  이 이벤트에는 두 개의 매개 변수가 포함됩니다: 는 실제로 변경된 의 참조를 포함하며, 는 이 인스턴스의 새로운 에 대한 참조를 포함합니다.

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

Instance.AncestryChanged

child

변경된 `Class.Instance` 의 `Class.Instance.Parent` 가 변경되었습니다.

parent

새로운 `Class.Instance.Parent` 의 `Class.Instance` 가 변경된 새로운 `Class.Instance.Parent` 의

개체나 그 조상 중 하나의 `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`에서 변경됩니다.

This snippet prints the names of objects as they are added to the Workspace:

개체가 이 `Class.Instance` 에 부모로 지정된 후 발생합니다.

  이 함수를 서버에서 생성된 개체를 감지하기 위해 클라이언트에서 사용할 때, 이러한 개체의 하위를 인덱싱할 때 `Class.Instance:WaitForChild()`를 사용해야 합니다.이는 개체와 그 하위 개체가 동시에 서버에서 클라이언트로 복제되지 않는다는 보장이 없기 때문입니다.예를 들어:

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

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  참고, 이 함수는 `Class.Instance`의 즉시 자식에서만 작동합니다. 모든 하위를 캡처하는 함수의 경우 `Class.Instance.DescendantAdded`를 사용하십시오.

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

Instance.ChildAdded

개체가 이 `Class.Instance` 에 부모로 지정된 후 발생합니다.

This snippet prints the names of objects as they are removed from the
Workspace:

자식이 이 `Class.Instance` 에서 제거된 후 발생하는 화재.

  제거는 개체의 부모가 이 `Class.Instance`에서 이 `Class.Instance`로 바뀌었을 때를 가리킵니다.참고, 이 이벤트는 자식이 삭제될 때(`Class.Instance:Destroy()`를 사용하여) 파괴 함수가 개체의 부모를 `nil`로 설정하기 때문에 또한 발생합니다.

  이 함수는 `Class.Instance`의 즉시 자식에서만 작동합니다. 모든 하위를 캡처하는 함수의 경우 `Class.Instance.DescendantRemoving`를 사용하십시오.

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

Instance.ChildRemoved

자식이 이 `Class.Instance` 에서 제거된 후 발생하는 화재.

다음 예제에서는 작업 영역에 추가된 모든 개체의 이름을 인쇄합니다.

이 이벤트는 하위 요소가 `Class.Instance`에 추가된 후 발생합니다.

  모든 하위 요소에 대해 발사할 때, 개체를 `Class.Instance`에 부모로 지정하면 이 개체와 모든 하위 요소의 이벤트가 개별적으로 발생합니다.

  걱정되는 것은 직접 자식만 있는 의 경우, 대신 을 사용하십시오.

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

Instance.DescendantAdded

descendant

하위 요소가 `Class.Instance`에 추가된 후 발생하는 화재.

The following example prints the name of any descendant as it is being removed
from the Workspace:

이 이벤트는 부모의 `Class.Instance`이 발생하기 직전에 **즉시** 하위 인스턴스가 더 이상 하위 인스턴스가 아니라는 점에서 부모의 **변경** 을 발사합니다.`Class.Instance:Destroy()|Destroy()` 인스턴스의 `Class.Instance.Parent|Parent` 를 `nil` 로 변경하여 부모의 하위에서 해당 메서드를 호출하면 이 이벤트가 발생합니다.

  이 이벤트는 후손의 제거 전에 **발생하므로** , 이 이벤트가 발생할 때 후손의 부모는 변경되지 않습니다.후손이 또한 부모의 직접 자식이면 이 이벤트는 발생하기 전에 발사됩니다.

  후손에 자식이 있는 경우, 이 이벤트는 먼저 후손, 그 다음 자식이 있는 순서로 발생합니다.

  ##### 경고

  이 이벤트는 제거되는 하위 개체로 발생합니다.하위 요소의 `Class.Instance.Parent|Parent`를 다른 것으로 설정하려는 시도는 실패합니다.아래는 이것을 보여주는 예시입니다:

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

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  또한 참조하십시오 `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

`Class.Instance`의 후손이 제거되기 즉시 발생하는 화재.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

연결된 함수가 여전히 사용하고 있는 동안 메모리에서 `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` 이벤트에 연결하는 것은 스크립트가 호출되기 전에 파괴되기 때문에 문제가 있습니다(즉, 실행되지 않음).

  Studio에서 수동으로 삭제하거나 플러그인을 통해 삭제하는 등 를 삭제할 때, Explorer를 통해 또는 플러그인을 통해 삭제되지 않습니다.대신, 부모는 `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("Styled properties changed")
  end

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

Instance.StyledPropertiesChanged

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

Instance.childAdded

이 메서드는 태그를 인스턴스에 적용하며, 태그가 이미 적용된 경우 효과가 없습니다.태그를 성공적으로 추가하면 지정된 태그로 생성된 신호가 `Class.CollectionService:GetInstanceAddedSignal()`에 발사됩니다.

  ##### 경고

  *   클라이언트 측에서 추가된 인스턴스의 태그는 서버가 나중에 해당 인스턴스에 태그를 추가하거나 제거하면 삭제됩니다, 서버는 모든 태그를 복제하고 이전 태그를 덮어쓰기 때문입니다.

  *   인스턴스를 태그할 때 일부 리소스가 태그의 기능을 제공하기 위해 사용되는 것이 일반적입니다(예: 이벤트 연결 또는 테이블).메모리 누수를 방지하려면 태그가 더 이상 필요하지 않을 때 이를 정리하는 것이 좋습니다(연결 해제, `nil`).`Class.Instance:RemoveTag()` , `Class.Instance:Destroy()` 을 호출하거나 `Class.CollectionService:GetInstanceRemovedSignal()` 에서 반환된 신호에 연결된 함수에서 이를 수행합니다.

Instance:AddTag

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

이 함수는 인스턴스의 모든 자식과 후손을 파괴합니다.

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

  -- Add some sparkles
  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()`을 사용하여 선택하십시오.예를 들어, 다음 코드 샘플은 다음과 같이 에서 내려오는 모든 것을 파괴합니다:

  ```
  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

이 함수는 인스턴스의 모든 자식을 삭제합니다.

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` 는 인스턴스와 모든 하위 인스턴스의 복사본을 만들고, `Class.Instance.Archivable|Archivable` 가 아닌 모든 인스턴스를 무시합니다.루트 인스턴스의 복사본은 이 메서드에 의해 반환되고, `Class.Instance.Parent|Parent` 는 `nil`로 설정됩니다.인스턴스 자체에 가 설정되어 있으면 이 함수가 로 반환됩니다.

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

  *   참조 속성이 복제된 인스턴스를 참조하면 **도** 복사가 복제에 참조됩니다.
  *   참조 속성이 복제되지 않은 개체를 참조하는 경우 동일한 값이 복사본에 유지됩니다.

Instance:Clone

인스턴스와 모든 하위 인스턴스의 복사본을 만들고, `Class.Instance.Archivable|Archivable`가 아닌 인스턴스는 무시합니다.

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

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

`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)  --> "안녕하세요, 세상"
  -- 위의 줄이 작동하지 않도록 수행하십시오:
  part = nil
  ```

  이 메서드에 의해 `Class.Instance`가 파괴되면 `Class.Instance.Parent` 속성이 잠겨져 재사용할 수 없습니다.To **일시적으로** 개체를 파괴하지 않고 대신 제거하려면 `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()` 을 호출합니다.

주어진 이름과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.Returns the first ancestor of the   whose `Class.Instance.Name` is equal to the given name.

  이 함수는 위쪽으로 작동하므로 인스턴스의 즉각적인 `Class.Instance.Parent` 에서 시작하고 `Class.DataModel` 쪽으로 작동합니다.일치하는 조상이 없으면 `nil` 을 반환합니다.

  다음 코드 스니펫은 `Car`라는 개체의 첫 번째 조상을 찾을 것입니다.

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  특정 클래스의 조상을 찾는 이 함수의 변형은 `Class.Instance:FindFirstAncestorOfClass()` 및 `Class.Instance:FindFirstAncestorWhichIsA()`를 참조하십시오.

Instance:FindFirstAncestor

name

주어진 이름과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.Returns the first ancestor of the   whose `Class.Instance.Name` is equal to the given name.

반환 주어진 클래스와 동일한 `Class.Instance` 의 첫 번째 조상을 반환합니다.Returns the first ancestor of the   whose `Class.Object.ClassName` is equal to the givenclassName.

  이 함수는 위쪽으로 작동하므로 인스턴스의 즉각적인 `Class.Instance.Parent` 에서 시작하고 `Class.DataModel` 쪽으로 작동합니다.일치하는 조상이 없으면 `nil` 을 반환합니다.

  이 함수의 일반적인 사용은 속해 있는 을 찾는 것입니다. 예를 들어:

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  이 함수는 `Class.Instance:FindFirstAncestor()`에서 확인하는 대신 `Class.Object.ClassName` 속성을 확인하는 `Class.Instance.Name`의 변형입니다.`Class.Instance:FindFirstAncestorWhichIsA()` 또한 존재하며, 클래스 상속을 존중하기 위해 대신 `Class.Object:IsA()` 방법을 사용합니다.

Instance:FindFirstAncestorOfClass

className

반환 주어진 클래스와 동일한 `Class.Instance` 의 첫 번째 조상을 반환합니다.Returns the first ancestor of the   whose `Class.Object.ClassName` is equal to the givenclassName.

반환 대상 클래스에 대해 `Class.Object:IsA()` 가 참으로 반환하는 첫 번째 조상 `Class.Instance` 을 반환합니다.Returns the first ancestor of the   for whom   returns true for the givenclassName.

  이 함수는 위쪽으로 작동하므로 인스턴스의 즉각적인 `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
  ```

  따라서 다음 코드 샘플은 또는 또는 여부에 관계없이 첫 번째 조상을 반환합니다.

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  또한 참조하십시오 `Class.Instance:FindFirstAncestor()` .

Instance:FindFirstAncestorWhichIsA

반환 대상 클래스에 대해 `Class.Object:IsA()` 가 참으로 반환하는 첫 번째 조상 `Class.Instance` 을 반환합니다.Returns the first ancestor of the   for whom   returns true for the givenclassName.

아래는 작업 공간에서 "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` 와 동일합니다.점 연산자를 사용할 때 속성은 이름을 공유하는 경우 자식보다 우선합니다.

  다음 예제에서는 `Class.Folder` 가 호출된 `Color` 가 있는 `Class.Part` 에 속성 `Class.Part.Color` 이 추가되었습니다. 는 자식 인스턴스가 아닌 속성 값을 참조하고, 는 자식 인스턴스가 아닌 속성 값을 참조합니다.`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")  -- The child folder
  ```

  ##### 성능 노트

  `Class.Instance:FindFirstChild()|FindFirstChild()` 점 연산자를 사용하는 것보다 약 20% 더 오래 걸리고 단순히 개체에 대한 참조를 저장하는 것보다 거의 8배 더 오래 걸립니다.따라서 좁은 루프나 함수에 연결된 `Class.RunService.Heartbeat` 및 `Class.RunService.PreRender`와 같은 성능에 의존하는 코드에서 호출하지 않아야 합니다.대신 변수에 결과를 저장하거나, 특정 이름의 자식이 사용 가능해지면 검색하기 위해 `Class.Instance.ChildAdded|ChildAdded` 또는 `Class.Instance:WaitForChild()|WaitForChild()` 를 사용하는 것을 고려하십시오.

Instance:FindFirstChild

recursive

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

지정된 이름으로 찾은 첫 번째 자식 `Class.Instance`을 반환합니다.

반환하는 첫 번째 자식은 `Class.Instance` 의 `Class.Object.ClassName|ClassName` 가 지정된 `className` 와 동일한 아이입니다.`Class.Instance:FindFirstChildWhichIsA()` 와 달리, 이 함수는 클래스 상속을 무시하고 `className` 에 부합하는 개체만 반환합니다.일치하는 자식이 없으면 이 함수는 `nil` 을 반환합니다.

Instance:FindFirstChildOfClass

반환 받은 클래스 이름과 동일한 `Class.Instance` 의 첫 번째 자식을 반환합니다.Returns the first child of the   whose `Class.Object.ClassName|ClassName` is equal to the given class name.

반환하는 첫 번째 자식 요소는 `Class.Instance`에 대해 반환되며, `Class.Object:IsA()`에서 지정된 클래스에 대해 true를 반환합니다.

  일치하는 자식이 없으면 이 함수는 `nil`를 반환합니다.선택적 재귀 인수가 참이면, 이 함수는 `Class.Instance`의 직접 자식이 아닌 모든 하위 요소를 검색합니다.

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

  ```lua
  print(part:IsA("Part")) --> 참
  print(part:IsA("BasePart")) --> 참
  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` 대상.

반환하는 첫 번째 자식 요소는 `Class.Instance`에 대해 반환되며, `Class.Object:IsA()`에서 지정된 클래스에 대해 true를 반환합니다.

지정된 `Class.Instance.Name` 로 찾은 첫 번째 하위 요소를 반환합니다.

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

Instance:FindFirstDescendant

지정된 `Class.Instance.Name` 로 찾은 첫 번째 하위 요소를 반환합니다.

`Class.Instance` 가 `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` 와 함께 특성 이름을 확인하는 함수를 사용하는 것이 좋습니다.동일한 특성 이름을 가진 동일한 개체에서 이 메서드에 대한 후속 호출은 동일한 이벤트를 반환합니다.

  다음 코드 예제는 부품의 `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

문자열이 특성 이름이고 변형이 비공백 값인 각 특성에 대한 문자열 → 변형 쌍 사전입니다. A dictionary of string → variant pairs for each attribute where the string is the name of the attribute and the variant is a non-nil value.

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

The below would print the name of all objects currently in Workspace when ran.

모든 인스턴스의 직접 자식이나 개체와 동일한 모든 모든 요소를 포함하는 배열(숫자로 인덱스된 테이블)을 반환합니다.숫자 또는 일반 반복기를 사용하여 배열을 반복할 수 있습니다.The array can be iterated upon using either a numeric or generic for-loop:

  ```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")

  -- 일반 for 루프 예제
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  자식은 속성 `Class.Instance.Parent|Parent`가 개체에 설정된 순서에 따라 정렬됩니다.

  또한 `Class.Instance:GetDescendants()|GetDescendants` 함수를 참조하십시오.

Instance:GetChildren

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

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

Roblox에서 내부적으로 사용하는 디버그 ID의 코딩된 문자열을 반환합니다. 참고:

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

Instance:GetDebugId

scopeLength

Roblox에서 내부적으로 사용하는 디버그 ID의 코딩된 문자열을 반환합니다.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

이 개체 메서드는 해당 개체의 모든 하위 개체를 포함하는 배열을 반환합니다.`Class.Instance:GetChildren()` 와 달리 이 메서드는 개체의 즉시 자식만 반환하는 것이 아니라 개체의 모든 자식, 그 자식의 모든 자식 등을 찾습니다.

Instance:GetDescendants

인스턴스의 하위 요소가 포함된 배열.

인스턴스의 모든 하위 항목을 포함하는 배열을 반환합니다.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

인스턴스의 조상을 설명하는 문자열을 반환합니다.문자열은 개체와 그 조상의 `Class.Instance.Name|Name`의 결합으로, 마침표로 구분됩니다.The `Class.DataModel` ( `game` )는 고려되지 않습니다.예를 들어, `Class.Part` 에 있는 `Class.Workspace` 는 반환할 수 있습니다 `Class.Workspace.Part` .

  가 아닌 에서 호출되면 이 함수는 상위 하나를 포함하여 모든 조상을 고려하고 없이 합니다.

  이 함수는 로깅과 디버깅에 유용합니다.반환된 문자열을 유용한 작업으로 분석하려고 시도해서는 안됩니다; 이 함수는 개체 이름에서 마침표(또는 다른 기호)를 이스케이프하지 않습니다.즉, 출력이 종종 유효한 Luau 식별자인 것처럼 보이지만 보장되지 않습니다.

Instance:GetFullName

인스턴스의 조상을 설명하는 문자열을 반환합니다.

이 메서드는 지정된 속성의 스타일이 지정되거나 명시적으로 수정된 값을 반환하거나, 스타일링되거나 수정되지 않은 기본 속성 값을 반환합니다.이는 속성 값에 직접 액세스하는 것과 약간 다르며, `[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(기본값)

  -- 스타일 규칙 속성을 통해 회전 적용 Apply rotation through style rule property
  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 (modified value)
  ```

Instance:GetStyled

지정된 속성의 스타일이 지정된 또는 명시적으로 수정된 값, 또는 스타일링되지 않거나 수정되지 않은 기본 속성 값.

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

이 메서드는 지정된 스타일 속성이 변경될 때만 발생하는 이벤트를 반환하지만 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 이벤트와 동일하게 동작합니다.일반적으로 속성 이름을 확인하는 함수로 연결하는 대신 이 메서드를 사용하는 것이 좋습니다. `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`동일한 속성 이름을 가진 동일한 개체에서 이 메서드에 대한 후속 호출은 동일한 이벤트를 반환합니다.

  이 이벤트는 연결된 함수에 아무 인수도 전달하지 않으므로 변경된 속성의 값은 스크립트 내에서 직접 읽어야 합니다.

  ```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("Style property changed!")
  end

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

Instance:GetStyledPropertyChangedSignal

Instance

는 Roblox 클래스 계층에서 트리의 일부가 될 수 있는 모든 클래스의 기본 클래스입니다.