Daily DevLog — 2025-12-13
개발자: 전체 팀 브랜치: main 커밋 수: 11개 변경 파일: 36개
1. 오늘의 주요 변경
다중 이미지 OCR 제출 기능 개선: 기존의 이미지별 텍스트를 하나로 묶어 보내는 구조에서 각 이미지에 대응하는 텍스트를 별도로 전송하도록 변경했습니다. 이로 인해 네트워크 요청 방식과 UI 처리 로직이 개선되어 데이터 흐름의 명확성과 확장성이 향상되었습니다.
AWheatly 위젯 표시 로직 개선: AWheatly 캐릭터의 발화자 상태에 따라 눈 색상과 위젯 표시 처리를 분리했습니다. 서버 권한과 클라이언트 로컬 플레이어 조건을 구분하여 처리함으로써 코드의 중복성을 줄이고 가독성을 높였습니다.
SpeakQuest 완료 상태 관리 추가: 플레이어의 SpeakQuest 완료 상태를 관리하고, 완료된 플레이어에 대해 중복 상호작용을 방지하는 로직을 추가했습니다. 이를 통해 사용자 경험을 개선하고 UI 혼란을 줄였습니다.
스피크 퀘스트 UI 및 음성 재생 기능 개선: 스피크 퀘스트 진행 중 UI 표시 로직과 음성 재생 기능을 개선하여 플레이어의 몰입감을 높였습니다. 첫 질문 시 메시지 박스를 통해 퀘스트 시작을 알리고, 질문 텍스트와 TTS 음성을 발화 차례에 맞춰 재생하도록 구현했습니다.
파일 경로 반환 방식 수정: WAV 파일 저장 후 반환하는 경로를 상대 경로에서 절대 경로로 변경하여, 경로 혼동을 방지하고 파일 위치를 명확히 알 수 있도록 했습니다.
2. 시스템 영향도
- Content: 11개의 파일이 변경되었으며, UI와 게임 모드 관련 파일들이 포함되어 있어 사용자 경험에 직접적인 영향을 미칩니다.
- Gameplay: AWheatly 캐릭터와 관련된 상호작용 로직이 개선되어, 게임 내 캐릭터의 행동 및 반응이 더 명확해졌습니다.
- Network: 클라이언트-서버 간의 통신 방식이 개선되어, 스피크 퀘스트 진행 중 데이터 전송의 효율성이 증가했습니다.
- UI: 질문 위젯과 스피크 퀘스트 UI가 개선되어 사용자에게 더 직관적인 정보를 제공하게 되었습니다.
- Voice: 음성 재생 기능이 개선되어, 사용자 경험이 향상되었습니다.
3. 리스크 및 문제
- 잠재적인 문제점: 다중 이미지 OCR 제출 기능 개선으로 인해 기존 시스템과의 호환성 문제가 발생할 수 있습니다. 특히, 이전 버전과의 데이터 처리 방식 차이로 인한 오류 가능성이 존재합니다.
- 기술적 부채: AWheatly 위젯 제어 로직의 중복 코드 제거가 완료되지 않았으며, 향후 코드 정리가 필요합니다.
4. 검증 필요 항목
- 다중 이미지 OCR 제출 기능: 새로운 데이터 흐름이 기존 시스템과 잘 통합되는지 검증해야 합니다.
- AWheatly 위젯 표시 로직: 다양한 발화자 상태에서 위젯이 올바르게 표시되는지 테스트해야 합니다.
- 스피크 퀘스트 UI 및 음성 재생: UI 업데이트와 TTS 음성이 올바르게 작동하는지 확인해야 합니다.
- 파일 경로 반환: WAV 파일의 절대 경로 반환이 정상적으로 이루어지는지 검증해야 합니다.
5. 회의 기반 후속 작업
- 회의록과 직접적인 연관 없음: 오늘의 작업은 회의록에서 논의된 내용과 직접적인 연관이 없습니다.
6. 관련 Jira 이슈
- [UN-615] SpeakResultDetail Widget 생성 - 스피크 퀘스트 UI 개선과 관련하여 새로운 위젯 생성이 필요합니다.
- [UN-618] SpeakResultSummary Widget 생성 - 스피크 퀘스트의 결과 요약을 위한 위젯 생성이 필요합니다.
- [UN-610] FSM 상태 플래그(Idle/Asking/Recording/Evaluating/Feedback/Next) 1차 구현 - 상태 관리 개선과 관련된 작업으로, 새로운 상태 플래그가 추가되었습니다.
- [UN-564] WriteQuest 서버 통신 구현 및 검증 - 서버 통신 방식 개선과 관련된 작업으로, 네트워크 요청 방식의 변경과 연관이 있습니다.
생성 시간: 2025-12-15 09:24:16