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