Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

메시지를 발행할 토픽 이름입니다.

  • 빈 문자열이거나 UTF-8 기준 80바이트를 넘으면 오류가 발생합니다.

Value InMessage

(선택 사항) 발행할 메시지 데이터입니다.

  • nil, boolean, number, string, buffer 및 이들로 구성된 table을 전달할 수 있습니다.

  • 직렬화한 크기가 1KB를 넘거나, 중첩이 너무 깊거나 요소가 너무 많으면 오류가 발생합니다.

  • 유효한 UTF-8이 아닌 문자열, 순환 참조가 있는 테이블, 지원하지 않는 타입의 값을 전달하면 오류가 발생합니다.

Return

void

Code Samples

SubscribeAsync

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

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

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

Parameters

string InTopic

구독할 토픽 이름입니다.

  • 빈 문자열이거나 UTF-8 기준 80바이트를 넘으면 오류가 발생합니다.

Value InCallback

메시지가 도착하면 호출할 함수입니다.

  • 콜백은 다음 필드를 가진 테이블 하나를 인자로 받습니다.

  • Data : 발행된 메시지 데이터입니다. 메시지 없이 발행했으면 이 필드가 없습니다.

  • Sent : 메시지가 발행된 시각(Unix 시간, 초)입니다.

  • 함수가 아닌 값을 전달하면 오류가 발생합니다.

Return

ScriptConnection

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

Code Samples

Events

Last updated