[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 인스턴스 룸으로 보낼 때 `MoveUserToInstanceRoom`의 세 번째 매개변수인 mapName 값은 어떤 기준으로 정해야 하나요? [answer] | `MoveUserToInstanceRoom`의 세 번째 매개변수인 `mapName`은 **인스턴스 룸에서 플레이어가 스폰될 맵의 이름**을 지정하는 값입니다. 따라서 해당 인스턴스 룸에서 플레이어가 입장 후 어떤 맵(또는 맵 영역)에 위치하게 할 것인지를 기준으로 설정해야 합니다. 예를 들어, 인스턴스 룸의 플레이어가 "map02"라는 맵에 입장하게 하려면 `mapName`에 `"map02"`를 넣습니다. ```lua [server] void EnterInstanceRoom(string userId) { local ro [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 입장 버튼을 누른 플레이어가 인스턴스 룸에 입장할 수 있게 아래와 같이 작성합니다. 1. **StaticRoomLogic**에 새로운 **EnterInstanceRoom**을 추가합니다. Add Parameter를 누른 뒤, string 타입의 userId 매개 변수를 추가합니다. `RoomService`를 활용해 인스턴스 룸의 key를 가져오고, 유저를 해당 인스턴스 룸으로 보낼 수 있게 아래와 같이 작성합니다. ```lua [server] void EnterInstanceRoom(string userId)
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 메이커(에디터) 환경에서는 모든 유저가 같은 월드 인스턴스로 입장하는 것으로 확인되는데, 실제 출시 환경과 다른 동작을 확인하기 위해 로그를 분석할 때 주의해야 할 점은 무엇인가요? [answer] | 메이커(에디터) 환경에서는 모든 유저가 동일한 월드 인스턴스로 입장하기 때문에, 서로 다른 월드 인스턴스 간 통신을 테스트할 때 로그의 출처를 명확히 구분해야 합니다. 주의해야 할 점은 다음과 같습니다. 1. **로그 문구 분석**: * `User '닉네임' has entered this world instance.`: 현재 스크립트가 실행 중인 월드 인스턴스와 유저가 입장한 월드 인스턴스가 **같음**을 의미합니다. 메이커 환경에서는 이 로그만 출력됩니다. * `User '닉네임' has entered [followup] | 다른 월드 인스턴스에서 입장이 감지되었을 때 `log` 문구와 동일한 구조로 알림을 전송하는 추가 로직 예제를 작성해 주세요. [followup_answer] | 다른 월드 인스턴스에서 입장이 감지되었을 때 `log` 문구와 동일한 구조의 문자열을 생성하여 알림을 전송하는 예제입니다. 참고 문서에 포함된 API(`_WorldInstanceService`, `_UserService`, `MyUserEnterEvent` 등)와 스크립트 구조를 기반으로 작성했으며, 알림 전송을 위해 일반적일 수 있는 메서드 이름을 가정한 경우를 제외하고는 문서에 명시된 로직만 따랐습니다. 문서에 구체적인 '알림 전송 API'(예: `_NoticeService` 등)가 명시되어 있지 않으므로, 알림 전송 부분을 [scores] | [judge_reason] | [source_doc] | 월드 인스턴스끼리 서로의 이벤트를 감지하는 예제입니다. 1. Workspace - MyDesk - Create Scripts - Create EventType - 새로운 **MyUserEnterEvent**를 생성합니다. 2. **MyUserEnterEvent**에 프로퍼티를 추가합니다. ```lua Property: string WorldInstanceId = "" string Nickname = "" ``` 3. Workspace - MyDesk - Create Scripts - Cre
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 제공된 RoomEndEvent 코드에서 인스턴스 룸이 아닐 때 즉시 종료되는 조건문과 해당 문장의 위치를 3문장 이내로 설명하세요. [answer] | 코드 내 `HandleRoomEndEvent` 함수의 본문 시작 부분에 `if _RoomService:IsInstanceRoom() == false then return end` 조건문이 위치합니다. 이 조건은 현재 룸이 인스턴스 룸이 아닌 경우 함수의 실행을 즉시 중단시킵니다. 이로 인해 상태 초기화 및 이벤트 전송 로직은 인스턴스 룸에서만 수행됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | InstanceRoomLogic에서 8초 간격으로 상태를 변경하고 정적 룸으로 전송하는 코드를 주석으로만 설명하여 출력하세요. [answer] | InstanceRoomLogic 스크립트에서 8초 간격으로 상태를 변경하고 정적 룸으로 전송하는 로직은 `HandleRoomBeginEvent` 이벤트 핸들러 내에서 구현됩니다. 먼저 인스턴스 룸에서만 실행되도록 `_RoomService:IsInstanceRoom()` 체크를 수행합니다. 이후 `_TimerService:SetTimerRepeat`을 사용하여 8초마다 실행되는 함수를 등록합니다. 이 함수 내부에서는 `self.IsPlaying` 값을 반전시킨 뒤, 이를 담을 `RoomStateChangedEvent` 인스턴스를 생 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 새로운 이벤트를 생성하고, 그 이벤트를 사용해 인스턴스 룸의 상태를 정적 룸에 공유하게 만들어 봅시다. 1. **Workspace - MyDesk의 콘텍스트 메뉴에서 Create Scripts - Create Event**를 선택해 새로운 **RoomStateChangedEvent**를 생성합니다. 2. boolean 타입의 **IsPlaying** 프로퍼티를 추가합니다. ```lua Property: boolean IsPlaying = false ``` 3. **InstanceRoomLogic**을
[task] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomService와 InstanceRoomLogic을 활용해 인스턴스 룸에서 IsPlaying 상태에 따라 TextRoomState 컴포넌트의 텍스트 색과 문구를 갱신하는 스크립트를 작성해줘 [answer] | `InstanceRoomLogic` 스크립트 컴포넌트에서 `IsPlaying` 프로퍼티의 값에 따라 `TextRoomState` 엔티티의 텍스트와 색상을 갱신하는 로직입니다. `RoomService`의 `IsInstanceRoom` 메서드를 사용하여 인스턴스 룸에서만 실행되도록 제어합니다. ```lua Property: [None] boolean IsPlaying = false Method: [client only] void OnUpdate(number delta) { -- 인스턴스 룸에서만 실행합니다. if _R [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | InstanceRoomLogic의 IsPlaying 프로퍼티 값에 따라 버튼의 내용이 바뀔 수 있도록 만들어 봅시다. 정적 룸과 인스턴스 룸에서 로직은 별도로 실행되므로 인스턴스 룸의 변경된 IsPlaying 값을 정적 룸에 전달해야 합니다. 아래 그림과 같이 IsPlaying 값을 전달할 수 있도록 UI를 변경하는 코드를 작성해 봅시다. 1. StaticRoomLogic에 `OnUpdate`를 추가합니다. ```lua [client only] void OnUpdate(number delta) {
[task] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomService를 활용해 인스턴스 룸에서만 실행되도록 OnUpdate에서 조건을 걸고 self.IsPlaying 값에 따라 TextRoomState 컴포넌트의 텍스트를 갱신하는 스크립트를 작성해줘 [answer] | 사용자가 요청한 인스턴스 룸 전용 로직과 텍스트 갱신 스크립트는 다음과 같습니다. ```lua Property: [None] boolean IsPlaying = false Method: [client only] void OnUpdate(number delta) { -- 인스턴스 룸에서만 실행되도록 조건을 걸었습니다. if _RoomService:IsInstanceRoom() == false then return end -- self.IsPlaying 상태에 따라 텍스트를 갱신합 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | InstanceRoomLogic의 IsPlaying 프로퍼티 값에 따라 버튼의 내용이 바뀔 수 있도록 만들어 봅시다. 정적 룸과 인스턴스 룸에서 로직은 별도로 실행되므로 인스턴스 룸의 변경된 IsPlaying 값을 정적 룸에 전달해야 합니다. 아래 그림과 같이 IsPlaying 값을 전달할 수 있도록 UI를 변경하는 코드를 작성해 봅시다. 1. StaticRoomLogic에 `OnUpdate`를 추가합니다. ```lua [client only] void OnUpdate(number delta) {
[task] | two_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 정적 룸에서 8초마다 변경되는 인스턴스 룸의 상태를 실시간으로 조회하여 UI의 Txt_RoomState에 반영하는 로직은 어떻게 작성합니까? [answer] | RoomService를 활용하여 정적 룸(Static Map)에서 인스턴스 룸(Instance Map)의 상태를 실시간으로 조회하고 UI에 반영하는 로직은 **공유 메모리(Shared Memory)**를 통해 데이터를 주고받는 방식으로 구현됩니다. 제시된 참고 문서에는 "8초마다 인스턴스 룸의 상태를 게임 중과 대기 중으로 바꾸고, 정적 룸에서 이를 조회하여 공유하는 예제"가 설명되어 있지만, **구체적인 mLua 코드 블록은 제공되지 않았습니다.** 또한, `RoomService`의 `GetSharedMemory()`, `Del [followup] | MapComponent의 InstanceMap 속성을 활용해 인스턴스 맵을 지정하는 과정과, 두 개의 Logic 및 Event Type을 연결하는 구체적인 mLua 코드 예제는 어떻게 됩니까? [followup_answer] | 제시된 참고 문서를 근거로 답변드립니다. ### 1. MapComponent의 InstanceMap 속성을 활용한 인스턴스 맵 지정 과정 참고 문서의 '사전 준비' 섹션에 따르면, 인스턴스 맵으로 지정한 맵(map02)의 `MapComponent`를 선택한 뒤, 해당 컴포넌트의 **`InstanceMap`** 속성을 활용하여 인스턴스 맵으로 지정할 수 있습니다. * **정적 맵**: map01 * **인스턴스 맵**: map02 (`MapComponent.InstanceMap` 설정 필요) > **참고:** 문서에는 [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 RoomService를 활용해 하나의 월드 인스턴스 안에 있는 정적 룸과 인스턴스 룸끼리 통신을 할 수 있습니다. 이 가이드는 예제 위주로 진행되며, 기본 개념은 [WorldInstanceService](/apiReference?postId=1034)와 동일합니다. [월드 인스턴스](/docs/?postId=984), [월드 인스턴스 통신](/docs/?postId=999), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 먼저 학습하기를 권장합니다. # RoomService로 통신 정적
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomService의 IsInstanceRoom() 함수를 사용해서 정적 룸과 인스턴스 룸에서 UI 버튼을 다르게 보이게 하려면 어떤 코드를 작성해야 하나요? [answer] | RoomService의 `IsInstanceRoom()` 메서드를 사용하여 정적 룸과 인스턴스 룸에서 UI 엔티티의 가시성을 다르게 설정하는 방법은 다음과 같습니다. 1. **Workspace - MyDesk**에서 마우스 오른쪽 버튼(콘텍스트 메뉴)을 눌러 **Create Scripts - Create Logic**을 선택하여 로직 스크립트를 생성합니다. 2. `Property:` 블록에 표시할 UI 버튼 엔티티를 `[None]` 타입의 `Entity` 프로퍼티로 선언하고, 해당 엔티티의 경로를 연결합니다. 3. `Method: [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 1. **Workspace - MyDesk의 콘텍스트 메뉴에서 Create Scripts - Create Logic**을 선택해 새로운 **StaticRoomLogic**을 만듭니다. 2. 새로운 **ButtonEnter** 프로퍼티를 추가하고, 반환 타입을 Entity로 변경합니다. **Btn_Enter**을 연결합니다. ```lua Property: [None] Entity ButtonEnter = /ui/DefaultGroup/Btn_Enter ``` 3. 정적 룸에서만 인스턴스 룸으로 갈
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | `Btn_Enter` 버튼의 Event Handler에서 `event.Entity`를 가져와도 실제 클릭한 유저의 정보를 알 수 없는 이유는 무엇인가요? [answer] | `Btn_Enter` 버튼의 Event Handler에서 `event.Entity`를 사용해도 실제 클릭한 유저의 정보를 직접 알 수 없는 이유는, 이 이벤트 핸들러가 **클라이언트(Client) 공간**에서 발생하기 때문입니다. 참고 문서의 코드 주석에 따르면 `ButtonClickEvent`는 다음과 같은 특성을 가집니다: * **Sender**: ButtonComponent * **Space**: Client 클라이언트 공간에서 발생하는 이벤트의 `event.Entity`는 보통 UI 버튼 자체나 관련 엔티티를 가리 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 입장 버튼을 누른 플레이어가 인스턴스 룸에 입장할 수 있게 아래와 같이 작성합니다. 1. **StaticRoomLogic**에 새로운 **EnterInstanceRoom**을 추가합니다. Add Parameter를 누른 뒤, string 타입의 userId 매개 변수를 추가합니다. `RoomService`를 활용해 인스턴스 룸의 key를 가져오고, 유저를 해당 인스턴스 룸으로 보낼 수 있게 아래와 같이 작성합니다. ```lua [server] void EnterInstanceRoom(string userId)
[task] | code [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | WorldInstanceService와 WorldInstanceSharedMemory를 활용해 "BossStatus" 메모리에서 "isAlive" 변수가 true에서 false로 변경되었을 때, 모든 월드 인스턴스에서 알람을 표시하도록 이벤트를 트리거하는 스크립트를 작성해줘 [answer] | 제공된 참고 문서에는 `WorldInstanceService`와 `WorldInstanceSharedMemory`를 사용하여 공유 변수를 생성, 조회, 수정, 삭제하는 방법과 ETag를 통한 동시성 제어만 설명되어 있습니다. 문서에 명시된 API 목록(`GetSharedMemory`, `CreateVariableAndWait`, `GetVariableAndWait`, `UpdateVariableAndWait`, `DeleteVariableAndWait`, `DeleteSharedMemoryAndWait`)에는 **공유 변수의 값이 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `WorldInstanceService`와 `WorldInstanceSharedMemory`를 활용해 월드 인스턴스끼리 데이터를 공유하고 이벤트를 보내는 방법에 대해 알아봅시다. 월드 인스턴스와 룸 개념은 [월드 인스턴스](/docs?postId=984), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 참고하세요. >**Tip.** > 룸끼리의 통신을 구현하고 싶다면 `RoomService`의 동일한 함수명을 사용해보세요. # WorldInstanceSharedMemory 월드 인스턴스
[task] | code [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | - 과제 4: WorldInstanceService의 WorldInstanceId를 확인하고, 이를 활용해 특정 월드 인스턴스 ID로 RequestSendEventToWorldInstanceAndWait를 통해 이벤트를 전송하려는 로직의 구조를 만드는 스크립트를 작성해줘 [answer] | 과제 4를 위해 `WorldInstanceService`의 `WorldInstanceId`를 확인하고, 특정 월드 인스턴스 ID로 `RequestSendEventToWorldInstanceAndWait`를 호출하여 이벤트를 전송하는 로직 구조를 갖춘 스크립트를 작성합니다. 참고 문서에 따르면, 월드 인스턴스 ID는 `_WorldInstanceService.WorldInstanceId` 속성으로 조회할 수 있으며, 특정 인스턴스로 이벤트를 보내기 위해서는 `RequestSendEventToWorldInstanceAndWait` 함수 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **ETag**는 공유 변수의 데이터가 최신 상태인지 확인하기 위해 필요합니다. ETag는 식별자입니다. 데이터를 생성 또는 수정하거나, 기록을 조회할 때마다 새로운 ETag를 발급합니다. 발급한 ETag는 데이터의 버전을 기록하고, 비교하는데 사용합니다. ETag를 사용하는 이유는 여러 월드 인스턴스에서 하나의 공유 변수를 사용하면 어떤 데이터가 최신 데이터인지, 수정되었는지 알기 어렵기 때문입니다. 또한 여러 월드 인스턴스에서 공유 변수에 접근하므로 예기치 못하게 데이터를 덮어 쓸 수 있기 때문입니다. 공유 변수와 ETag는
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | OnBeginPlay() 함수 내에서 _RoomService:IsInstanceRoom() 체크를 하지 않고 바로 ButtonEnter.Enable = true로 설정하면 어떤 문제가 발생할 수 있나요? [answer] | `OnBeginPlay()` 함수 내에서 `_RoomService:IsInstanceRoom()` 체크를 생략하고 무조건 `ButtonEnter.Enable = true`로 설정하면, **인스턴스 룸(Instance Room)에서도 "정적 룸에서 인스턴스 룸으로 이동"하는 버튼이 표시되는 문제**가 발생합니다. 참고 문서의 `StaticRoomLogic` 예제를 보면, 이 버튼은 오직 정적 룸(Static Room)에서 인스턴스 룸으로 이동할 때만 활성화되어야 하는 UI입니다. 1. **UI 혼란 및 기능 오류**: * [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 1. **Workspace - MyDesk의 콘텍스트 메뉴에서 Create Scripts - Create Logic**을 선택해 새로운 **StaticRoomLogic**을 만듭니다. 2. 새로운 **ButtonEnter** 프로퍼티를 추가하고, 반환 타입을 Entity로 변경합니다. **Btn_Enter**을 연결합니다. ```lua Property: [None] Entity ButtonEnter = /ui/DefaultGroup/Btn_Enter ``` 3. 정적 룸에서만 인스턴스 룸으로 갈
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomEndEvent 처리 과정에서 IsPlaying 상태를 초기화하고 정적 룸으로 이벤트를 전송하기 위해 호출되는 API 함수 두 가지를 표로 정리하세요. [answer] | RoomEndEvent 처리 과정에서 `IsPlaying` 상태를 초기화하고 정적 룸으로 이벤트를 전송하기 위해 호출되는 API 함수는 다음과 같습니다. | API 함수 | 역할 | | :--- | :--- | | `_RoomService:IsInstanceRoom()` | 현재 룸이 인스턴스 룸인지 확인하여, 인스턴스 룸이 아닐 경우 함수 실행을 중단하도록 조건을 제어합니다. | | `_RoomService:RequestSendEventToRoomAndWait(evt, _RoomService.StaticRoomKey)` | 생성 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomEndEvent 핸들러 내의 주석과 코드 구조를 유지하면서, IsPlaying 초기화 후 StaticRoomKey 로 이벤트를 전송하는 로직만 코드 블록으로 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua Event Handler: [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --------------------------------------------------------- -- Parameters --------------- [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | `HandleMyUserEnterEvent` 핸들러에서 `service`를 `WorldInstanceService`로 지정해야 하는 이유는 무엇이며, 이 설정을 변경하면 어떤 차이가 있나요? [answer] | `HandleMyUserEnterEvent` 핸들러에서 `service`를 `WorldInstanceService`로 지정해야 하는 이유는, 이 이벤트가 `WorldInstanceService`를 통해 다른 월드 인스턴스로부터 수신되기 때문입니다. 메이플스토리 월드에서는 월드 인스턴스 간 통신을 위해 `_WorldInstanceService:RequestSendEventToAllWorldInstancesAndWait(evt)` 함수를 사용합니다. 이 함수를 호출하면 이벤트가 모든 월드 인스턴스에 전달되며, 각 월드 인스턴스에서는 [followup] | 만약 `self`를 `service`로 변경하지 않고 기본값을 유지했을 때, `_WorldInstanceService.WorldInstanceId` 접근이 정상적으로 동작하는지 예외 상황을 설명해 주세요. [followup_answer] | 참고 문서에 따르면, `HandleMyUserEnterEvent`를 작성할 때 **`self`를 `service`로 변경하고 `WorldInstanceService`를 지정하는 절차(단계 5, 6)가 명시적으로 요구**됩니다. 이는 커스텀 이벤트(`MyUserEnterEvent`)를 `WorldInstanceService`를 통해 수신하기 위한 필수 설정입니다. 만약 `self`를 `service`로 변경하지 않고 기본값(일반적으로 `self`는 엔티티를 가리킴)을 유지했을 때의 동작은 다음과 같이 설명할 수 있습니다. ### [scores] | [judge_reason] | [source_doc] | 월드 인스턴스끼리 서로의 이벤트를 감지하는 예제입니다. 1. Workspace - MyDesk - Create Scripts - Create EventType - 새로운 **MyUserEnterEvent**를 생성합니다. 2. **MyUserEnterEvent**에 프로퍼티를 추가합니다. ```lua Property: string WorldInstanceId = "" string Nickname = "" ``` 3. Workspace - MyDesk - Create Scripts - Cre
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomSharedMemory의 작명 규칙에 허용되는 문자와 길이 제한을 3문장 이내로 요약해 주세요. [answer] | RoomSharedMemory와 공유 변수 이름은 알파벳 대소문자, 숫자, 공백, 밑줄(_) 및 하이픈(-)으로만 작명할 수 있습니다. 이름은 최소 1글자 이상이어야 하며 최대 100글자까지 허용됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # RoomSharedMemory 제한 사항 RoomSharedMemory를 사용할 때는 아래의 제한 사항을 염두에 두고 사용해야 합니다. #### 작명 규칙 RoomSharedMemory와 공유 변수 이름은 아래 문자로만 작명할 수 있습니다. 최소 1글자 이상의 이름이어야 하며, 최대 100글자 이름일 수 있습니다. * **알파벳 대,소문자** * **숫자** * **공백** * **_, -** #### 수량 및 용량 제한 * 한 월드 당 생성 가능한 RoomSharedMemory는 최대 100개입니다. * 하나의 공유
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 정적 룸에서 인스턴스 룸으로 이동하는 버튼은 StaticRoomLogic에, 인스턴스 룸 상태 표시는 InstanceRoomLogic에 구현하는 것이 왜 권장되는 구조인가요? [answer] | 정적 룸과 인스턴스 룸은 각각 다른 목적과 실행 컨텍스트를 가지기 때문에, 로직을 분리하는 것이 권장됩니다. 1. **실행 공간과 목적의 분리**: - **StaticRoomLogic**: 정적 룸(모든 유저가 함께 머무는 공용 공간)에서 실행되는 로직입니다. 이 곳에서 "인스턴스 룸으로 이동하기" 버튼(`ButtonEnter`)을 관리하는 것이 자연스럽습니다. 정적 룸에서는 모든 유저가 동일한 UI를 보며 인스턴스 룸 생성 또는 입장을 시도하므로, 이 버튼의 가시성(`Enable`)을 정적 룸 컨텍스트에서 제어해야 합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 1. **Workspace - MyDesk의 콘텍스트 메뉴에서 Create Scripts - Create Logic**을 선택해 새로운 **StaticRoomLogic**을 만듭니다. 2. 새로운 **ButtonEnter** 프로퍼티를 추가하고, 반환 타입을 Entity로 변경합니다. **Btn_Enter**을 연결합니다. ```lua Property: [None] Entity ButtonEnter = /ui/DefaultGroup/Btn_Enter ``` 3. 정적 룸에서만 인스턴스 룸으로 갈
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | `StaticRoomLogic`의 `EnterInstanceRoom` 함수에서 공유 메모리에 룸 이름을 저장하는 과정만 코드 블록으로 출력하고, 설명은 주석으로만 작성하세요. [answer] | ```lua -- 인스턴스 룸을 생성하기 전, 공유 메모리에 룸 이름을 저장하는 과정 local roomTitleVarName = "roomTitle" local roomTitle = "Hello, MapleStory Worlds!" -- 공유 메모리를 얻어옵니다. local code, mem = _RoomService:GetSharedMemory(roomKey) if code ~= SharedMemoryResultCode.OK then error ("Failed to GetSharedMemory.") return [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 공유 메모리 활용 위에서 만든 예제 월드에서 새로운 UI를 추가하고, 해당 인스턴스 룸에 입장했을 때 공유 메모리 내용이 나타나도록 만들어 봅시다. 1. 텍스트 UI를 DefaultGroup에 추가하고 **Txt_RoomTitle** 이름으로 설정합니다. 2. **InstanceRoomLogic**에 새로운 Entity 타입의 **TextRoomTitle** 프로퍼티를 추가합니다. Txt_RoomTitle UI를 연결합니다. ```lua Property: [None] Entity TextRoom
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 인스턴스 룸이 종료될 때 공용 룸으로 상태 변경을 알리기 위해 어떤 이벤트를 보내야 하나요? [answer] | 인스턴스 룸이 종료(파괴)될 때 공용 룸으로 상태 변경을 알리기 위해 `RoomStateChangedEvent`를 사용해야 합니다. 이 이벤트는 `RoomEndEvent` 핸들러 내부에서 생성하여 `_RoomService:RequestSendEventToRoomAndWait` 함수를 통해 공용 룸(`_RoomService.StaticRoomKey`)으로 전송합니다. 아래는 인스턴스 룸 종료 시 상태를 초기화하고 공용 룸으로 알림을 보내는 `RoomEndEvent` 핸들러 코드입니다. ```lua Event Handler: [s [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomSharedMemory의 수량 및 용량 제한 조건을 표로 정리해서 출력해 주세요. [answer] | RoomSharedMemory의 수량 및 용량 제한 조건은 다음과 같습니다. | 구분 | 제한 조건 | | :--- | :--- | | 생성 가능한 RoomSharedMemory 수 | 한 월드 당 최대 100개 | | 공유 변수 1개당 저장 용량 | 최대 80,000 bytes | | 공유 메모리 1개 총 용량 | 최대 80MiB | | 전송할 이벤트 프로퍼티 총 용량 | 최대 80,000 bytes | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # RoomSharedMemory 제한 사항 RoomSharedMemory를 사용할 때는 아래의 제한 사항을 염두에 두고 사용해야 합니다. #### 작명 규칙 RoomSharedMemory와 공유 변수 이름은 아래 문자로만 작명할 수 있습니다. 최소 1글자 이상의 이름이어야 하며, 최대 100글자 이름일 수 있습니다. * **알파벳 대,소문자** * **숫자** * **공백** * **_, -** #### 수량 및 용량 제한 * 한 월드 당 생성 가능한 RoomSharedMemory는 최대 100개입니다. * 하나의 공유
[task] | two_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomService를 활용해 정적 룸과 인스턴스 룸 간 통신을 구현하려면 어떤 전제 조건과 기본 구조가 필요합니까? [answer] | RoomService를 활용해 정적 룸과 인스턴스 룸 간 통신을 구현하기 위한 전제 조건과 기본 구조는 다음과 같습니다. ### 1. 전제 조건 * **룸 간 직접 통신 불가**: 정적 룸(Static Room)과 인스턴스 룸(Instance Room)은 서로 직접적으로 통신할 수 없습니다. * **RoomService 필수 사용**: 룸끼리 이벤트나 데이터를 공유하려면 반드시 `RoomService`의 함수를 사용해야 합니다. * **공유 메모리(Shared Memory) 활용**: 같은 월드 인스턴스 내의 룸끼리 [followup] | 공유 메모리를 생성하고 삭제하는 GetSharedMemory()와 DeleteSharedMemoryAndWait() 함수의 구체적인 사용 시나리오와 예외 처리 방법은 무엇입니까? [followup_answer] | 제공된 참고 문서에는 `GetSharedMemory()`와 `DeleteSharedMemoryAndWait()` 함수가 공유 메모리를 생성/조회 및 삭제하는 용도로 사용된다는 사실만 명시되어 있습니다. 문서에는 이 함수들의 구체적인 사용 시나리오(어떤 데이터 구조를 전달하는지, 반환값이 무엇인지 등)나 예외 처리 방법이 포함되어 있지 않습니다. 따라서 요청하신 구체적인 사용 시나리오와 예외 처리 방법은 문서에 근거하여 답변할 수 없습니다. [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 RoomService를 활용해 하나의 월드 인스턴스 안에 있는 정적 룸과 인스턴스 룸끼리 통신을 할 수 있습니다. 이 가이드는 예제 위주로 진행되며, 기본 개념은 [WorldInstanceService](/apiReference?postId=1034)와 동일합니다. [월드 인스턴스](/docs/?postId=984), [월드 인스턴스 통신](/docs/?postId=999), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 먼저 학습하기를 권장합니다. # RoomService로 통신 정적
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | `EnterInstanceRoom` 함수의 실행 공간을 `[server]`로 설정한 이유는 무엇이며, `[client]`로 바꾸면 어떤 오류가 납니까? [answer] | `EnterInstanceRoom` 함수의 실행 공간을 `[server]`로 설정하는 주된 이유는 이 함수 내에서 사용되는 `_RoomService`의 특정 API가 서버 환경에서만 실행될 수 있기 때문입니다. 문서에 제시된 `EnterInstanceRoom` 함수는 다음과 같은 두 가지 핵심 작업을 수행합니다. 1. `_RoomService:GetOrCreateInstanceRoom(roomKey)`: 인스턴스 룸을 생성하거나 가져옵니다. 2. `_RoomService:MoveUserToInstanceRoom(roomKey, [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 입장 버튼을 누른 플레이어가 인스턴스 룸에 입장할 수 있게 아래와 같이 작성합니다. 1. **StaticRoomLogic**에 새로운 **EnterInstanceRoom**을 추가합니다. Add Parameter를 누른 뒤, string 타입의 userId 매개 변수를 추가합니다. `RoomService`를 활용해 인스턴스 룸의 key를 가져오고, 유저를 해당 인스턴스 룸으로 보낼 수 있게 아래와 같이 작성합니다. ```lua [server] void EnterInstanceRoom(string userId)
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomStateChangedEvent를 생성한 후 IsPlaying 값을 설정해야 하는 이유는 무엇인가요? [answer] | `RoomStateChangedEvent`를 생성한 후 `IsPlaying` 값을 설정하는 이유는, **인스턴스 룸의 상태 변화(게임 진행 여부)를 다른 룸(특히 정적 룸)에 전달하기 위해서**입니다. 참고 문서의 `HandleRoomEndEvent` 코드를 보면 다음과 같은 흐름을 확인할 수 있습니다. 1. **상태 초기화**: 인스턴스 룸이 파괴될 때 스크립트 내부의 `self.IsPlaying` 변수를 `false`로 변경합니다. 2. **이벤트 객체 생성**: `RoomStateChangedEvent()`를 통해 새로 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | HandleRoomEndEvent 핸들러에서 _RoomService:IsInstanceRoom() 체크를 생략하면 어떤 문제가 발생할 수 있나요? [answer] | `HandleRoomEndEvent` 핸들러에서 `_RoomService:IsInstanceRoom()` 체크를 생략하면, 인스턴스 룸이 아닌 일반(공용) 룸에서도 `RoomEndEvent`가 발생할 경우 불필요한 로직이 실행되는 문제가 발생할 수 있습니다. 구체적인 문제는 다음과 같습니다. 1. **상태 초기화 오작동:** 예제 코드에서 `self.IsPlaying = false`를 수행합니다. 인스턴스 룸이 아닌 일반 룸에서 이 이벤트 핸들러가 실행되면, 해당 스크립트가 붙어 있는 엔티티의 `IsPlaying` 상태 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 월드 인스턴스 간 통신에서 유저 입장 이벤트를 전달하려면 어떤 프로세스를 거쳐야 하나요? [answer] | 월드 인스턴스 간 통신으로 유저 입장 이벤트를 전달하려면 다음과 같은 3단계 프로세스를 거쳐야 합니다. ### 1. 커스텀 이벤트 타입 정의 먼저 `MyUserEnterEvent`라는 이름의 커스텀 이벤트 타입을 생성하고, 월드 인스턴스 ID와 유저 닉네임을 전달할 프로퍼티를 추가합니다. ```lua Property: string WorldInstanceId = "" string Nickname = "" ``` ### 2. 이벤트 전송 로직 작성 (발신 측) `UserEnterEvent` 네이티브 이벤트를 수신하여 모든 월드 [followup] | `RequestSendEventToAllWorldInstancesAndWait` 메서드가 실행될 때 `MyUserEnterEvent` 객체에 `WorldInstanceId`와 `Nickname`을 어떻게 채워 넣어야 하는지 코드로 보여주세요. [followup_answer] | `MyUserEnterEvent` 객체를 생성할 때 생성자 인자 순서대로 `WorldInstanceId`와 `Nickname` 값을 전달하여 채워 넣습니다. `_WorldInstanceService.WorldInstanceId`로 현재 월드 인스턴스 ID를, `_UserService:GetUserEntityByUserId(UserId)`로 가져온 유저 엔티티의 `PlayerComponent.Nickname`으로 유저 닉네임을 추출한 뒤, `MyUserEnterEvent(worldInstId, nickname)` 형태로 인스턴스를 [scores] | [judge_reason] | [source_doc] | 월드 인스턴스끼리 서로의 이벤트를 감지하는 예제입니다. 1. Workspace - MyDesk - Create Scripts - Create EventType - 새로운 **MyUserEnterEvent**를 생성합니다. 2. **MyUserEnterEvent**에 프로퍼티를 추가합니다. ```lua Property: string WorldInstanceId = "" string Nickname = "" ``` 3. Workspace - MyDesk - Create Scripts - Cre
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | `InstanceRoomLogic`에서 인스턴스 룸 입장 시 UI를 활성화하는 `OnBeginPlay` 로직과 `Title` 프로퍼티 선언부를 표로 정리하여 출력하세요. [answer] | 요청하신 `InstanceRoomLogic`의 `OnBeginPlay` 로직과 `Title` 프로퍼티 선언부를 정리한 표입니다. | 구분 | 내용 | 코드 | | :--- | :--- | :--- | | **Title 프로퍼티 선언** | `string` 타입의 `Title` 프로퍼티를 `[Sync]` 속성으로 선언합니다. 초기값은 빈 문자열입니다. | ```lua<br>Property:<br>[Sync]<br>string Title = ""<br>``` | | **OnBeginPlay 로직** | `[client only]` 실 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 공유 메모리 활용 위에서 만든 예제 월드에서 새로운 UI를 추가하고, 해당 인스턴스 룸에 입장했을 때 공유 메모리 내용이 나타나도록 만들어 봅시다. 1. 텍스트 UI를 DefaultGroup에 추가하고 **Txt_RoomTitle** 이름으로 설정합니다. 2. **InstanceRoomLogic**에 새로운 Entity 타입의 **TextRoomTitle** 프로퍼티를 추가합니다. Txt_RoomTitle UI를 연결합니다. ```lua Property: [None] Entity TextRoom
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 정적 룸에서 인스턴스 룸으로 이동할 때 `IsInstanceRoom()` 체크가 필요한 이유와, 이 조건문을 빼면 어떤 문제가 발생하는지 설명해 주세요. [answer] | 정적 룸에서 인스턴스 룸으로 이동하는 로직에서 `IsInstanceRoom()` 체크가 필요한 이유는 **재귀 호출(Recursion)을 방지**하기 위해서입니다. ### 1. 체크가 필요한 이유 `EnterInstanceRoom` 함수는 `_RoomService:MoveUserToInstanceRoom`을 호출하여 유저를 인스턴스 룸으로 이동시킵니다. 이동 후 유저가 인스턴스 룸에 진입하게 되면, 해당 인스턴스 룸에서도 동일한 스크립트(컴포넌트)가 실행될 수 있습니다. 만약 이 조건문이 없다면, 인스턴스 룸 안에서도 다시 `En [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 입장 버튼을 누른 플레이어가 인스턴스 룸에 입장할 수 있게 아래와 같이 작성합니다. 1. **StaticRoomLogic**에 새로운 **EnterInstanceRoom**을 추가합니다. Add Parameter를 누른 뒤, string 타입의 userId 매개 변수를 추가합니다. `RoomService`를 활용해 인스턴스 룸의 key를 가져오고, 유저를 해당 인스턴스 룸으로 보낼 수 있게 아래와 같이 작성합니다. ```lua [server] void EnterInstanceRoom(string userId)
[task] | two_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomSharedMemory의 작명 규칙 및 용량 제한에 대해 알려주세요 [answer] | RoomSharedMemory를 사용할 때 지켜야 할 작명 규칙과 용량 제한은 다음과 같습니다. **1. 작명 규칙** RoomSharedMemory 이름과 공유 변수 이름은 다음 문자만 사용할 수 있습니다. * 알파벳 대소문자 (A-Z, a-z) * 숫자 (0-9) * 공백 * 언더스코어 (`_`) * 하이픈 (`-`) 이름의 길이는 최소 1글자 이상, 최대 100글자까지 가능합니다. **2. 수량 및 용량 제한** * **RoomSharedMemory 생성 수:** 한 월드당 최대 100개까지 생성할 [followup] | 공유 변수 이름에 특수문자를 사용할 수 없나요? [followup_answer] | 공유 변수 이름에 특수문자를 사용할 수 있는 범위는 제한적입니다. RoomSharedMemory와 공유 변수 이름에 사용할 수 있는 문자는 다음과 같습니다: * 알파벳 대소문자 * 숫자 * 공백 * 언더스코어(`_`) * 하이픈(`-`) 즉, `!`, `@`, `#`, `$`, `%`, `^`, `&`, `*`, `(`, `)`, `+`, `=`, `[`, `]`, `{`, `}`, `|`, `\`, `:`, `;`, `'`, `"`, `<`, `>`, `?`, `/`와 같은 일반적인 특수문자는 사용할 수 없습 [scores] | [judge_reason] | [source_doc] | # RoomSharedMemory 제한 사항 RoomSharedMemory를 사용할 때는 아래의 제한 사항을 염두에 두고 사용해야 합니다. #### 작명 규칙 RoomSharedMemory와 공유 변수 이름은 아래 문자로만 작명할 수 있습니다. 최소 1글자 이상의 이름이어야 하며, 최대 100글자 이름일 수 있습니다. * **알파벳 대,소문자** * **숫자** * **공백** * **_, -** #### 수량 및 용량 제한 * 한 월드 당 생성 가능한 RoomSharedMemory는 최대 100개입니다. * 하나의 공유
[task] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomEndEvent 핸들러에서 인스턴스 룸이 파괴될 때 self.IsPlaying 상태를 false로 초기화하고 StaticRoomKey로 RoomStateChangedEvent를 전송하는 스크립트를 작성해줘 [answer] | ```lua Property: [Sync] boolean IsPlaying = false Event Handler: [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server -------------------------------------------------------- [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --
[task] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomStateChangedEvent 객체를 생성해 IsPlaying 속성을 설정하고 RequestSendEventToRoomAndWait 메서드로 정적 룸에 이벤트를 전송하는 RoomEndEvent 처리 코드를 작성해줘 [answer] | ```lua Event Handler: [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --------------------------------------------------------- -- Parameters --------------- [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 6. **RoomEndEvent**를 추가합니다. 인스턴스 룸이 파괴될 때 IsPlaying 상태를 초기화할 수 있도록 아래와 같이 작성합니다. ```lua [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --