Daily DevLog — 2025-12-03
개발자: 전체 팀 브랜치: main 커밋 수: 18개 변경 파일: 59개
1. 오늘의 주요 변경
OCR 이미지 추출 및 응답 처리 기능 추가: 설문 제출 시 저장된 질문별 이미지 파일을 서버에 전송하여 OCR 추출 요청을 수행하는 기능을 도입했습니다. 이를 통해 사용자가 작성한 손글씨 이미지를 서버로 전송해 텍스트를 받아올 수 있도록 개선했습니다.
스피크 스테이지 시스템 및 UI 위젯 추가: 스피크 스테이지와 NPC 심사관을 관리하는 서브시스템을 구현하여 대화 진행 상황을 관리하고, UI 위젯에서 현재 발화자, 질문, 진행률 등을 실시간으로 보여줄 수 있도록 연동했습니다. 이는 사용자 경험을 향상시키는 데 기여합니다.
SpeakWidget 표시 로직 개선: SpeakStageSubsystem이나 SpeakStage가 없을 때 SpeakWidget이 계속 표시되는 문제를 해결했습니다. 조건에 맞지 않으면 SpeakWidget을 숨기도록 처리하여 UI 상태를 명확하게 관리했습니다.
입국 심사 질문 음성 및 토스트 UI 추가: 입국 심사 단계에서 각 질문에 대응하는 음성 효과와 토스트 메시지를 표시하도록 기능을 확장했습니다. 이를 통해 플레이어가 현재 진행 중인 질문을 직관적으로 확인할 수 있도록 하였습니다.
퀘스트 타입별 멀티플레이 리스폰 트리거 추가: 플레이어를 퀘스트별 리스폰 지점으로 이동시키는 ARespawnTrigger 액터를 구현하여 네트워크 동기화 처리 및 충돌 기반 트리거 감지 기능을 추가했습니다.
2. 시스템 영향도
Content 시스템: 새로운 오디오 파일 및 UI 위젯이 추가되어 사용자 인터페이스와 상호작용 방식이 개선되었습니다. 특히 스피크 스테이지와 관련된 UI가 동적으로 업데이트되므로 사용자 경험이 향상됩니다.
Network 시스템: OCR 기능과 관련된 네트워크 요청 및 응답 처리 로직이 수정되어 서버와의 데이터 통신이 원활해졌습니다. 이는 전체 시스템의 안정성을 높이는 데 기여합니다.
Gameplay 시스템: 퀘스트 리스폰 트리거 추가로 인해 게임 플레이의 흐름이 개선되며, 플레이어의 리스폰 위치가 퀘스트에 따라 달라지므로 게임의 몰입감이 향상됩니다.
3. 리스크 및 문제
잠재적 리스크: OCR 기능의 서버 연동 방식에 대한 점검이 필요하며, 질문·단어 묶음 전송과 단일 전송 방식의 비교가 요구됩니다. 이로 인해 성능 저하나 데이터 손실이 발생할 수 있는 리스크가 존재합니다.
기술적 부채: SpeakWidget의 표시 로직 개선 과정에서 발생할 수 있는 UI 상태 관리의 복잡성으로 인해 추가적인 테스트가 필요합니다.
4. 검증 필요 항목
OCR 기능 검증: OCR 이미지 추출 및 응답 처리 기능이 정상적으로 작동하는지 확인해야 합니다. 특히 다양한 손글씨 스타일에 대한 인식률을 테스트해야 합니다.
UI 위젯 테스트: SpeakWidget의 동적 업데이트가 정상적으로 이루어지는지, 다양한 상황에서 UI가 올바르게 표시되는지 검증해야 합니다.
멀티플레이 리스폰 트리거: 퀘스트 타입별 리스폰 트리거가 정상적으로 작동하는지, 플레이어가 올바른 위치로 이동하는지 테스트해야 합니다.
5. 회의 기반 후속 작업
리슨 오디오 및 오디오 캐싱 매니저 구현: 회의에서 논의된 리슨 오디오와 오디오 캐싱 매니저의 구현이 완료되어 서버 토큰 소모 문제를 해결했습니다. 이는 향후 성능 개선에 기여할 것입니다.
최종 평가 화면 템플릿: 최종 평가 화면의 템플릿이 미정인 상태로, 1차 버전은 스크롤 텍스트 기반 임시 출력으로 진행하기로 했습니다. 이와 관련된 작업이 필요합니다.
6. 관련 Jira 이슈
- [UN-501] OCR API - OCR 기능 추가와 관련된 작업으로, 오늘의 커밋에서 OCR 이미지 추출 및 응답 처리 기능이 구현되었습니다.
- [UN-465] 녹음 가이드(문장을 먼저 듣고 말하세요) - UI 위젯 개선과 관련하여 사용자 경험을 향상시키는 데 기여할 수 있습니다.
- [UN-466] 음량(dB) 게이지 표시 - UI 개선 작업과 연관되어 있으며, SpeakWidget의 표시 로직 개선과 관련된 작업입니다.
생성 시간: 2025-12-08 09:03:20