청각훈련 관리자 서버 사용 가이드

실험 준비부터 결과 확인과 문장 채점까지, 필요한 순서대로 확인하세요.

실험 전 1분 체크

아래 세 가지만 확인하면 실험을 시작할 수 있습니다.

1
서버 창 2개 실행녹음 서버와 관리 서버 창을 모두 켭니다.
2
패드 연결 확인Wi-Fi와 Tailscale 연결 상태를 확인합니다.
3
피험자 코드 확인관리자 화면에 등록된 코드로 앱을 시작합니다.

전체 실험 순서

DAY 1 · 사전 평가단어 평가 → 문장 듣기 평가→
DAY 2–5 · 본 훈련하루 4세션, 총 16세션→
DAY 6 · 사후 평가단어 평가 → 문장 듣기 평가

현재 테스트용 앱은 날짜 제한이 해제되어 있습니다. 실제 연구 시작 전에는 원래 일정 제한을 다시 적용해야 합니다.

1. 서버 실행
① 녹음 서버 · 8091문장 녹음 업로드와 재생 담당
start_recording_server_visible.cmd
② 관리·결과 서버 · 8089피험자, 결과, 그래프 표시
start_admin_server_visible.cmd
  1. 녹음 서버를 먼저 실행합니다.
  2. 관리·결과 서버를 실행합니다.
  3. 두 창을 닫지 않은 채 관리자 화면을 엽니다.

중요: 실험 중 서버 창을 닫으면 업로드와 관리자 화면이 중단됩니다.

2. 피험자 등록·삭제
  1. 상단의 피험자 코드에 S001 같은 코드를 입력하고 코드 추가를 누릅니다.
  2. 왼쪽 목록에서 피험자를 선택해 진행 상태와 결과를 확인합니다.
  3. 삭제 전 대상 코드를 다시 확인하고 피험자 전체 삭제를 사용합니다.

삭제 주의: 전체 삭제 시 훈련, 단어·문장 평가, 녹음이 모두 삭제됩니다. 같은 코드를 다시 만들어도 이전 데이터는 복원되지 않습니다.

3. 결과 화면 보는 법

① 피험자 선택왼쪽 목록에서 코드를 누른 뒤 훈련 세션 · 단어 평가 전·후 · 문장 듣기 평가 중 확인할 영역을 선택합니다.

본 훈련

훈련 세션 → 회차(1–16) 선택

세션 목록에서 확인

  • 완료·열림·잠김 상태와 방문·세트
  • 문제 정답률, SRT80, 획득 코인
  • 완료 시간과 세션 소요시간

선택한 세션의 상세 결과

  • SNR & Performance: 문항별 SNR, 다음 SNR, 정오답, 코인, 반응시간
  • Eye tracking: 방향·음원·문제·로켓 화면별 Heatmap, 시선점, 이동경로
  • Choice gaze time-course: 정답·반대 문장·유사 단어·기타 보기 응시 비율
  • Blink: 문항·화면별 깜박임 시점과 데이터 품질
  • rPPG: 평균 추정 심박, 고품질 비율, 최장 연속 구간, 심박 타임라인
Gaze CSV, Blink CSV와 선택지 분석 JSON/CSV를 내려받을 수 있습니다.

단어 평가

단어 평가 전·후 → 사전/사후 선택

사전·사후 비교

  • SRT-50, 전체 정답률, 주변 소음
  • SNR별 실제 정답률 점과 심리측정곡선
  • 60문항별 제시 SNR과 정오답 추이
  • UML 추정 과정과 문항별 변화

단어 선택 과정 분석

  • Eye tracking: 안내·음원·문제 화면별 응시 분포
  • Choice gaze time-course: 정답, 가장 유사한 단어, 기타 보기 응시 변화
  • 문항별 보기 역할과 선택 결과
  • Blink / rPPG: 평가 전체 및 문항·씬별 생체신호 품질
사전 또는 사후 데이터만 있으면 해당 평가만 표시되고, 두 평가가 모두 있어야 변화량을 비교할 수 있습니다.

문장 듣기 평가

문장 듣기 평가 → 사전/사후 녹음 듣기 및 채점

평가 상태와 요약

  • 업로드 중·채점 대기·채점 중·완료 상태
  • 전체 문항 수와 채점 완료 문항 수
  • 단어 정답률과 문장 완전 정답률
  • 사전·사후 점수 및 변화량 비교

문항별 채점 화면

  • 문항 번호, SNR, 정답 문장
  • 녹음파일 재생
  • 정답 단어 수와 관리자 메모 입력
  • 여러 문항의 변경사항을 한 번에 저장
문장 평가는 자동 정답이 아니라 관리자가 녹음을 듣고 저장한 채점 결과가 최종값입니다.

세 영역에서 볼 수 있는 데이터 비교

결과 항목본 훈련단어 평가문장 평가
정확도문제 정답률단어 정답률단어·문장 정답률
SNR·청취 역치문항 SNR·SRT80문항 SNR·SRT-50문항별 제시 SNR
사전·사후 비교–곡선·정답률·소음채점 점수 변화
반응시간·코인문항·세션별 제공––
시선추적게임 화면·선택지평가 화면·단어 보기현재 결과 화면 없음
Blink·rPPG세션·문항·씬별평가·문항·씬별현재 결과 화면 없음
음성 녹음·관리자 채점––녹음 재생·일괄 저장
표·그래프가 비어 있음해당 앱 버전에서 데이터가 수집되지 않았거나 아직 업로드되지 않은 경우입니다.
센서 탭이 비활성화됨선택 세션에 시선·Blink·rPPG 샘플이 없는 경우입니다.
사전·사후 변화가 없음둘 중 한 평가가 아직 완료되지 않았거나 채점이 끝나지 않은 경우입니다.

Blink와 rPPG는 연구 보조 지표입니다. 추정 심박은 의료 진단값이 아니며, PRV 적격 여부는 연속 고품질 구간을 기준으로 표시됩니다.

4. 문장 듣기 평가 채점
  1. 피험자를 선택하고 문장 듣기 평가 상세로 이동합니다.
  2. 듣기로 녹음을 재생합니다.
  3. 정답 문장과 비교해 정답 단어 수와 메모를 입력합니다.
  4. 여러 문항을 채점한 뒤 상단의 변경사항 저장을 한 번 누릅니다.
  5. 사전·사후 정답률과 변화량을 확인합니다.

입력만 하고 화면을 나가면 저장되지 않습니다. 반드시 변경사항 저장을 누르세요.

5. 데이터 저장 원칙
  • 서버에 성공적으로 업로드된 결과가 최종 데이터입니다.
  • 업로드 성공이 확인된 패드 녹음은 저장공간 확보를 위해 정리됩니다.
  • 업로드 실패 데이터는 재시도를 위해 패드에 남습니다.
  • 전후 비교와 직전 음량은 서버 기록을 사용합니다.
6. 문제가 생겼을 때
증상확인 및 해결
HTTP ERROR 502두 서버가 꺼진 상태입니다. 녹음 서버 → 관리 서버 순서로 다시 실행합니다.
녹음이 재생되지 않음녹음 서버(8091)가 열려 있는지 확인합니다. 한 녹음이 끝난 뒤 다음 녹음을 누릅니다.
피험자·결과가 안 보임피험자 코드와 앱의 업로드 완료 여부를 확인한 뒤 관리자 화면을 새로고침합니다.
앱 업로드 실패패드 Wi-Fi, Tailscale, 두 서버 실행 상태를 확인하고 다시 시도합니다.
화면 로딩이 느림동시에 여러 녹음을 재생하지 않습니다. 계속되면 서버를 재시작하고 새로고침합니다.