[task] | code [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | _LocalizationService:SmartFormat을 사용하여 숫자에 따라 "한 개" 또는 "여러 개"로 문장이 자연스럽게 변환되도록 로컬라이징 포맷을 올바르게 작성하는 스크립트를 작성해줘 [answer] | `_LocalizationService:SmartFormat`을 사용해 숫자(quantifier)에 따라 복수 형태를 변환하려면, 포맷 문자열 내의 `{index:plural:...}` 구문과 **입력하는 argument의 개수**를 언어 설정에 맞게 정확히 맞춰야 합니다. 문서 기준으로, 언어 설정에 따라 `plural`이 요구하는 argument 개수가 다르므로 주의해야 합니다. ### 1. 한국어 설정일 경우 한국어에서는 `plural` 포맷이 **1개의 formatter argument**만 받습니다. 즉, `SmartF [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 다음과 같이 포맷이 올바르지 않을 때는 원문 그대로 출력합니다. ##### formatterName이 틀린 경우 **formatterName**에 띄어쓰기가 포함되었거나, 오탈자가 있다면 원문이 그대로 출력됩니다. ```lua -- 1) 언어 설정 영어 : formatter name에 띄어쓰기가 포함된 경우 log(_LocalizationService:SmartFormat("I have {0: plural:an apple|{} apples}.", 2)) ``` ```lua -- 2) formatter name 자체가 틀린 경우
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | `BatchCreateVariableAndWait` 사용 예시를 코드만 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua -- WorldInstanceSharedMemory를 얻어옵니다. local code, mem = _WorldInstanceService:GetSharedMemory("MemoryName") -- 일괄 생성할 공유 변수 이름과 값을 키-값 쌍으로 구성된 테이블로 준비합니다. local nameValues = { ["b_var1"] = "b_value1", ["b_var2"] = "b_value2", ["b_var3"] = "b_value3" } -- BatchCreateVariableAndWait 함수를 호출하여 여 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드 인스턴스가 공유 변수를 생성, 조회, 수정을 하면 해당 공유 변수를 참조한 상태가 됩니다. 한 번 특정 공유 변수를 참조한 월드 인스턴스는 공유 변수가 삭제될 때까지 계속 참조 상태를 유지합니다. 만약 어떤 공유 변수를 여러 월드 인스턴스에서 참조하고 있을 때 특정 월드 인스턴스에서 해당 공유 변수를 삭제해버리면 다른 월드 인스턴스에서 공유 변수를 사용할 수 없게 됩니다. 이처럼 한 곳에서 데이터를 삭제했지만 전체 월드 인스턴스에게 영향을 주는 사고를 방지하기 위해 메이플스토리 월드는 WorldInstanceSharedMemo
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | `ScreenRecordService`의 `StartRecordToFileAndWait(ScreenRecordMode.ScreenAndGameAudio)`를 호출하여 녹화 파일을 생성하고, 완료 시 `MobileShareService`의 `ShareFile` 메서드를 이용해 해당 파일을 공유하는 스크립트를 작성해줘 [answer] | 제공된 참고 문서에는 `ScreenRecordService`와 `MobileShareService`의 존재와 기본 개념(녹화 모드, 플랫폼 제약 등)만 언급되어 있습니다. 그러나 질문에 포함된 구체적인 API 명세인 **`StartRecordToFileAndWait`의 반환값 처리 방법(콜백 또는 await 형태)**, **`MobileShareService`의 `ShareFile` 메서드 시그니처(인자 구성)**, 그리고 **녹화 완료 시점에 파일을 공유하는 정확한 이벤트 핸들러 또는 콜백 연결 방식**에 대한 코드가 문서에 포 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드에서는 `ScreenRecordService`를 활용하여 플레이 화면을 녹화하고 파일로 저장할 수 있습니다. 또한 `MobileShareService`를 활용하여 모바일에서 녹화한 영상을 손쉽게 공유할 수도 있습니다. 이번 시간에는 예제를 통해 `ScreenRecordService` 및 `MobileShareService`의 활용 방법을 알아보겠습니다. ##### 참고 API Reference [ScreenRecordService](/apiReference/Services/ScreenRecor
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | 모바일에서 녹화한 영상을 공유하기 위해 `FinishRecordAndWait()`가 반환하는 경로를 어떻게 활용해야 하나요? [answer] | 제공된 참고 문서에는 `FinishRecordAndWait()`가 반환하는 경로(`LastRecordedPath`)를 활용하여 모바일에서 영상을 **공유하는 구체적인 API나 코드 예제가 포함되어 있지 않습니다.** 문서에서 확인 가능한 내용은 다음과 같습니다: 1. `Finish()` 함수 내에서 `self.LastRecordedPath = _ScreenRecordService:FinishRecordAndWait()`를 호출하여 녹화 완료 시 파일 경로를 변수에 저장합니다. 2. 저장된 경로는 `log("Output : ", s [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # UI 가리고 영상 녹화하기 UI를 가리고 영상을 녹화하는 방법을 살펴봅시다. 1. UI 에디터로 들어가서 **DefaultGroup**에 **UIText**를 하나 추가하고 프로퍼티를 아래와 같이 설정합니다. | 프로퍼티 | 값 | | --- | --- | | RectSize | X = 700, Y = 100 | | Text | ScreenRecordService TEST | | FontSize | 50 | | ImageRUID | b9ab8455d5737bf4cb21433
[task] | code [pass] | ⏳ 미판정 [title] | 테스트 서버 [question] | 문서의 내용은 '테스트 서버 생성', '접속', '폐쇄'와 같은 **플랫폼 관리(운영) 절차**에 대한 설명만 담고 있으며, 코드 작성이나 로직 구현을 위한 API 명세가 없습니다. [answer] | 네, 맞습니다. 제공된 참고 문서에는 mLua 스크립트 작성이나 로직 구현을 위한 API, 함수, 이벤트 핸들러 명세가 전혀 포함되어 있지 않습니다. 문서는 오직 메이플스토리 월드 플랫폼의 **테스트 서버 운영 절차**에 대한 정보만 담고 있으며, 구체적인 내용은 다음과 같습니다. 1. **테스트 서버 생성**: 출시한 월드의 상세 정보 페이지에서 `[⋯]` 버튼을 눌러 콘텍스트 메뉴의 **[테스트 서버 열기]** 를 클릭하면 팝업창에서 입장하거나 서버 키를 복사할 수 있습니다. 2. **테스트 서버 접속**: **[테스트 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 출시한 월드에 안정적으로 콘텐츠 업데이트를 하려면 테스트 진행은 필수입니다. 예상치 못한 버그를 미리 발견하고 수정하기 위해 크리에이터는 테스트 서버를 열고 제한된 인원에게만 서버 키를 배포해 다양한 상황을 테스트할 수 있습니다. 이번 시간에는 테스트 서버 생성, 접속 및 폐쇄 방법을 알아보겠습니다. # 테스트 서버 생성 크리에이터가 출시한 월드의 상세 정보 페이지로 들어갑니다. [⋯] 버튼을 눌러 콘텍스트 메뉴를 열고 **[테스트 서버 열기]** 메뉴를 클릭합니다. 이후 열린 팝업창에서 테스트 서버로
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | Btn_Stop 버튼의 ButtonClickEvent를 처리하여 _ScreenRecordService:FinishRecordAndWait()를 호출하고, 반환된 저장 경로를 self.LastRecordedPath 프로퍼티에 저장하며 log()로 출력하는 스크립트를 작성해줘 [answer] | ```lua Property: [None] string LastRecordedPath = "" Method: [client only] void Finish() { _UIToast:ShowMessage("End recording") self.LastRecordedPath = _ScreenRecordService:FinishRecordAndWait() log("Output : ", self.LastRecordedPath) } Event Handler: [entity: /ui/RecordGroup/Btn_Stop [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 플랫폼 | StartRecordToFileAndWait() 함수 사용 시 저장 경로 | StartRecordToPhotoLibraryAndWait() 함수 사용 시 저장 경로 | | :---: | :---: | :---: | | Windows | @cols=2:@rows=1:내 PC > 동영상 > MapleStory Worlds > 월드 ID > MapleStory Worlds_*.mp4 | | macOS | @cols=2:@rows=1: 홈 > 비디오 > MapleStory Worlds > 월드 ID
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | WorldInstanceService의 이벤트 수신 공간이 어디인지 1문장으로 답변하세요. [answer] | WorldInstanceService의 이벤트 발생 공간은 서버입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터가 `WorldInstanceService`에 이벤트 핸들러를 연결해야 이벤트를 수신할 수 있습니다. 이벤트 발생 공간은 서버입니다. ```lua Event Handler: [service: WorldInstanceService] HandleMyWorldInstanceEvent(MyWorldInstanceEvent event ) { log ("Receive MyWorldInstanceEvent.") } ``` # WorldInstanceService 제한 사항 **WorldInstanceService**를 사
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 공유 변수 이름 작명 규칙에서 허용되는 문자 4가지를 줄바꿈 없이 쉼표로 구분해 나열하세요. [answer] | 알파벳 대,소문자, 숫자, 공백, _ , - [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터가 `WorldInstanceService`에 이벤트 핸들러를 연결해야 이벤트를 수신할 수 있습니다. 이벤트 발생 공간은 서버입니다. ```lua Event Handler: [service: WorldInstanceService] HandleMyWorldInstanceEvent(MyWorldInstanceEvent event ) { log ("Receive MyWorldInstanceEvent.") } ``` # WorldInstanceService 제한 사항 **WorldInstanceService**를 사
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | 윈도우 환경에서 StartRecordToFileAndWait()를 사용해도 공유 기능이 없어서 StartRecordToPhotoLibraryAndWait()로 대체해야 하는 이유는 무엇인가요? [answer] | 제공된 참고 문서에는 윈도우 환경에서 `StartRecordToFileAndWait()`를 사용하는 경우 "공유 기능이 없어" `StartRecordToPhotoLibraryAndWait()`로 대체해야 한다는 명제는 존재하지 않습니다. 문서 내용으로 확인되는 사실은 다음과 같습니다. 1. 윈도우 환경에서는 `StartRecordToPhotoLibraryAndWait()` 함수를 사용할 경우 저장 경로가 표에 비어 있습니다. (즉, 해당 함수가 윈도우에서 정상적으로 파일을 생성하거나 경로 반환을 보장하지 않음을 시사합니다.) 2 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 플랫폼 | StartRecordToFileAndWait() 함수 사용 시 저장 경로 | StartRecordToPhotoLibraryAndWait() 함수 사용 시 저장 경로 | | :---: | :---: | :---: | | Windows | @cols=2:@rows=1:내 PC > 동영상 > MapleStory Worlds > 월드 ID > MapleStory Worlds_*.mp4 | | macOS | @cols=2:@rows=1: 홈 > 비디오 > MapleStory Worlds > 월드 ID
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | MobileShareService를 사용하려고 하는데, 녹화 영상을 저장하는 StartRecordToFileAndWait() 함수의 최대 녹화 시간이 2분으로 제한되는 이유가 무엇인가요? [answer] | 제공된 참고 문서에는 `StartRecordToFileAndWait()` 함수의 최대 녹화 시간이 2분으로 제한되는 구체적인 이유에 대한 설명이 포함되어 있지 않습니다. 문서에는 녹화 시간이 최대 2분으로 제한된다는 사실과, `MobileShareService`를 사용하여 녹화 영상을 모바일에서 공유하는 방법(예: `ShareFileAndWait()` 호출)만 안내하고 있을 뿐, 시간 제한의 기술적 배경이나 원인은 언급하고 있지 않습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `MobileShareService`를 사용하면 녹화한 영상을 모바일에서 공유할 수 있습니다. 공유할 영상은 `StartRecordToFileAndWait()` 함수를 사용해 녹화해야 합니다. 단, 녹화 시간은 최대 2분으로 제한됩니다. 예제를 통해 모바일에서 녹화 영상을 공유하는 방법을 살펴봅시다. 1. **Btn_Record** 버튼의 콘텍스트 메뉴에서 **Duplicate** 버튼을 눌러 버튼을 복제합니다. 2. 복제한 버튼의 이름을 **Btn_Share**으로 변경하고, **Text**에는 **Share**을
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | OnBeginPlay()에서 _ScreenRecordService:StartRecordToFileAndWait()를 호출하여 자동 녹화를 시작하고, OnEndPlay()에서 _ScreenRecordService:FinishRecordAndWait()를 호출하여 녹화를 자동 종료하는 생명주기 관리 스크립트를 작성해줘 [answer] | 요청하신 대로 `OnBeginPlay()`에서 녹화를 시작하고, `OnEndPlay()`에서 녹화를 종료하는 생명주기 관리 스크립트입니다. 참고 문서에 따르면 `_ScreenRecordService:StartRecordToFileAndWait()`를 사용하면 플랫폼별 특정 경로(Windows, macOS, iOS, Android)에 파일이 저장되며, `_ScreenRecordService:FinishRecordAndWait()`를 호출하면 녹화가 종료되고 저장 경로가 반환됩니다. ```lua Property: [None] str [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 플랫폼 | StartRecordToFileAndWait() 함수 사용 시 저장 경로 | StartRecordToPhotoLibraryAndWait() 함수 사용 시 저장 경로 | | :---: | :---: | :---: | | Windows | @cols=2:@rows=1:내 PC > 동영상 > MapleStory Worlds > 월드 ID > MapleStory Worlds_*.mp4 | | macOS | @cols=2:@rows=1: 홈 > 비디오 > MapleStory Worlds > 월드 ID
[task] | two_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | UI를 가리고 영상을 녹화하는 기본적인 절차와 ScreenRecordService 사용법에 대해 설명해 주세요. [answer] | UI를 가리고 영상을 녹화하는 절차와 `ScreenRecordService` 사용법은 다음과 같습니다. ### 1. UI 가리고 영상 녹화하기 절차 1. **UI 준비**: UI 에디터에서 `DefaultGroup`에 `UIText`를 추가하여 녹화 시작/종료 등을 표시할 UI를 구성합니다. 2. **스크립트 설정**: 스크립트 에디터에서 대상 컴포넌트(예: `ScreenRecordServiceTest`)의 `Property` 블록에 가리고자 하는 UI 그룹을 참조하는 `EntityRef`를 선언합니다. ```lua [followup] | 녹화 시작 시 excludeSystemUI 옵션을 true로 설정하는 구체적인 코드 예시와, 녹화 종료 후 UI를 다시 표시하는 Finish() 함수의 구현 방법을 알려주세요. [followup_answer] | `excludeSystemUI` 옵션을 `true`로 설정하여 우측 상단 기본 시스템 UI를 숨긴 채 녹화를 시작하고, 녹화 종료 후 숨겼던 UI를 다시 표시하는 `Finish()` 함수의 구현 방법은 다음과 같습니다. ### 1. 녹화 시작 (excludeSystemUI 옵션 설정) `Record()` 함수에서 `_ScreenRecordService:StartRecordToFileAndWait`를 호출할 때 두 번째 인자로 `true`를 전달하면 `excludeSystemUI` 옵션이 활성화되어 기본 시스템 UI가 녹화에서 제 [scores] | [judge_reason] | [source_doc] | # UI 가리고 영상 녹화하기 UI를 가리고 영상을 녹화하는 방법을 살펴봅시다. 1. UI 에디터로 들어가서 **DefaultGroup**에 **UIText**를 하나 추가하고 프로퍼티를 아래와 같이 설정합니다. | 프로퍼티 | 값 | | --- | --- | | RectSize | X = 700, Y = 100 | | Text | ScreenRecordService TEST | | FontSize | 50 | | ImageRUID | b9ab8455d5737bf4cb21433
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | 메이플스토리 월드에서 화면 녹화 파일을 시작하고 종료하는 데 각각 어떤 함수를 사용해야 하며, 종료 시 반환되는 값은 무엇인가요? [answer] | 메이플스토리 월드에서 화면 녹화를 시작하고 종료하기 위해 사용할 함수와 반환 값은 다음과 같습니다. **1. 녹화 시작 함수** * **`StartRecordToFileAndWait()`**: 녹화 파일을 파일 시스템의 특정 경로에 저장하도록 시작합니다. * 저장 경로는 플랫폼에 따라 다르며, Windows, macOS, iOS, Android 각각의 문서에 명시된 경로에 `MapleStory Worlds_*.mp4` 또는 `MapleStoryWorlds_*.mp4` 파일로 저장됩니다. * **`StartReco [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 플랫폼 | StartRecordToFileAndWait() 함수 사용 시 저장 경로 | StartRecordToPhotoLibraryAndWait() 함수 사용 시 저장 경로 | | :---: | :---: | :---: | | Windows | @cols=2:@rows=1:내 PC > 동영상 > MapleStory Worlds > 월드 ID > MapleStory Worlds_*.mp4 | | macOS | @cols=2:@rows=1: 홈 > 비디오 > MapleStory Worlds > 월드 ID
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | 녹화 시작 전 `self.DefaultGroup.Visible = false`로 UI를 숨기고 녹화 종료 후 다시 true로 복원하는 과정이 왜 필요한가요? [answer] | `self.DefaultGroup.Visible = false`로 UI를 숨기고 녹화 종료 후 `true`로 복원하는 과정은 **녹화 영상에 게임의 사용자 인터페이스(UI)가 포함되지 않도록 하기 위해** 필요합니다. 구체적인 이유는 다음과 같습니다: 1. **깨끗한 화면 녹화:** `ScreenRecordService`의 `StartRecordToFileAndWait` 함수를 호출할 때 `excludeSystemUI` 옵션을 `true`로 설정하면 시스템 기본 UI(우측 상단 등)는 숨겨집니다. 하지만 사용자가 UI 에디터에 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # UI 가리고 영상 녹화하기 UI를 가리고 영상을 녹화하는 방법을 살펴봅시다. 1. UI 에디터로 들어가서 **DefaultGroup**에 **UIText**를 하나 추가하고 프로퍼티를 아래와 같이 설정합니다. | 프로퍼티 | 값 | | --- | --- | | RectSize | X = 700, Y = 100 | | Text | ScreenRecordService TEST | | FontSize | 50 | | ImageRUID | b9ab8455d5737bf4cb21433
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | WorldInstanceService의 수량 및 용량 제한 사항 4가지를 표로 정리하세요. [answer] | WorldInstanceService의 수량 및 용량 제한 사항은 다음과 같습니다. | 구분 | 제한 사항 | | :--- | :--- | | WorldInstanceSharedMemory 생성 수 | 한 월드 당 최대 100개 | | 단일 공유 변수 저장 용량 | 1개당 최대 80,000 bytes | | 공유 메모리 총 용량 | 1개당 80MiB 초과 불가 | | 이벤트 프로퍼티 전송 용량 | 총 80,000 byte 초과 불가 | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터가 `WorldInstanceService`에 이벤트 핸들러를 연결해야 이벤트를 수신할 수 있습니다. 이벤트 발생 공간은 서버입니다. ```lua Event Handler: [service: WorldInstanceService] HandleMyWorldInstanceEvent(MyWorldInstanceEvent event ) { log ("Receive MyWorldInstanceEvent.") } ``` # WorldInstanceService 제한 사항 **WorldInstanceService**를 사
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | 여러 마이크가 연결된 상태에서 녹음을 시작할 때, GetMicrophoneDevicesAndWait() 함수를 통해 사용자가 마이크를 선택하도록 하려면 어떤 절차를 거치는 것인가요? [answer] | 참고 문서에 `GetMicrophoneDevicesAndWait()` 함수의 구체적인 사용 절차, 반환 값 구조, 또는 마이크 선택 UI를 어떻게 구현하는지에 대한 코드 예제나 상세 설명이 포함되어 있지 않습니다. 문서에 명시된 내용만으로는 다음과 같은 사실만 확인할 수 있습니다: 1. 마이크가 여러 개 연결된 경우, 사용자에게 마이크 선택권을 제공해야 할 수 있습니다. 2. 이 경우 `GetMicrophoneDevicesAndWait()` 함수를 사용하여 사용자가 어떤 마이크를 입력할지 선택할 수 있도록 해야 합니다. 따라서 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `MobileShareService`를 사용하면 녹화한 영상을 모바일에서 공유할 수 있습니다. 공유할 영상은 `StartRecordToFileAndWait()` 함수를 사용해 녹화해야 합니다. 단, 녹화 시간은 최대 2분으로 제한됩니다. 예제를 통해 모바일에서 녹화 영상을 공유하는 방법을 살펴봅시다. 1. **Btn_Record** 버튼의 콘텍스트 메뉴에서 **Duplicate** 버튼을 눌러 버튼을 복제합니다. 2. 복제한 버튼의 이름을 **Btn_Share**으로 변경하고, **Text**에는 **Share**을
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | _finish() 메서드에서 _ScreenRecordService:FinishRecordAndWait()의 반환값이 빈 값인지 확인하여, 빈 값이면 _UIToast:ShowMessage()로 "공유 기능 미지원 환경입니다"라는 메시지를 표시하는 로직이 포함된 스크립트를 작성해줘 [answer] | `FinishRecordAndWait()` 함수의 반환값이 빈 값인지 확인하여, 빈 값이면 토스트 메시지를 표시하고 그렇지 않으면 정상적인 메시지를 표시하는 로직이 포함된 스크립트를 작성해 드립니다. 참고 문서에 따르면, 윈도우 환경에서는 공유 기능이 없어 `StartRecordToPhotoLibraryAndWait()`를 사용하게 되며, 이 경우 저장 경로로 **빈 값**이 반환됩니다. 따라서 반환값이 빈 값인 경우를 체크하여 메시지를 출력하는 것이 적절합니다. ```lua Property: [None] string LastR [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 플랫폼 | StartRecordToFileAndWait() 함수 사용 시 저장 경로 | StartRecordToPhotoLibraryAndWait() 함수 사용 시 저장 경로 | | :---: | :---: | :---: | | Windows | @cols=2:@rows=1:내 PC > 동영상 > MapleStory Worlds > 월드 ID > MapleStory Worlds_*.mp4 | | macOS | @cols=2:@rows=1: 홈 > 비디오 > MapleStory Worlds > 월드 ID
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | Btn_Record 버튼의 Touch 이벤트에 연결되어 _UIPopup을 띄우고, 사용자가 확인하면 _ScreenRecordService로 녹화를 시작하고 _UIToast로 결과를 알리는 스크립트를 작성해줘. [answer] | 참고 문서에 `Btn_Record` 버튼의 `Touch` 이벤트 핸들러를 직접 연결하는 코드 예제는 포함되어 있지 않습니다. 문서에 제시된 `Record()` 함수는 `_UIPopup:Open`을 사용하여 확인/취소 팝업을 띄운 후, 확인 시 `_ScreenRecordService:StartRecordToFileAndWait`를 호출하고 `_UIToast:ShowMessage`로 결과를 표시하는 로직만 제공합니다. 따라서 문서에 명시된 `Record()` 함수의 내용과 mLua 스크립트 형식을 기반으로, 사용자가 요청한 `Touc [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `ScreenRecordService`를 활용하여 영상을 녹화하는 예제를 살펴봅시다. **[Record]** 버튼을 누르면 녹화를 시작하고, **[Stop]** 버튼을 누르면 녹화를 종료하고 파일을 저장하겠습니다. 1. UI 에디터로 들어가서 **RecordGroup**이란 이름으로 새로운 UIGroup을 추가합니다. 그리고 **RecordGroup**의 **DefaultShow**를 **true**로 설정합니다. 2. 버튼을 하나 추가한 뒤 이름을 **Btn_Record**로 변경합
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 [question] | 월드 인스턴스끼리 통신하거나 이벤트를 전달하기 위해 RoomService와 WorldInstanceService를 어떻게 활용해야 하나요? [answer] | 월드 인스턴스는 독립적으로 실행되므로, 인스턴스끼리 통신하거나 이벤트를 전달하려면 `RoomService`와 `WorldInstanceService`를 활용해야 합니다. 참고 문서에는 두 서비스의 구체적인 메서드 목록이나 코드 사용 예제가 포함되어 있지 않습니다. 문서에서는 단순히 "세부적인 활용 방법은 월드 인스턴스 통신 문서를 참고하세요"라고 안내하고 있을 뿐, 실제 API 호출 방식은 제시하지 않습니다. 따라서 제공된 정보 범위 내에서 확인할 수 있는 내용은 다음과 같습니다: 1. **필요한 서비스**: `RoomSer [followup] | 정적 룸과 인스턴스 룸이 혼재된 구조에서, 특정 인스턴스에 있는 유저의 상태 변경을 다른 인스턴스에 있는 유저에게 실시간으로 전달하기 위한 mLua 스크립트 예제를 작성해 주세요. [followup_answer] | 제공된 참고 문서에는 정적 룸과 인스턴스 룸이 혼재된 구조에서의 구체적인 통신 방법, `RoomService` 또는 `WorldInstanceService`의 실제 메서드(예: 이벤트 전송, 수신, 데이터 동기화 관련 API)가 포함되어 있지 않습니다. 문서에는 "월드 인스턴스끼리의 통신이 필요하거나 이벤트 전달이 필요하다면 RoomService와 WorldInstanceService를 활용해야 합니다"라고만 명시되어 있을 뿐, 이를 구현하기 위한 구체적인 mLua 코드나 API 사용법이 제시되어 있지 않습니다. 따라서 제공된 [scores] | [judge_reason] | [source_doc] | # 학습 과정 안내 월드 인스턴스 개념과 생성, 파괴에 관해 알아봅시다. 월드 인스턴스를 이해하기 위해 [인스턴스 맵 만들기](/docs/?postId=540)의 룸 관련 내용을 먼저 학습하면 도움이 됩니다. # 월드 인스턴스 월드 인스턴스란 크리에이터가 메이커에서 제작한 월드의 정보를 기반으로 생성한 실제 객체입니다. 월드 인스턴스는 독립적으로 실행되며, 크리에이터의 제작 방식에 따라 정적 룸과 인스턴스룸이 구성됩니다. >**TIP.** > 제작한 월드의 모든 월드 인스턴스는 하나의 DataStorage를 사용합니다. #
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 월드 인스턴스에서 공유 변수를 삭제했을 때 다른 인스턴스에 미치는 영향과 이를 방지하는 권장 방식은 무엇인가요? [answer] | 월드 인스턴스에서 공유 변수를 삭제하면 다른 월드 인스턴스에도 영향을 미칩니다. 월드 인스턴스가 공유 변수를 생성, 조회, 수정하는等操作을 수행하면 해당 변수를 참조하는 상태가 됩니다. 이 참조 상태는 공유 변수가 삭제될 때까지 유지되므로, 한 월드 인스턴스에서 공유 변수를 삭제하면 다른 월드 인스턴스에서도 해당 공유 변수를 사용할 수 없게 됩니다. 이러한 문제를 방지하기 위해 공유 변수를 즉시 삭제하는 대신 **참조를 해제하는 방식**을 권장합니다. 모든 월드 인스턴스에서 공유 변수에 대한 참조를 해제하면 해당 공유 변수가 자동 [followup] | ReleaseVariableAndWait 와 ReleaseSharedMemoryAndWait 로 참조를 해제하는 구체적인 코드 예시는 어떻게 작성하나요? [followup_answer] | `ReleaseVariableAndWait`와 `ReleaseSharedMemoryAndWait`를 사용하여 참조를 해제하는 구체적인 코드 예시는 다음과 같습니다. 먼저 `_WorldInstanceService:GetSharedMemory`로 메모리 객체를 가져온 후, 특정 변수나 전체 메모리의 참조를 해제합니다. ```lua -- WorldInstanceSharedMemory를 얻어옵니다. local getMemResultCode, mem = _WorldInstanceService:GetSharedMemory("MemoryNa [scores] | [judge_reason] | [source_doc] | 월드 인스턴스가 공유 변수를 생성, 조회, 수정을 하면 해당 공유 변수를 참조한 상태가 됩니다. 한 번 특정 공유 변수를 참조한 월드 인스턴스는 공유 변수가 삭제될 때까지 계속 참조 상태를 유지합니다. 만약 어떤 공유 변수를 여러 월드 인스턴스에서 참조하고 있을 때 특정 월드 인스턴스에서 해당 공유 변수를 삭제해버리면 다른 월드 인스턴스에서 공유 변수를 사용할 수 없게 됩니다. 이처럼 한 곳에서 데이터를 삭제했지만 전체 월드 인스턴스에게 영향을 주는 사고를 방지하기 위해 메이플스토리 월드는 WorldInstanceSharedMemo
[task] | single_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | WorldInstanceSharedMemory의 휘발성이 무엇인지, 그리고 모든 월드 인스턴스가 종료되었을 때 공유 변수에 어떤 일이 일어나는지 궁금합니다. [answer] | WorldInstanceSharedMemory의 **휘발성**은 해당 메모리가 영구적으로 존재하지 않는다는 것을 의미합니다. 구체적으로, WorldInstanceSharedMemory를 참조하고 있는 월드 인스턴스가 하나도 없게 되면 해당 WorldInstanceSharedMemory 자체가 사라집니다. 모든 월드 인스턴스가 종료되었을 때, 해당 WorldInstanceSharedMemory에 남아 있던 **공유 변수들은 모두 함께 삭제**됩니다. 즉, 인스턴스가 없으면 공유 데이터도 유지되지 않으며, 새로운 월드 인스턴스가 시작 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `WorldInstanceService`와 `WorldInstanceSharedMemory`를 활용해 월드 인스턴스끼리 데이터를 공유하고 이벤트를 보내는 방법에 대해 알아봅시다. 월드 인스턴스와 룸 개념은 [월드 인스턴스](/docs?postId=984), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 참고하세요. >**Tip.** > 룸끼리의 통신을 구현하고 싶다면 `RoomService`의 동일한 함수명을 사용해보세요. # WorldInstanceSharedMemory 월드 인스턴스
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | UI 가리고 영상 녹화하기 가이드의 단계 1부터 6까지를 실행 순서대로 표로 정리하되, '단계', '대상(에디터/컴포넌트)', '주요 작업/설정값' 3열로 구성하세요. [answer] | UI 가리고 영상 녹화하기 가이드의 실행 순서와 세부 설정은 다음과 같습니다. | 단계 | 대상(에디터/컴포넌트) | 주요 작업/설정값 | | :--- | :--- | :--- | | 1 | UI 에디터 / DefaultGroup (UIText) | **UIText** 추가 및 프로퍼티 설정:<br>- **RectSize**: X=700, Y=100<br>- **Text**: ScreenRecordService TEST<br>- **FontSize**: 50<br>- **ImageRUID**: b9ab8455d5737bf4cb21 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # UI 가리고 영상 녹화하기 UI를 가리고 영상을 녹화하는 방법을 살펴봅시다. 1. UI 에디터로 들어가서 **DefaultGroup**에 **UIText**를 하나 추가하고 프로퍼티를 아래와 같이 설정합니다. | 프로퍼티 | 값 | | --- | --- | | RectSize | X = 700, Y = 100 | | Text | ScreenRecordService TEST | | FontSize | 50 | | ImageRUID | b9ab8455d5737bf4cb21433
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | _UIScreenRecordService:StartRecordToFileAndWait와 _UIPopup, _UIToast를 이용해 녹화 시작 전 확인을 받고 DefaultGroup의 Visible을 false로 변경한 뒤 녹화가 종료되면 Visible을 true로 복원하는 스크립트를 작성해줘 [answer] | ```lua Property: [None] EntityRef DefaultGroup = /ui/DefaultGroup string LastRecordedPath = "" Method: void Record() { _UIPopup:Open("Do you want to start recording?", function() self.DefaultGroup.Visible = false local result = _ScreenRecordService:StartRecordToFileAndWait(Scree [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # UI 가리고 영상 녹화하기 UI를 가리고 영상을 녹화하는 방법을 살펴봅시다. 1. UI 에디터로 들어가서 **DefaultGroup**에 **UIText**를 하나 추가하고 프로퍼티를 아래와 같이 설정합니다. | 프로퍼티 | 값 | | --- | --- | | RectSize | X = 700, Y = 100 | | Text | ScreenRecordService TEST | | FontSize | 50 | | ImageRUID | b9ab8455d5737bf4cb21433
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | iOS 환경에서 녹화 후 공유가 안 될 때, 설정 메뉴의 '사진만 추가' 권한과 Android 10 미만 기기의 '저장 공간' 권한은 각각 어떤 역할을 하나요? [answer] | iOS 환경에서 녹화 후 공유가 안 될 때, 두 권한의 역할은 다음과 같습니다. **1. iOS: 설정 > MapleStoryWorlds > 사진 > "사진만 추가" 권한** * **역할:** 이 권한이 허용되어 있지 않으면 **녹화 자체를 진행할 수 없습니다.** * 즉, 녹화 파일이 생성되지 않아 이후 공유(`Share`) 버튼 동작 시 실패하거나 반응이 없을 수 있습니다. 녹화 기능을 정상적으로 사용하려면 해당 권한을 반드시 활성화해야 합니다. **2. Android 10 미만(AOS): 애플리케이션 정보 > Map [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `MobileShareService`를 사용하면 녹화한 영상을 모바일에서 공유할 수 있습니다. 공유할 영상은 `StartRecordToFileAndWait()` 함수를 사용해 녹화해야 합니다. 단, 녹화 시간은 최대 2분으로 제한됩니다. 예제를 통해 모바일에서 녹화 영상을 공유하는 방법을 살펴봅시다. 1. **Btn_Record** 버튼의 콘텍스트 메뉴에서 **Duplicate** 버튼을 눌러 버튼을 복제합니다. 2. 복제한 버튼의 이름을 **Btn_Share**으로 변경하고, **Text**에는 **Share**을
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 공유 변수 수정 시 ETag 불일치로 인한 실패를 처리하는 코드만 출력하고, 오류 처리 로직은 주석으로만 설명하세요. [answer] | ```lua local code, mem = _WorldInstanceService:GetSharedMemory("MemoryName") local current = mem:GetVariableAndWait("varname") local keyInfo = SharedVariableKeyInfo(current.Info.Name, current.Info.ETag) local updated = mem:UpdateVariableAndWait(keyInfo, "new value") if updated.Code == SharedMemoryR [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **ETag**는 공유 변수의 데이터가 최신 상태인지 확인하기 위해 필요합니다. ETag는 식별자입니다. 데이터를 생성 또는 수정하거나, 기록을 조회할 때마다 새로운 ETag를 발급합니다. 발급한 ETag는 데이터의 버전을 기록하고, 비교하는데 사용합니다. ETag를 사용하는 이유는 여러 월드 인스턴스에서 하나의 공유 변수를 사용하면 어떤 데이터가 최신 데이터인지, 수정되었는지 알기 어렵기 때문입니다. 또한 여러 월드 인스턴스에서 공유 변수에 접근하므로 예기치 못하게 데이터를 덮어 쓸 수 있기 때문입니다. 공유 변수와 ETag는
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | ETag를 사용하여 공유 변수를 조회하고 수정하는 과정의 핵심 API 호출 순서만 3문장 이내로 요약하세요. [answer] | `_WorldInstanceService:GetSharedMemory`로 메모리를 얻은 뒤 `mem:GetVariableAndWait`를 호출해 변수 값과 최신 ETag를 포함하는 정보(`current.Info.ETag`)를 조회합니다. 조회한 ETag를 `SharedVariableKeyInfo`에 담아 `mem:UpdateVariableAndWait`를 호출하여 공유 변수를 수정합니다. 수정 성공 시 반환되는 `updated` 객체의 `Info.ETag`에서 새롭게 발급된 최신 ETag를 확인합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **ETag**는 공유 변수의 데이터가 최신 상태인지 확인하기 위해 필요합니다. ETag는 식별자입니다. 데이터를 생성 또는 수정하거나, 기록을 조회할 때마다 새로운 ETag를 발급합니다. 발급한 ETag는 데이터의 버전을 기록하고, 비교하는데 사용합니다. ETag를 사용하는 이유는 여러 월드 인스턴스에서 하나의 공유 변수를 사용하면 어떤 데이터가 최신 데이터인지, 수정되었는지 알기 어렵기 때문입니다. 또한 여러 월드 인스턴스에서 공유 변수에 접근하므로 예기치 못하게 데이터를 덮어 쓸 수 있기 때문입니다. 공유 변수와 ETag는
[task] | code [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | LastRecordedPath 프로퍼티를 관리하며, _ScreenRecordService:StartRecordToFileAndWait() 호출 후 성공 시 해당 경로를 저장하고 _UIToast로 "Start recording"을 출력하는 스크립트를 작성해줘. [answer] | 사용자가 요청한 `LastRecordedPath` 프로퍼티 관리와 `_ScreenRecordService:StartRecordToFileAndWait()` 호출 후 성공 시 경로 저장 및 토스트 메시지 출력 로직을 구현한 스크립트입니다. 참고 문서의 예제 코드(`Record()` 함수)를 기반으로, 성공 시 `result` 값에서 저장된 경로를 추출하여 `LastRecordedPath`에 저장하도록 보완했습니다. 다만, 제공된 참고 문서에는 `StartRecordToFileAndWait()`의 반환값(`result`)이 성공 시 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `ScreenRecordService`를 활용하여 영상을 녹화하는 예제를 살펴봅시다. **[Record]** 버튼을 누르면 녹화를 시작하고, **[Stop]** 버튼을 누르면 녹화를 종료하고 파일을 저장하겠습니다. 1. UI 에디터로 들어가서 **RecordGroup**이란 이름으로 새로운 UIGroup을 추가합니다. 그리고 **RecordGroup**의 **DefaultShow**를 **true**로 설정합니다. 2. 버튼을 하나 추가한 뒤 이름을 **Btn_Record**로 변경합
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 공유 변수를 생성, 조회, 수정, 삭제하는 `WorldInstanceSharedMemory`의 전체 생명주기 코드 예제를 작성해 주세요. [answer] | `WorldInstanceSharedMemory`를 통한 공유 변수의 생성, 조회, 수정, 삭제까지의 전체 생명주기 코드는 다음과 같습니다. ```lua -- 1. WorldInstanceSharedMemory 인스턴스를 획득합니다. local getMemResultCode, mem = _WorldInstanceService:GetSharedMemory("MemoryName") -- 2. 공유 변수 'var1'을 값 'value1'로 생성합니다. local createVarResult = mem:CreateVariableAndW [followup] | `CreateVariableAndWait`와 `UpdateVariableAndWait` 호출 시 반환되는 `ResultCode`나 `Info` 구조를 확인하여 에러 처리를 하는 로직을 어떻게 구현해야 하나요? [followup_answer] | 제공된 참고 문서에는 `CreateVariableAndWait`와 `UpdateVariableAndWait` 호출 시 반환되는 결과 객체에서 `Info` 속성을 통해 변수의 `Name`, `Value`, `ETag`를 조회하는 방법과, `UpdateVariableAndWait` 실패 시 `Code` 속성이 `SharedMemoryResultCode.PreconditionFailed`로 반환될 수 있다는 정보만 포함되어 있습니다. 문서에 명시된 내용만을 근거로 한다면, 에러 처리 로직은 다음과 같이 구현할 수 있습니다. 1. * [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `WorldInstanceService`와 `WorldInstanceSharedMemory`를 활용해 월드 인스턴스끼리 데이터를 공유하고 이벤트를 보내는 방법에 대해 알아봅시다. 월드 인스턴스와 룸 개념은 [월드 인스턴스](/docs?postId=984), [인스턴스 맵 만들기](/docs/?postId=540) 가이드를 참고하세요. >**Tip.** > 룸끼리의 통신을 구현하고 싶다면 `RoomService`의 동일한 함수명을 사용해보세요. # WorldInstanceSharedMemory 월드 인스턴스
[task] | two_turn [pass] | ⏳ 미판정 [title] | 월드 인스턴스 통신 [question] | 여러 개의 공유 변수를 동시에 생성할 때 효율적으로 처리하기 위한 Batch 접두사 함수의 사용법은 어떻게 되나요? [answer] | 여러 개의 공유 변수를 동시에 생성할 때 `Batch` 접두사가 붙은 함수를 사용하면 효율적으로 처리할 수 있습니다. 구체적으로는 `BatchCreateVariableAndWait` 함수를 사용하며, 생성할 변수 이름과 값을 테이블 형태로 전달합니다. 아래는 `WorldInstanceSharedMemory`에서 `var1`, `var2`, `var3`을 일괄 생성하는 예시입니다. ```lua -- WorldInstanceSharedMemory를 얻어옵니다. local code, mem = _WorldInstanceService: [followup] | BatchCreateVariableAndWait 를 사용하여 테이블 형태의 nameValues 로 변수를 일괄 생성하고 결과를 조회하는 코드를 작성해 주세요. [followup_answer] | `BatchCreateVariableAndWait` 함수를 사용하여 테이블 형태의 `nameValues`로 공유 변수를 일괄 생성하고 결과를 조회하는 코드는 다음과 같습니다. ```lua -- WorldInstanceSharedMemory를 얻어옵니다. local code, mem = _WorldInstanceService:GetSharedMemory("MemoryName") -- 생성할 변수 이름과 값의 매핑 테이블을 정의합니다. local nameValues = { ["b_var1"] = "b_value1", [scores] | [judge_reason] | [source_doc] | 월드 인스턴스가 공유 변수를 생성, 조회, 수정을 하면 해당 공유 변수를 참조한 상태가 됩니다. 한 번 특정 공유 변수를 참조한 월드 인스턴스는 공유 변수가 삭제될 때까지 계속 참조 상태를 유지합니다. 만약 어떤 공유 변수를 여러 월드 인스턴스에서 참조하고 있을 때 특정 월드 인스턴스에서 해당 공유 변수를 삭제해버리면 다른 월드 인스턴스에서 공유 변수를 사용할 수 없게 됩니다. 이처럼 한 곳에서 데이터를 삭제했지만 전체 월드 인스턴스에게 영향을 주는 사고를 방지하기 위해 메이플스토리 월드는 WorldInstanceSharedMemo
[task] | single_turn [pass] | ⏳ 미판정 [title] | 플레이 화면 녹화 및 공유하기 [question] | 공유 성공 여부에 따라 _UIToast:ShowMessage로 다른 메시지를 표시하는 ShareVideo() 함수에서, LastRecordedPath가 빈 문자열일 경우 함수가 아무 동작도 하지 않는 이유는 무엇인가요? [answer] | `ShareVideo()` 함수에서 `LastRecordedPath`가 빈 문자열(`""`)일 경우 아무 동작도 하지 않는 이유는, 함수의 첫 줄에 해당 경로가 비어 있는지 확인하는 조건문(`if self.LastRecordedPath ~= "" then`)이 존재하기 때문입니다. 이 조건은 `LastRecordedPath`가 **비어 있지 않을 때만**(`~= ""`) `_MobileShareService:ShareFileAndWait()`를 호출하고 공유 성공 여부에 따라 `_UIToast:ShowMessage()`로 메시지를 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `MobileShareService`를 사용하면 녹화한 영상을 모바일에서 공유할 수 있습니다. 공유할 영상은 `StartRecordToFileAndWait()` 함수를 사용해 녹화해야 합니다. 단, 녹화 시간은 최대 2분으로 제한됩니다. 예제를 통해 모바일에서 녹화 영상을 공유하는 방법을 살펴봅시다. 1. **Btn_Record** 버튼의 콘텍스트 메뉴에서 **Duplicate** 버튼을 눌러 버튼을 복제합니다. 2. 복제한 버튼의 이름을 **Btn_Share**으로 변경하고, **Text**에는 **Share**을