> 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/memorystoreservice.md).

# MemoryStoreService

MemoryStoreService : `Instance`

## Overview

MemoryStoreService는 같은 월드의 여러 서버가 함께 읽고 쓰는 메모리 기반 데이터 저장소에 접근하는 서비스입니다. 매치메이킹 대기열, 실시간 순위표, 서버 간 공유 상태처럼 빠르게 자주 바뀌는 데이터를 다룰 때 사용합니다.

저장소는 HashMap(키-값), SortedMap(정렬된 키-값), Queue(우선순위 큐) 세 가지 형태를 제공하며, 각각 GetHashMap(), GetSortedMap(), GetQueue() 메서드로 이름을 지정해 가져옵니다. 저장소는 따로 생성할 필요 없이 첫 쓰기 시점에 만들어집니다.

이 서비스는 서버 Script에서만 사용할 수 있으며, LocalScript에서 호출하면 오류가 발생합니다.

**주의사항**

* 휘발성 저장소이므로 저장소가 재시작되면 데이터가 사라질 수 있습니다. 잃으면 안 되는 데이터는 DataStoreService를 사용해야 합니다.
* 저장소에서 값을 읽고 쓰는 메서드는 서버 간 최신 상태를 공유하기 위해 캐시를 사용하지 않으며, 호출할 때마다 새로 요청합니다.
* Studio에서는 로컬 메모리 에뮬레이션으로 동작합니다. 데이터는 Play를 멈추면 사라지며, 여러 서버 사이의 동시 접근 경합과 요청·용량 한도는 재현되지 않습니다. 같은 서버 안의 스크립트(코루틴) 간 경합은 재현되므로, 실서버 동작은 배포 환경에서 다시 확인하는 것이 좋습니다.

## Properties

## Methods

### GetHashMap

지정한 이름의 MemoryStoreHashMap을 반환합니다.

이 메서드는 네트워크 요청을 보내지 않고 즉시 반환합니다. 같은 이름으로 다시 호출하면 같은 객체를 반환합니다.

이름의 유효성은 이 메서드에서 검사하지 않고, 반환된 객체로 처음 데이터를 읽거나 쓸 때 검사합니다. 아직 아무것도 저장되지 않은 저장소를 읽으면 오류 없이 빈 결과를 반환합니다.

#### Parameters

| `string` InName | <p>가져올 HashMap의 이름입니다.</p><ul><li>1 \~ 128자여야 하며, 빈 문자열이나 공백만으로 된 이름은 첫 데이터 접근 시 오류가 발생합니다.</li></ul> |
| --------------- | ----------------------------------------------------------------------------------------------------- |

#### Return

| `MemoryStoreHashMap` | 지정한 이름의 저장소에 접근하는 MemoryStoreHashMap 객체입니다. |
| -------------------- | ------------------------------------------- |

#### Code Samples

### GetQueue

지정한 이름과 숨김 시간(InvisibilityTimeout)을 가진 MemoryStoreQueue를 반환합니다.

이 메서드는 네트워크 요청을 보내지 않고 즉시 반환합니다. 이름과 숨김 시간이 모두 같으면 같은 객체를 반환하며, 이름이 같더라도 숨김 시간이 다르면 각자의 숨김 시간으로 동작하는 서로 다른 객체를 반환합니다.

이름과 숨김 시간의 유효성은 이 메서드에서 검사하지 않고, 반환된 객체로 처음 데이터를 읽거나 쓸 때 검사합니다.

#### Parameters

| `string` InName                | <p>가져올 Queue의 이름입니다.</p><ul><li>1 \~ 128자여야 하며, 빈 문자열이나 공백만으로 된 이름은 첫 데이터 접근 시 오류가 발생합니다.</li></ul>                                                                                                      |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `number` InInvisibilityTimeout | <p>(선택 사항) ReadAsync로 읽어간 항목이 다른 읽기에서 보이지 않도록 숨겨지는 시간(초)입니다.</p><ul><li>생략하면 30초입니다.</li><li>0을 지정하면 읽어간 항목을 숨기지 않습니다.</li><li>0 \~ 2,147,483.647초(약 24.9일) 범위를 벗어나면 ReadAsync 호출 시 오류가 발생합니다.</li></ul> |

#### Return

| `MemoryStoreQueue` | 지정한 이름과 숨김 시간으로 동작하는 MemoryStoreQueue 객체입니다. |
| ------------------ | -------------------------------------------- |

#### Code Samples

### GetSortedMap

지정한 이름의 MemoryStoreSortedMap을 반환합니다.

이 메서드는 네트워크 요청을 보내지 않고 즉시 반환합니다. 같은 이름으로 다시 호출하면 같은 객체를 반환합니다.

이름의 유효성은 이 메서드에서 검사하지 않고, 반환된 객체로 처음 데이터를 읽거나 쓸 때 검사합니다.

#### Parameters

| `string` InName | <p>가져올 SortedMap의 이름입니다.</p><ul><li>1 \~ 128자여야 하며, 빈 문자열이나 공백만으로 된 이름은 첫 데이터 접근 시 오류가 발생합니다.</li></ul> |
| --------------- | ------------------------------------------------------------------------------------------------------- |

#### Return

| `MemoryStoreSortedMap` | 지정한 이름의 저장소에 접근하는 MemoryStoreSortedMap 객체입니다. |
| ---------------------- | --------------------------------------------- |

#### Code Samples

## Events
