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

# MessagingService

MessagingService : `Instance`

## Overview

MessagingService는 같은 월드에서 실행 중인 여러 서버가 토픽(topic) 단위로 메시지를 주고받을 수 있게 하는 서비스입니다. 서버 간 공지, 다른 서버의 상태 변화 알림처럼 실시간으로 다른 서버에 신호를 보내야 할 때 사용합니다.

PublishAsync()로 특정 토픽에 메시지를 보내면, 그 토픽을 SubscribeAsync()로 구독한 서버들의 콜백이 호출됩니다.

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

**주의사항**

* 메시지 전달은 보장되지 않습니다(best-effort). 반드시 반영되어야 하는 데이터는 DataStoreService나 MemoryStoreService를 함께 사용해야 합니다.
* 토픽 이름은 비어 있을 수 없으며, UTF-8 기준 80바이트를 넘을 수 없습니다.
* Studio에서 테스트할 때는 발행한 메시지가 같은 세션의 구독자에게만 전달됩니다.

## Properties

## Methods

### PublishAsync

지정한 토픽에 메시지를 발행합니다.

이 메서드는 플랫폼이 발행 요청을 수락할 때까지 호출한 스크립트를 일시 중단(yield)합니다. 30초 안에 응답이 없거나 발행에 실패하면 오류가 발생하므로 pcall로 감싸 호출하는 것이 좋습니다.

#### Parameters

| `string` InTopic  | <p>메시지를 발행할 토픽 이름입니다.</p><ul><li>빈 문자열이거나 UTF-8 기준 80바이트를 넘으면 오류가 발생합니다.</li></ul>                                                                                                                                                                     |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Value` InMessage | <p>(선택 사항) 발행할 메시지 데이터입니다.</p><ul><li>nil, boolean, number, string, buffer 및 이들로 구성된 table을 전달할 수 있습니다.</li><li>직렬화한 크기가 1KB를 넘거나, 중첩이 너무 깊거나 요소가 너무 많으면 오류가 발생합니다.</li><li>유효한 UTF-8이 아닌 문자열, 순환 참조가 있는 테이블, 지원하지 않는 타입의 값을 전달하면 오류가 발생합니다.</li></ul> |

#### Return

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

#### Code Samples

### SubscribeAsync

지정한 토픽을 구독하고, 그 토픽에 메시지가 도착할 때마다 호출할 콜백을 등록합니다.

등록한 콜백의 연결 객체를 즉시 반환하며, 구독을 끝내려면 반환된 연결 객체의 Disconnect()를 호출합니다.

서버 하나가 유지할 수 있는 구독 수는 20 + 8 × (현재 플레이어 수)로 제한되며, 이를 넘으면 오류가 발생합니다.

#### Parameters

| `string` InTopic   | <p>구독할 토픽 이름입니다.</p><ul><li>빈 문자열이거나 UTF-8 기준 80바이트를 넘으면 오류가 발생합니다.</li></ul>                                                                                                                                     |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Value` InCallback | <p>메시지가 도착하면 호출할 함수입니다.</p><ul><li>콜백은 다음 필드를 가진 테이블 하나를 인자로 받습니다.</li><li>Data : 발행된 메시지 데이터입니다. 메시지 없이 발행했으면 이 필드가 없습니다.</li><li>Sent : 메시지가 발행된 시각(Unix 시간, 초)입니다.</li><li>함수가 아닌 값을 전달하면 오류가 발생합니다.</li></ul> |

#### Return

| `ScriptConnection` | 등록한 콜백의 연결 객체입니다. Disconnect()를 호출하면 구독이 해제됩니다. |
| ------------------ | ----------------------------------------------- |

#### Code Samples

## Events
