[task] | two_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 인스턴스 룸이 생성될 때 최초 한 번만 로직을 수행하기 위해 어떤 이벤트를 사용해야 하나요? [answer] | 인스턴스 룸이 생성될 때 최초 한 번만 로직을 수행하려면 **RoomBeginEvent**를 사용해야 합니다. 이 이벤트는 `RoomService`에서 발생하며, 서버 공간(Server Space)에서 동작합니다. `InstanceRoomLogic` 스크립트의 이벤트 핸들러에 `[service: RoomService]`를 지정하고 `HandleRoomBeginEvent`를 구현하여 해당 로직을 작성할 수 있습니다. ```lua Event Handler: [service: RoomService] HandleRoomBeginEven [followup] | `InstanceRoomLogic` 스크립트에서 `RoomBeginEvent` 핸들러를 정의하고 8초 간격으로 타이머를 설정하는 전체 코드 블록을 작성해 주세요. [followup_answer] | ```lua Event Handler: [service: RoomService] HandleRoomBeginEvent(RoomBeginEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Space: Server --------------------------------------------------------- -- Parameters -------------- [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의 IsInstanceRoom() 메서드를 활용해 인스턴스 룸이 아닐 경우 RoomEndEvent 처리를 즉시 종료하는 로직을 포함하는 스크립트를 작성해줘 [answer] | RoomService의 `IsInstanceRoom()` 메서드를 사용하여 현재 룸이 인스턴스 룸이 아닌 경우 `RoomEndEvent` 처리를 즉시 중단하는 로직을 포함하는 스크립트는 다음과 같습니다. ```lua Event Handler: [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info ---------------- -- Sender: RoomService -- Spa [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] | InstanceRoomLogic 스크립트에서 _RoomService:IsInstanceRoom()을 호출하여 인스턴스 룸이면 TextRoomState 엔티티의 Enable 프로퍼티를 true로 설정하고, 정적 룸이면 false로 설정하는 로직을 OnBeginPlay 메서드에 구현해줘. [answer] | InstanceRoomLogic 스크립트에서 `_RoomService:IsInstanceRoom()`을 통해 현재 룸이 인스턴스 룸인지 확인하고, 결과에 따라 `TextRoomState` 엔티티의 `Enable` 프로퍼티를 설정하는 로직은 다음과 같습니다. ```lua Property: [None] Entity TextRoomState = /ui/DefaultGroup/Txt_RoomState Method: [client only] void OnBeginPlay() { -- 인스턴스 룸에서만 상태 엔티티를 활성화 합니다. [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] | RoomSharedMemory의 총 용량 제한과 이벤트 프로퍼티 전송 용량 제한의 차이를 단계별 번호 목록으로 설명해 주세요. [answer] | RoomSharedMemory의 총 용량 제한과 이벤트 프로퍼티 전송 용량 제한은 적용되는 대상과 범위가 다릅니다. 두 제한 사항의 차이는 다음과 같습니다. 1. **적용 대상 및 범위**: - **공유 메모리 하나의 총 용량**: 해당 RoomSharedMemory 객체 자체에 저장되어 있는 모든 데이터(공유 변수들 포함)의 전체 크기를 의미합니다. - **전송할 이벤트 프로퍼티의 총 용량**: 룸끼리 통신을 위해 이벤트를 전송할 때, 그 이벤트에 포함되어 전송되는 프로퍼티 데이터의 크기를 의미합니다. 2. **제한 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # RoomSharedMemory 제한 사항 RoomSharedMemory를 사용할 때는 아래의 제한 사항을 염두에 두고 사용해야 합니다. #### 작명 규칙 RoomSharedMemory와 공유 변수 이름은 아래 문자로만 작명할 수 있습니다. 최소 1글자 이상의 이름이어야 하며, 최대 100글자 이름일 수 있습니다. * **알파벳 대,소문자** * **숫자** * **공백** * **_, -** #### 수량 및 용량 제한 * 한 월드 당 생성 가능한 RoomSharedMemory는 최대 100개입니다. * 하나의 공유
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 인스턴스 룸 파괴 시 IsPlaying 상태를 false로 초기화하고 공용 룸에 전달하는 코드의 정확한 실행 순서는 어떻게 되나요? [answer] | 인스턴스 룸이 파괴될 때 `IsPlaying` 상태를 초기화하고 공용 룸에 전달하는 코드의 실행 순서는 다음과 같습니다. 1. **`RoomEndEvent` 수신**: 인스턴스 룸이 파괴되면 `RoomService`에서 `RoomEndEvent`가 발생하며 `HandleRoomEndEvent` 핸들러가 호출됩니다. 2. **인스턴스 룸 여부 확인**: `_RoomService:IsInstanceRoom()`을 호출하여 현재 룸이 인스턴스 룸인지 확인합니다. 인스턴스 룸이 아니라면 함수를 종료(`return`)합니다. 3. * [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] | StaticRoomLogic 스크립트에서 _RoomService:IsInstanceRoom()을 호출하여 인스턴스 룸이 아니면 ButtonEnter 엔티티의 Enable 프로퍼티를 true로 설정하고, 인스턴스 룸이면 false로 설정하는 로직을 OnBeginPlay 메서드에 구현해줘. [answer] | StaticRoomLogic 스크립트에서 요구하신 로직은 `OnBeginPlay` 메서드 내에서 `_RoomService:IsInstanceRoom()`을 호출하여 현재 룸이 인스턴스 룸인지 확인하고, 결과에 따라 `ButtonEnter` 엔티티의 `Enable` 프로퍼티를 설정하는 방식으로 구현할 수 있습니다. 아래는 해당 로직이 포함된 mLua 스크립트입니다. ```lua Property: [None] Entity ButtonEnter = /ui/DefaultGroup/Btn_Enter Method: [client only [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] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomService를 활용해 정적 룸에서만 실행되도록 OnUpdate에서 조건을 걸고 InstanceRoomLogic의 IsPlaying 값을 읽어 ButtonEnter의 TextComponent와 ButtonComponent 상태를 제어하는 스크립트를 작성해줘 [answer] | `RoomService`를 활용하여 정적 룸(Static Room)에서만 실행되도록 조건을 설정하고, `InstanceRoomLogic`의 `IsPlaying` 값에 따라 `ButtonEnter`의 텍스트와 활성화 상태를 제어하는 스크립트는 다음과 같습니다. 이 스크립트는 정적 룸에 있는 UI 컨트롤러 스크립트(예: `StaticRoomLogic` 또는 버튼 UI를 제어하는 스크립트)에 적용됩니다. ```lua Property: [None] Entity ButtonEnter = nil Method: [client only] v [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 서비스의 RoomEndEvent 핸들러에서 인스턴스 룸 파괴 시 상태 초기화와 룸 간 통신을 수행하는 전체 스크립트를 작성해줘 [answer] | RoomService의 `RoomEndEvent` 핸들러를 구현하여 인스턴스 룸이 파괴될 때 `IsPlaying` 상태를 초기화하고, 이 상태 변경을 정적 룸(Static Room)으로 전달하는 전체 스크립트입니다. ```lua Property: [Sync] boolean IsPlaying = false Event Handler: [service: RoomService] HandleRoomEndEvent(RoomEndEvent event) { --------------- Native Event Sender Info --- [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] | RoomService를 활용해 룸끼리 통신하기 [question] | 정적 룸에서 인스턴스 룸으로부터 수신한 이벤트를 처리할 때 주의해야 할 점은 무엇인가요? [answer] | 정적 룸에서 인스턴스 룸으로부터 수신한 이벤트를 처리할 때 가장 중요한 주의사항은 **이벤트 핸들러가 정적 룸에서만 실행되도록 조건을 명시적으로 검사하는 것**입니다. RoomService를 통해 인스턴스 룸에서 보낸 이벤트는 정적 룸의 스크립트에서 수신되지만, 혹시 모를 오류나 중복 실행을 방지하기 위해 핸들러 내부에서 `_RoomService:IsInstanceRoom()`을 확인하여 인스턴스 룸인 경우 즉시 반환(`return`)하도록 로직을 작성해야 합니다. 이는 이벤트가 정적 룸의 서버 공간에서만 처리되도록 보장하기 위함 [followup] | `HandleRoomStateChangedEvent` 핸들러 내에서 인스턴스 룸에서 실행되지 않도록 체크하는 조건문과 상태를 저장하는 코드를 포함해 예시를 보여주세요. [followup_answer] | 인스턴스 룸에서 실행되지 않도록 체크하는 조건문과 수신한 상태를 저장하는 코드는 다음과 같습니다. ```lua Property: boolean IsPlaying = false Event Handler: [service: RoomService] HandleRoomStateChangedEvent(RoomStateChangedEvent event) { -- Parameters local IsPlaying = event.IsPlaying ------------------------------------------- [scores] | [judge_reason] | [source_doc] | 새로운 이벤트를 생성하고, 그 이벤트를 사용해 인스턴스 룸의 상태를 정적 룸에 공유하게 만들어 봅시다. 1. **Workspace - MyDesk의 콘텍스트 메뉴에서 Create Scripts - Create Event**를 선택해 새로운 **RoomStateChangedEvent**를 생성합니다. 2. boolean 타입의 **IsPlaying** 프로퍼티를 추가합니다. ```lua Property: boolean IsPlaying = false ``` 3. **InstanceRoomLogic**을
[task] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | `SharedMemoryResultCode.OK` 검사와 실패 시 처리(`error`, `return`)가 포함된 공유 메모리 변수 저장 코드를 단계별 번호 목록 형식으로 설명하세요. [answer] | 공유 메모리에 변수를 저장할 때 `SharedMemoryResultCode.OK` 검사와 실패 시 처리를 포함한 단계별 과정은 다음과 같습니다. 1. **공유 메모리 객체 획득** `_RoomService:GetSharedMemory(roomKey)`를 호출하여 공유 메모리 객체를 가져옵니다. 호출 결과로 상태 코드(`code`)와 메모리 객체(`mem`)를 반환받습니다. 2. **메모리 획득 성공 여부 확인** 반환된 `code`가 `SharedMemoryResultCode.OK`와 다른지 확인합니다. [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] | 인스턴스 룸의 IsPlaying 상태를 정적 룸에 공유할 때, RoomStateChangedEvent의 boolean 타입 프로퍼티를 생성하지 않고 직접 값을 전달하면 어떤 오류가 발생합니까? [answer] | 제공된 문서에는 `RoomStateChangedEvent`에 boolean 타입의 `IsPlaying` 프로퍼티를 생성하지 않고 직접 값을 전달했을 때 발생하는 구체적인 오류 메시지나 동작에 대한 정보가 포함되어 있지 않습니다. 문서에서는 단순히 "boolean 타입의 **IsPlaying** 프로퍼티를 추가합니다"라고 절차만 안내하고 있으며, 이 프로퍼티가 없거나 다른 방식으로 값을 전달할 경우 어떤 에러가 나는지에 대해서는 설명하고 있지 않습니다. [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] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 공용 룸에서 인스턴스 룸의 게임 진행 상태를 실시간으로 확인하려면 어떤 절차로 이벤트를 주고받아야 하나요? [answer] | 공용 룸(Static Room)에서 인스턴스 룸의 게임 진행 상태를 실시간으로 확인하기 위해서는 `RoomService`를 통해 이벤트를 주고받는 절차가 필요합니다. 주어진 문서에 명시된 절차는 다음과 같습니다. **1. 인스턴스 룸에서 상태 변경 시 공용 룸으로 이벤트 전송** 인스턴스 룸에서 게임 진행 상태(예: `IsPlaying`)가 변경되면, 해당 상태를 포함하여 공용 룸으로 이벤트를 전송해야 합니다. 문서에는 인스턴스 룸이 파괴될 때 상태를 초기화하는 예시가 제공되며, 이때 `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] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 정적 맵과 인스턴스 맵 두 개의 Logic 컴포넌트에서 RoomService의 GetSharedMemory()로 동일한 메모리 객체를 참조하여, 인스턴스 룸에서 "게임 중" 상태 값이 변경될 때 정적 룸의 Txt_RoomState UI가 즉시 업데이트되도록 통신하는 스크립트를 작성해줘. [answer] | 제시된 참고 문서에는 `RoomService`의 `GetSharedMemory()`, `DeleteSharedMemoryAndWait()`, `DeleteSharedMemoryAsync()` 함수의 존재만 언급되어 있을 뿐, 공유 메모리 객체의 구체적인 프로퍼티(예: `value`, `data` 등)나 메서드(예: `Set`, `Get`, `Subscribe` 등)에 대한 API 정의가 포함되어 있지 않습니다. 또한, 공유 메모리 값이 변경될 때 정적 룸으로 이벤트를 전송하거나 클라이언트 UI를 즉시 업데이트하도록 트리거하는 구체적 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 RoomService를 활용해 하나의 월드 인스턴스 안에 있는 정적 룸과 인스턴스 룸끼리 통신을 할 수 있습니다. 이 가이드는 예제 위주로 진행되며, 기본 개념은 [WorldInstanceService](/apiReference?postId=1034)와 동일합니다. [월드 인스턴스](/docs/?postId=984), [월드 인스턴스 통신](/docs/?postId=999), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 먼저 학습하기를 권장합니다. # RoomService로 통신 정적
[task] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomService와 InstanceRoomLogic을 활용해 인스턴스 룸의 IsPlaying 상태가 변경될 때 정적 룸의 버튼 텍스트와 활성화 여부를 갱신하는 스크립트를 작성해줘 [answer] | RoomService와 InstanceRoomLogic을 활용하여 인스턴스 룸의 `IsPlaying` 상태에 따라 정적 룸의 버튼 텍스트와 활성화 여부를 갱신하는 로직은 두 개의 별도 스크립트로 구현됩니다. 정적 룸에서는 `StaticRoomLogic`을, 인스턴스 룸에서는 `InstanceRoomLogic`을 사용합니다. 정적 룸의 `StaticRoomLogic`은 `_RoomService:IsInstanceRoom()`을 통해 정적 룸임을 확인한 후, `_InstanceRoomLogic.IsPlaying` 값을 읽어 `Upda [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | InstanceRoomLogic의 IsPlaying 프로퍼티 값에 따라 버튼의 내용이 바뀔 수 있도록 만들어 봅시다. 정적 룸과 인스턴스 룸에서 로직은 별도로 실행되므로 인스턴스 룸의 변경된 IsPlaying 값을 정적 룸에 전달해야 합니다. 아래 그림과 같이 IsPlaying 값을 전달할 수 있도록 UI를 변경하는 코드를 작성해 봅시다. 1. StaticRoomLogic에 `OnUpdate`를 추가합니다. ```lua [client only] void OnUpdate(number delta) {
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 파티클 사용하기 [question] | 참고 API Reference에 포함된 이벤트(Event) 이름만 3문장 이내로 설명 없이 나열하세요. [answer] | ParticleEmitEndEvent, ParticleEmitStartEvent, ParticleLoopEvent [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 파티클이란 눈이나 비, 먼지 같은 다수의 작은 입자를 말합니다. 파티클 컴포넌트를 통해 입자의 속성과 재생 상태를 제어할 수 있습니다. 이번 시간에는 파티클 컴포넌트의 개념과 활용 방법을 살펴봅시다. ##### 참고 API Reference [BaseParticleComponent](/apiReference/Components/BaseParticleComponent) [AreaParticleComponent](/apiReference/Components/AreaParticleComponent) [BasicPa
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 인스턴스 룸에서 RoomBeginEvent 핸들러를 작성할 때 if _RoomService:IsInstanceRoom() == false then return end 구문을 넣어야 하는 이유는 무엇인가요? [answer] | `if _RoomService:IsInstanceRoom() == false then return end` 구문을 넣는 이유는 **인스턴스 룸에서만 실행되도록 제한하기** 위해서입니다. `RoomBeginEvent`는 인스턴스 룸이 생성될 때 발생하지만, 정적 룸과 인스턴스 룸 모두에서 이 이벤트를 수신할 수 있습니다. 이 로직은 인스턴스 룸의 상태(`IsPlaying`)를 주기적으로 변경하여 정적 룸으로 전송하는 것이 목적입니다. 따라서 정적 룸에서 이 코드가 실행되면 불필요하게 타이머가 설정되거나 상태가 변경되는 오류가 발생할 [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] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | UpdateButton 함수에서 사용되는 <color=red> 와 같은 태그 문법은 mLua 의 어떤 컴포넌트 프로퍼티를 통해 적용되는지, 그리고 이 형식의 문자열을 다른 UI 요소에도 사용할 수 있는지 확인해 주세요. [answer] | 제시된 참고 문서에 `<color=red>`와 같은 태그 문법이 mLua의 특정 컴포넌트 프로퍼티(예: `FontColor`)를 통해 직접적으로 처리되는지, 혹은 다른 UI 요소에도 적용 가능한지에 대한 명시적인 설명은 포함되어 있지 않습니다. 문서에서는 `UpdateButton` 및 `UpdateText` 함수에서 `TextComponent.Text` 프로퍼티에 이러한 태그가 포함된 문자열을 대입하는 코드 예제만 제시하고 있을 뿐, 태그의 지원 범위나 내부 동작 원리를 설명하지 않습니다. 따라서 해당 태그 문법이 어떤 프로퍼티를 [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] | RoomService를 활용해 룸끼리 통신하는 방식에 대해 소개해 주세요. [answer] | RoomService를 활용한 룸 간 통신은 **공유 메모리(Shared Memory)** 를 통해 데이터를 주고받는 방식입니다. 각 룸(Room)은 독립된 환경이지만, 동일한 키(key)를 가진 공유 메모리에 접근하여 데이터를 읽거나 쓰면서 다른 룸의 스크립트와 정보를 공유할 수 있습니다. 주요 API와 동작 방식은 다음과 같습니다. ### 1. 주요 API * `_RoomService:GetSharedMemory(memKey)`: 지정된 키를 가진 공유 메모리 객체를 가져옵니다. * `mem:CreateVariable [followup] | 공유 메모리에서 값을 읽을 때 GetVariableAndWait를 사용하는 코드 예시를 보여주세요. [followup_answer] | 공유 메모리에서 값을 읽기 위해 `GetVariableAndWait`를 사용하는 코드 예시는 다음과 같습니다. ```lua Method: [server only] void ReadTitleFromSharedMemory() { local memKey = "ExampleRoom" local varName = "roomTitle" -- 지정된 키를 가진 공유 메모리 객체를 가져옵니다. local code, mem = _RoomService:GetSharedMemory(memKey) [scores] | [judge_reason] | [source_doc] | ```lua [server only] void ReadTitleFromSharedMemory() { local memKey = "ExampleRoom" local varName = "roomTitle" local code, mem = _RoomService:GetSharedMemory(memKey) if code ~= SharedMemoryResultCode.OK then error ("Failed to G
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 파티클 사용하기 [question] | 문서에 명시된 세 가지 파티클 사용 방법을 표로 정리해서 출력하세요. [answer] | | 방법 | 설명 | |---|---| | Preset List에서 배치 | Preset List - Particle Effect에서 원하는 파티클을 Scene에 배치합니다. | | 엔티티에 파티클 컴포넌트 추가 | 파티클을 생성할 엔티티의 Property에 파티클 컴포넌트를 추가합니다. | | Workspace에서 추가 | Workspace에서 파티클 모델을 선택해 Scene에 배치합니다. | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 파티클이란 눈이나 비, 먼지 같은 다수의 작은 입자를 말합니다. 파티클 컴포넌트를 통해 입자의 속성과 재생 상태를 제어할 수 있습니다. 이번 시간에는 파티클 컴포넌트의 개념과 활용 방법을 살펴봅시다. ##### 참고 API Reference [BaseParticleComponent](/apiReference/Components/BaseParticleComponent) [AreaParticleComponent](/apiReference/Components/AreaParticleComponent) [BasicPa
[task] | code [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | WorldInstanceService와 RoomService를 조합하여 정적 맵의 Btn_Enter 버튼을 눌렀을 때 인스턴스 맵으로 유저를 이동시키고, 인스턴스 맵에서는 OnBeginPlay() 시점에 공유 메모리에 "대기 중" 상태를 기록하는 스크립트를 작성해줘. [answer] | 참고 문서에 포함된 정보만으로 질문하신 내용을 구현할 수 없습니다. **이유:** 1. **`WorldInstanceService` API 부재:** 제공된 참고 문서에는 `RoomService`와 `UserService`, `EntityService`, `SpawnService`에 대한 정보만 포함되어 있습니다. `WorldInstanceService`의 구체적인 함수명(인스턴스 생성, 유저 이동 등)이 문서에 명시되어 있지 않아 정확한 코드를 작성할 수 없습니다. 2. **공유 메모리 API 제한:** 문서에서는 공유 메모 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 RoomService를 활용해 하나의 월드 인스턴스 안에 있는 정적 룸과 인스턴스 룸끼리 통신을 할 수 있습니다. 이 가이드는 예제 위주로 진행되며, 기본 개념은 [WorldInstanceService](/apiReference?postId=1034)와 동일합니다. [월드 인스턴스](/docs/?postId=984), [월드 인스턴스 통신](/docs/?postId=999), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 먼저 학습하기를 권장합니다. # RoomService로 통신 정적
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 파티클 사용하기 [question] | 월드용과 UI용 파티클 컴포넌트의 종류를 구분하여 단계별 번호 목록으로 나열하세요. [answer] | 월드용과 UI용 파티클 컴포넌트는 다음과 같이 구분됩니다. **1. 월드용 파티클 컴포넌트** 1. `BasicParticleComponent` 2. `SpriteParticleComponent` 3. `AreaParticleComponent` **2. UI용 파티클 컴포넌트** 1. `UIBasicParticleComponent` 2. `UISpriteParticleComponent` 3. `UIAreaParticleComponent` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 파티클이란 눈이나 비, 먼지 같은 다수의 작은 입자를 말합니다. 파티클 컴포넌트를 통해 입자의 속성과 재생 상태를 제어할 수 있습니다. 이번 시간에는 파티클 컴포넌트의 개념과 활용 방법을 살펴봅시다. ##### 참고 API Reference [BaseParticleComponent](/apiReference/Components/BaseParticleComponent) [AreaParticleComponent](/apiReference/Components/AreaParticleComponent) [BasicPa
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomStateChangedEvent를 정적 룸으로 보낼 때 왜 _RoomService.StaticRoomKey를 매개변수로 반드시 전달해야 하나요? [answer] | `RoomStateChangedEvent`를 정적 룸으로 보내기 위해 `_RoomService:RequestSendEventToRoomAndWait(evt, _RoomService.StaticRoomKey)`를 호출할 때 두 번째 매개변수로 `_RoomService.StaticRoomKey`를 전달하는 이유는, **이벤트를 특정 대상 룸(정적 룸)으로 라우팅하기 위해서**입니다. `_RoomService:RequestSendEventToRoomAndWait()` 함수는 생성된 이벤트 객체(`evt`)와 함께 **수신 대상 룸을 식 [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를 활용하여 정적 룸에서 인스턴스 룸으로 전환할 수 있는 버튼(ButtonEnter)과 인스턴스 룸에서 현재 상태를 표시하는 텍스트(TextRoomState)의 가시성을 각각의 룸 타입에 따라 제어하는 두 개의 스크립트(StaticRoomLogic, InstanceRoomLogic)를 OnBeginPlay에서 구현해줘. [answer] | 메이플스토리 월드의 `RoomService` API를 활용하여 정적 룸과 인스턴스 룸의 타입에 따라 UI 요소의 가시성을 제어하는 두 개의 스크립트입니다. ### 1. StaticRoomLogic 스크립트 이 스크립트는 정적 룸에서만 "인스턴스 룸으로 입장" 버튼이 보이도록 제어합니다. ```lua Property: [None] Entity ButtonEnter = /ui/DefaultGroup/Btn_Enter Method: [client only] void OnBeginPlay() { -- 정적 룸에서만 입장 버튼 [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] | 한 월드에서 생성할 수 있는 RoomSharedMemory의 최대 개수는 몇 개인가요? [answer] | 한 월드에서 생성할 수 있는 RoomSharedMemory의 최대 개수는 100개입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # RoomSharedMemory 제한 사항 RoomSharedMemory를 사용할 때는 아래의 제한 사항을 염두에 두고 사용해야 합니다. #### 작명 규칙 RoomSharedMemory와 공유 변수 이름은 아래 문자로만 작명할 수 있습니다. 최소 1글자 이상의 이름이어야 하며, 최대 100글자 이름일 수 있습니다. * **알파벳 대,소문자** * **숫자** * **공백** * **_, -** #### 수량 및 용량 제한 * 한 월드 당 생성 가능한 RoomSharedMemory는 최대 100개입니다. * 하나의 공유
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | RoomSharedMemory의 변수 이름에 하이픈이나 밑줄을 사용할 수 있나요? [answer] | 네, RoomSharedMemory의 변수 이름에 하이픈(-)과 밑줄(_)을 사용할 수 있습니다. 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] | 공유 변수 하나에 저장할 수 있는 데이터 용량의 한계는 어떻게 되나요? [answer] | 공유 변수 하나에 저장할 수 있는 데이터 용량의 최대 한계는 **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] | `_InstanceRoomLogic.IsPlaying` 값을 정적 룸의 `OnUpdate`에서 직접 참조하여 버튼 상태를 갱신하는 방식의 작동 원리와 `_RoomService:IsInstanceRoom()` 판별 로직이 궁금합니다. [answer] | 제시된 문서를 기준으로 `_InstanceRoomLogic.IsPlaying` 참조 방식과 `_RoomService:IsInstanceRoom()` 판별 로직의 작동 원리를 설명합니다. ### 1. `_InstanceRoomLogic.IsPlaying` 참조와 버튼 갱신 원리 정적 룸(Static Room)과 인스턴스 룸(Instance Room)은 물리적으로 분리되어 로직이 별도로 실행됩니다. 따라서 정적 룸의 스크립트가 인스턴스 룸의 상태 변화(예: 게임 시작/종료)를 알기 위해서는 **인스턴스 룸의 로직 컴포넌트(`Inst [followup] | 정적 룸과 인스턴스 룸이 물리적으로 분리된 상태에서 `_InstanceRoomLogic` 컴포넌트 객체를 직접 접근할 수 있는 이유와, 만약 `IsPlaying`이 `false`에서 `true`로 변경되었을 때 `OnUpdate`가 매 프레임 실행되어 `UpdateButton`이 중복 호출되는 성능 이슈를 방지하기 위한 최적화 코드 예제가 필요해요. [followup_answer] | 제시된 참고 문서를 기준으로 답변드립니다. ### 1. `_InstanceRoomLogic` 컴포넌트 객체에 직접 접근할 수 있는 이유 참고 문서에 따르면, 정적 룸과 인스턴스 룸은 로직이 **별도로 실행**되는 독립된 공간이지만, 정적 룸의 스크립트(`StaticRoomLogic`)에서 `_InstanceRoomLogic.IsPlaying`을 직접 참조할 수 있습니다. 문서는 "인스턴스 룸의 변경된 `IsPlaying` 값을 정적 룸에 전달해야 합니다"라고 명시하며, 이를 위해 정적 룸의 `OnUpdate`에서 `_Insta [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의 GetOrCreateInstanceRoom과 MoveUserToInstanceRoom을 조합하여 userId 매개변수를 받는 EnterInstanceRoom 메서드를 StaticRoomLogic에 구현하고, 이 메서드가 ExampleRoom 키와 map02 맵 이름을 사용해 유저를 이동시키도록 하는 스크립트를 작성해줘 [answer] | 요청하신 `EnterInstanceRoom` 메서드는 `StaticRoomLogic` 스크립트에 `[server]` 실행 공간으로 선언되어야 하며, `RoomService`를 통해 인스턴스 룸을 생성(또는 가져오기)하고 지정된 유저를 해당 룸의 맵으로 이동시키는 로직을 포함해야 합니다. 아래는 `StaticRoomLogic` 컴포넌트에 해당 메서드를 구현한 mLua 스크립트입니다. ```lua Method: [server] void EnterInstanceRoom(string userId) { local 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] | instruction_following [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 문서에 제시된 `ReadTitleFromSharedMemory` 메서드에서 `GetSharedMemory` 호출 시 반환되는 `code` 값이 `SharedMemoryResultCode.OK`가 아닐 때 발생하는 동작을 1문장으로 설명하세요. [answer] | `code` 값이 `SharedMemoryResultCode.OK`가 아닐 경우 "Failed to GetSharedMemory."라는 오류 메시지와 함께 `error` 함수를 호출하여 스크립트 실행을 중단하고 메서드를 즉시 반환합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua [server only] void ReadTitleFromSharedMemory() { local memKey = "ExampleRoom" local varName = "roomTitle" local code, mem = _RoomService:GetSharedMemory(memKey) if code ~= SharedMemoryResultCode.OK then error ("Failed to G
[task] | single_turn [pass] | ⏳ 미판정 [title] | RoomService를 활용해 룸끼리 통신하기 [question] | 전송할 이벤트 프로퍼티의 총 용량이 80,000 byte를 초과하면 어떤 문제가 발생하나요? [answer] | 전송할 이벤트 프로퍼티의 총 용량이 80,000 byte를 초과하면, RoomSharedMemory의 제한 사항을 위반하게 되어 통신이 정상적으로 이루어지지 않을 수 있습니다. 해당 용량은 이벤트 전송 시 허용되는 최대 크기로, 이를 넘을 경우 시스템이 데이터를 처리하지 못해 오류가 발생하거나 이벤트가 전달되지 않는 문제가 생길 수 있습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # RoomSharedMemory 제한 사항 RoomSharedMemory를 사용할 때는 아래의 제한 사항을 염두에 두고 사용해야 합니다. #### 작명 규칙 RoomSharedMemory와 공유 변수 이름은 아래 문자로만 작명할 수 있습니다. 최소 1글자 이상의 이름이어야 하며, 최대 100글자 이름일 수 있습니다. * **알파벳 대,소문자** * **숫자** * **공백** * **_, -** #### 수량 및 용량 제한 * 한 월드 당 생성 가능한 RoomSharedMemory는 최대 100개입니다. * 하나의 공유