> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/classes/configsnapshot.md).

# ConfigSnapshot

ConfigSnapshot : `Instance`

## Overview

ConfigSnapshot은 ConfigService의 GetConfigAsync()나 GetConfigForPlayerAsync()가 반환하는, 특정 시점의 구성 값을 담은 객체입니다.

ConfigSnapshot이 가진 값은 Refresh()를 호출하기 전까지 바뀌지 않습니다. 구성 값이 갱신되거나 테스트 값이 변경되어 새 값이 준비되면 Outdated가 true가 되고 UpdateAvailable 이벤트가 발생하며, Refresh()를 호출하면 준비된 값이 한 번에 적용됩니다.

ConfigSnapshot은 서버 Script에서만 사용할 수 있습니다. 스크립트에서 더 이상 참조하지 않는 ConfigSnapshot은 자동으로 제거되며, 새 버전 확인도 중단됩니다.

## Properties

### Error

`Enum.ConfigSnapshotError`

가장 최근에 새 구성 값을 확인하거나 불러오는 과정에서 오류가 있었는지를 반환하는 읽기 전용 속성입니다.

불러오기에 실패하면 LoadFailed가 되며, 이때도 ConfigSnapshot에 이미 적용된 값은 그대로 유지됩니다. 이후 불러오기에 성공하면 다시 None이 됩니다.

#### Code Samples

### Outdated

`boolean`

ConfigSnapshot에 적용된 값보다 새로운 구성 값이 있는지를 반환하는 읽기 전용 속성입니다.

아직 적용되지 않은 새 값이 준비되어 있거나, 새 버전의 구성 값이 확인되었지만 아직 불러오지 못한 경우 true입니다. Refresh()로 준비된 값을 적용하면 false가 됩니다.

#### Code Samples

## Methods

### GetValue

ConfigSnapshot에 현재 적용된 구성 값 중 지정한 키의 값을 반환합니다.

table 값은 복사본이 반환되므로, 반환된 테이블을 수정해도 ConfigSnapshot에 저장된 값은 바뀌지 않습니다.

#### Parameters

| `Value` Key | <p>값을 읽을 구성 값의 키입니다.</p><ul><li>영문자, 숫자, <code>.</code>, <code>-</code>, <code>*</code>로 이루어진 1\~250자의 문자열이어야 하며, <code>*</code>로 시작할 수 없습니다.</li><li>규칙에 맞지 않는 키를 전달하면 오류가 발생합니다.</li></ul> |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### Return

| `Value` | 키에 해당하는 구성 값입니다. string, boolean, number 또는 table이며, 해당 키가 없으면 nil입니다. |
| ------- | ---------------------------------------------------------------------- |

#### Code Samples

### GetValueChangedSignal

지정한 키의 값이 Refresh()로 변경될 때 발생하는 신호를 반환합니다.

Refresh()로 새 값이 적용될 때 해당 키의 값이 추가·삭제·변경된 경우에만 발생하며, 연결된 함수에는 새 값이 인자로 전달됩니다(키가 삭제되었으면 nil). 신호가 발생하는 시점에는 이미 모든 키의 새 값이 적용되어 있습니다. 같은 키로 여러 번 호출하면 같은 신호가 반환됩니다.

#### Parameters

| `Value` Key | <p>변경을 감지할 구성 값의 키입니다.</p><ul><li>영문자, 숫자, <code>.</code>, <code>-</code>, <code>*</code>로 이루어진 1\~250자의 문자열이어야 하며, <code>*</code>로 시작할 수 없습니다.</li><li>규칙에 맞지 않는 키를 전달하면 오류가 발생합니다.</li></ul> |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### Return

| `ScriptSignal` | 해당 키의 값이 변경될 때 발생하는 신호입니다. |
| -------------- | -------------------------- |

#### Code Samples

### Refresh

준비된 새 구성 값을 ConfigSnapshot에 적용합니다.

적용 후에는 값이 바뀐 키마다 GetValueChangedSignal()로 얻은 신호가 발생합니다. 준비된 새 값이 없으면 아무 동작도 하지 않습니다. 이 메서드는 새 값을 직접 불러오지 않으며, UpdateAvailable 이벤트로 알려진 값만 적용합니다.

#### Parameters

#### Return

| `void` |   |
| ------ | - |

#### Code Samples

## Events

### UpdateAvailable

ConfigSnapshot에 적용할 수 있는 새 구성 값이 준비되었을 때 발생하는 이벤트입니다.

이 이벤트가 발생해도 GetValue()가 반환하는 값은 바로 바뀌지 않으며, Refresh()를 호출해야 새 값이 적용됩니다.

#### Parameters

#### Code Samples
