diff --git a/docs/dev/test-results.md b/docs/dev/test-results.md index 9720b8f..fac5e0a 100644 --- a/docs/dev/test-results.md +++ b/docs/dev/test-results.md @@ -221,3 +221,4 @@ VOICE E2E PASS 8. TTS 속도 바꾸기가 중간에 죽으면 반쪽 파일이 계속 쓰임 → 다 만든 뒤 이름 바꾸기 - 그 밖: 브라우저 오류 로그에 검색어가 남던 것, 경기 끝 직후 늦게 끝난 실시간 변환의 잡음 파일을 정밀 확인 전에 지우던 것, 많이 골랐을 때 내려받기 주소가 너무 길던 것(본문으로 보냄), zip 풀기 메모리 한도 600MB, 날짜 묶음이 "10월"로만 나오던 것(경기 · 기록 목록) - 테스트: 앱 53 · 사이트 서버 16 · 워커 42 통과, 타입 검사 통과 +- 배포: 사이트 서버 다시 배포 (`/api/%62undles/delete` 로그인 없이 401), Windows CI (5d494eb, full) 7개 모두 PASS · 앱 버전 1.3.7 → Gitea 릴리스 v1.3.7 (v1.3.6 에 새 버전 안내) · 보고서 `docs/gemnoki-v1.3.7-report.pdf` diff --git a/docs/gemnoki-v1.3.7-report.pdf b/docs/gemnoki-v1.3.7-report.pdf new file mode 100644 index 0000000..e7bea11 Binary files /dev/null and b/docs/gemnoki-v1.3.7-report.pdf differ diff --git a/docs/report/v137/report.html b/docs/report/v137/report.html new file mode 100644 index 0000000..7c89ff2 --- /dev/null +++ b/docs/report/v137/report.html @@ -0,0 +1,296 @@ + +겜녹이 v1.3.6 · v1.3.7 수정 보고서 + + + + +
+
+

겜녹이 수정 보고서

+
v1.3.6 · v1.3.7 — 목소리 깨짐 분석, 요청 사항 반영, 오류 점검
+ + + + + + +
작성일2026-10-16
대상 버전게임 PC 앱 v1.3.7 (v1.3.6 포함) · 사이트 gvr.tkrmagid.kr
릴리스git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.3.7
분석 자료사용자가 보낸 GVR-Data (발화 40개 · 데스매치 1경기 · exe 로그) · 사이트 화면 캡처 2장
확인앱 테스트 53 · 사이트 서버 16 · 음성 인식 워커 42 통과, Windows 빌드 검사 7개 통과
+
+
Game Voice Recorder · 겜녹이
+
+ +
+

1요약

+ + + + + + + + + + + + + + +
요청 · 문제결과한 줄 설명
목소리가 깨져서 저장됨고침녹음기가 패킷 도착 간격으로 쉼을 채워, 게임 중 몰려 온 패킷 사이에 20ms 무음이 계속 끼었다. 디스코드 RTP 시각 기준으로 바꾸고 예전 녹음도 고친다
말한 사람 "알 수 없음"고침앱이 유저 목록 갱신을 빈 목록으로 보내 사이트 목록이 비었다
잡음만 있으면 표시하지 않기 · ogg 삭제 · 로그에 잡음완료사이트에 안 보이고 파일도 지운다. 로그에 "잡음 발화 … 숨김 · 음성 파일 삭제 (이유, 인식 문장)"
켜는 중 작은 창완료포터블 exe 를 푸는 동안 그림 창, 앱이 켜지는 동안 "켜는 중" 창
녹음 안내 TTS 속도 0.1~2.0완료디스코드 탭 "말 속도". 0.5배보다 느린 부분은 음성 인식 엔진이 늘린다
사이트 재생 음량완료플레이어 막대 0~200%, 음소거
사이트 로그 (게임 PC 꺼져도)완료gvr.tkrmagid.kr/logs (관리자), 날짜별 보기 · 내려받기, 14일 보관
우클릭 → 자세한 정보 · 다운로드완료원본 ogg 이름 · 게임 PC 경로 · 크기 · 인식 정보, ogg 다운로드
지금 게임 자세한 정보 (앱 · 사이트)완료상태 · 모드 · 맵 · 라운드 · 점수 · 내 요원/챔피언 · KDA · 게임 시간
경기별 묶어 관리 · 경기 전후 대화 묶음완료사이트 "기록" 탭. 한 번에 지우기 · zip 내려받기 · zip 받아오기(빠진 내용이 있으면 실패)
분석 중 찾은 문제고침데스매치 가짜 라운드 · 에이스, 빈 선수 이름("주인 계정 자동 연결: #")
전체 코드 검토로 찾은 오류 8개 + 5개고침관리자 확인 우회, 큰 zip 전송 중 연결 끊김, 진행 중 경기 지우기 등 (6장)
+
+ +
+

2목소리 깨짐 분석

+

보내 주신 파일에서 본 것

+

ogg 파일을 패킷(20ms) 단위로 열어 보니, 게임 중 파일은 거의 모두 "목소리 2개 → 무음 1개"가 되풀이되었다. 아래는 "S매치 되는지 한번 해봐야겠다…" 발화의 앞 200개 패킷이다.

+
목소리 패킷 녹음기가 끼워 넣은 무음 (가운데 긴 빨간 부분은 실제로 말을 쉰 곳)
+ + + + + + +
파일파일 길이끼운 무음고친 뒤
"S매치 되는지 한번 해봐야겠다…" (경기 전)8.48초132개 (2.64초)7.32초
"…게임을 좀 해봐오면…" (경기 중)6.40초117개5.02초
"…홈 워치카라드 런던 키위드" (경기 중)4.64초69개3.54초
"운동을 싫어하면 별로 안 맞네" (경기 중)6.50초143개5.38초
+

원인

+

디스코드는 말하는 동안 20ms 마다 패킷을 보낸다. 녹음기는 "앞 패킷이 도착한 뒤 흐른 시간"으로 빈 자리를 무음으로 채웠다. 그런데 게임 중에는 PC 부하로 패킷이 2~3개씩 몰려 도착한다. 녹음기는 몰려 오기 전의 기다림을 쉼으로 보고 무음을 넣었다. 그래서 말 사이사이에 20ms 구멍이 계속 생겼고 소리가 늘어났다. 실제 수신 시간은 약 7.0초인데 파일은 8.5초였다.

+
같은 발화 앞 1.6초 (음량 키움). 위: 저장된 파일 (끊김), 아래: 끼운 무음을 뺀 것
+

고친 방법

+ +

인식 결과 비교 (같은 Whisper large-v3 로 다시 인식)

+ + + + + +
저장된 파일 (깨짐)끼운 무음을 뺀 파일
이제 게임을 좀 해봐봐 스태스트랜 맛있긴 하네실제로 게임을 좀 해봐오면서 테스트를 했는데 맛있긴 하네
왜는 리플레이가 귀하다이거는 리플레이가 없긴 하다
이거 시험은 별로 안 맞네이만큼만 시도하면 별로 안 맞네
+
+ +
+

3말한 사람 "알 수 없음" · 잡음

+

"알 수 없음"

+

녹음 기록에는 말한 사람(사금향)이 제대로 저장되어 있었다. 녹음 시작, 경기 끝, Riot ID 저장 때 앱이 사이트에 "유저 목록이 바뀌었음"을 보낸다. 이때 목록을 빈 목록으로 보냈고, 사이트는 그 빈 목록으로 유저 목록을 덮어썼다. 그래서 새로 고침 전까지 모든 발화가 "알 수 없음"으로 나왔다. 이제 실제 목록을 보낸다. 사이트도 빈 목록을 받으면 목록을 다시 받아 온다.

+

잡음

+ +

데스매치 · 선수 이름 (분석 중 찾은 문제)

+ +
+ +
+

4기록 관리 (경기별 묶음 · zip)

+

사이트 상단 기록 탭에서 녹음을 묶음 단위로 보고 관리한다.

+ +
받아오기 실패 조건 (하나라도 해당하면 아무것도 넣지 않음) +zip 이 아님 · 손상 · 암호 · manifest.json 없음 · 겜녹이 형식(gvr-bundle)이 아님 · 모르는 형식 버전 · data.json 없음 · 발화 · 유저 목록 없음 · 발화 ID 잘못됨 · 중복 · 말한 사람이 유저 목록에 없음 · 시각 잘못됨 · 경기 묶음인데 경기 기록 없음 · 이벤트의 경기 없음 · 음성 파일이 zip 에 없음 · ogg 가 아님 · manifest 의 발화 수와 다름 · 300MB 초과
+
기록 탭: 날짜별 묶음, 묶음마다 기록 보기 · zip · 지우기, 날짜 전체 선택
+
+
골라서 한 번에 지우기 확인 창
+
필요한 내용이 없는 zip → "받아오기 실패: (이유)"
+
+
+ +
+

5그 밖의 요청

+
+
켜는 중 창 (포터블 exe 는 압축을 푸는 동안 같은 그림 창)
+
디스코드 탭 "말 속도" 0.1~2.0배
+
+
발화 우클릭 메뉴 · 플레이어 막대 재생 음량(오른쪽 아래) · 머리글 지금 게임 · 오른쪽 게임 상태
+
+
자세한 정보: 원본 ogg 이름 · 게임 PC 경로(복사) · 크기 · 인식 정보 · 원본 다운로드
+
사이트 로그 (/logs): 게임 PC 연결 · 끊김, 요청 결과, 봇, 화면 오류. 전체 · 경고 이상 · 오류만, 찾기, 내려받기
+
+
앱 게임 연동 탭 "지금 게임"
+

사이트 로그에는 게임 PC 연결 · 끊김(이유), 정보(버전 · 서버), 기록 요청(주소 · 결과 · 걸린 시간 · 누가), 응답 없는 요청, 겜녹이 봇 중계, 범인찾기, 브라우저 화면 오류가 남는다. 로그인 code · 검색어 같은 쿼리 값은 남기지 않는다. 문제가 생기면 이 로그와 게임 PC 의 GVR-Data\logs\gvr-날짜.log 를 같이 보내면 된다.

+
+ +
+

6오류 점검 (전체 코드 검토)

+

v1.3.6 · v1.3.7 에서 바뀐 코드 약 3,600줄을 다시 검토했다. 실제 오류 8개와 작은 문제 5개를 찾아 모두 고쳤고, 고친 내용마다 테스트를 넣었다.

+ + + + + + + + + + + +
#문제어떻게 생기나고친 것
1기록 지우기 관리자 확인 우회주소를 /api/%62undles/delete 처럼 %인코딩하면 사이트 서버의 확인을 건너뛰고 게임 PC 가 지웠다주소를 풀어서 확인하고, 게임 PC 도 사이트가 붙인 역할로 한 번 더 확인한다. 우회 주소 4가지가 403 인 것을 테스트로 확인했다
2큰 zip 을 주고받을 때 연결이 끊김조각이 쌓여 확인 신호(pong)가 20초 넘게 밀리면 앱이 사이트 연결을 스스로 끊었다무엇이든 받으면 연결이 살아 있는 것으로 본다. 보낼 것이 4MB 넘게 쌓이면 기다린다. 20MB zip 이 오가는 것을 테스트로 확인했다
3진행 중인 경기 지우기경기가 끝날 때 할 일(정밀 변환 · 경기 상세)이 경기를 못 찾아 멈췄다진행 중인 경기는 지울 수 없게 했다 (화면에 "● 진행 중" 표시)
4다시 넣을 수 없는 zip내보내기에는 한도가 없고 받아오기는 300MB 까지라, "먼저 zip 받기" 뒤에 지우면 되살리지 못할 수 있었다음성이 280MB 를 넘으면 나눠 받으라고 안내한다
5예전 녹음 고치기가 결과를 나쁘게 덮음정밀 모델 결과를 실시간 모델 결과로 덮었다. 잡음으로 나오면 파일을 지웠다. 켤 때 한꺼번에 처리했다정밀 모델로만 다시 변환하고, 잡음이면 원래 결과를 둔다. 20개씩 처리하고, 중간에 꺼져도 이어서 한다
6타임라인 순서최신순 목록에서 오래된 발화가 고쳐지면 맨 아래에 붙었다. "더 보기"를 누르면 같은 발화가 두 번 나왔다더 불러올 페이지가 남아 있으면 넣지 않는다
7반복 줄이기가 숫자를 망가뜨림"1000원 줘 줘 줘" → "10원 줘", "www" → "w"숫자와 붙은 한 글자 반복은 그대로 둔다
8TTS 속도 파일이 반쪽으로 남음변환 중 엔진이 죽으면 반쪽 파일이 계속 안내 음성으로 쓰였다다 만든 뒤에만 파일 이름을 바꾼다
+작은 문제 5개브라우저 오류 로그에 검색어가 남던 것 · 경기 끝 직후 늦게 끝난 실시간 변환의 잡음 파일을 정밀 확인 전에 지우던 것 · 많이 골랐을 때 내려받기 주소가 너무 길던 것 · zip 풀기 메모리 한도(600MB) · 경기 · 기록 목록의 날짜가 "10월"로만 묶이던 것
+

확인

+ + + + + + + + +
항목결과
앱 테스트53개 통과 (녹음기 RTP · 예전 녹음 고치기 · 유저 목록 · 잡음 · TTS 속도 · 지금 게임 · 데스매치 · 기록 묶음 5개 · 실제 음성 인식 엔진 E2E)
사이트 서버 테스트16개 통과 (사이트 로그 · 큰 zip 중계 · 관리자 확인 우회 차단 포함)
음성 인식 워커 테스트42개 통과 (잡음 규칙 · 반복 줄이기 · TTS 속도)
화면사이트 · 앱 화면을 띄워 확인, 화면 오류 없음
Windows 빌드 검사7개 통과 (워커 테스트 · STT · 워커 exe · 앱 빌드 · 앱 실행)
사용자 데이터 사본예전 녹음 43개 고치기 (끼운 무음 489개 제거), 기록 묶음 3개 → zip 1.0MB
+
아직 실제로 확인하지 못한 것새 녹음 방식(RTP 기준)은 실제 디스코드 통화가 있는 Windows 게임 PC 에서 아직 돌려 보지 못했다. 테스트는 사용자 파일과 같은 도착 모양을 흉내 내서 했다. 한 판 해 보고 목소리가 깨끗한지 확인해 주세요.
+
+ \ No newline at end of file