학생 앱 문제 해결

이 가이드는 ELSA School 학생 앱 사용 시 발생하는 가장 일반적인 문제를 해결하는 데 도움을 줍니다. 학생, 교사, IT 관리자가 참고할 수 있습니다.

1. 사전 요구사항

1.1 시스템 요구사항

카테고리	최소 요구사항
웹 브라우저	- Chrome ≥ 87 - Firefox ≥ 78 - Safari ≥ 14 - Edge ≥ 88
운영 체제	위의 브라우저를 지원하는 모든 최신 OS
화면 해상도	- 최소 지원: 1024 × 768 - 권장: 1366 × 768 이상
인터넷 대역폭	- 최소: 15–20 Mbps - 권장: 30 Mbps 이상

1.2 사용자 기기 요구사항

브라우저에서 마이크 권한이 허용되어야 합니다.
기기에 마이크를 물리적으로 막는 것이 없어야 합니다. 가능한 방해 요소:
- 케이스
- 화면 보호기

1.3 네트워크 및 보안 요구사항

학교 IT에서 다음을 화이트리스트에 추가해야 합니다:

구성 유형	값
화이트리스트 도메인	- b2b-server.elsanow.io - pool.elsanow.io - content-media.elsanow.co - http://student.elsaspeak.com
포트 (필요한 경우)	443 (HTTPS)
활성화할 WebSocket (필요한 경우)	wss://pool.elsanow.io

2. 문제 해결

다음은 일반적인 문제, 원인 및 단계별 해결 방법입니다.

2.1 마이크가 허용되지 않음

오류:
"마이크 접근이 필요합니다. 기기 설정에서 활성화해주세요."

원인:
브라우저에서 마이크 권한이 거부되었습니다.

해결 방법:

브라우저 사이트 설정을 엽니다.
ELSA 웹사이트에 대해 마이크를 활성화합니다.
페이지를 새로고침합니다.

2.2 앱이 학생의 음성을 감지하지 못함

오류:

"전체 문구를 읽으셨나요? 다시 시도해주세요." 반복적으로 나타남

원인:
앱이 사용자의 음성을 감지하지 못합니다.

가능한 원인 및 해결 방법:

원인	해결 방법
마이크 권한이 부여되지 않음	브라우저 설정에서 마이크를 활성화합니다.
마이크가 물리적으로 막혀있음	마이크를 덮고 있는 케이스/화면 보호기를 제거합니다.
불량 마이크 (이어폰)	이어폰 없이 테스트하거나 다른 이어폰으로 바꿉니다.
시끄러운 환경	더 조용한 곳으로 이동합니다.
하드웨어 마이크 스위치 비활성화됨	노트북의 경우 하드웨어 마이크 토글 키가 ON인지 확인합니다.
PC가 오디오 입력을 감지하지 못함	기기 음성 설정을 엽니다 → 말할 때 마이크 입력 레벨이 움직이는지 확인합니다.

2.3 서버에 연결할 수 없음

오류:
"서버에 연결할 수 없습니다."

원인:
학교 방화벽 또는 콘텐츠 필터링이 ELSA 서버 접근을 차단하고 있습니다.

해결 방법:

필요한 모든 도메인이 화이트리스트에 있는지 확인합니다.
포트 443 및 WebSocket 트래픽이 허용되는지 확인합니다.
문제가 지속되면 ELSA 지원팀에 문의합니다.

iPad 환경을 위한 추가 확인:

MDM 또는 콘텐츠 필터링이 설치되어 있는지 확인합니다.
일부 필터는 특정 HTTP 메서드 (예: PATCH, PUT)를 차단할 수 있습니다.
잠금 모드가 활성화되어 있는지 확인합니다: https://support.apple.com/en-us/105120
IT에서 필터링 정책에서 이러한 메서드를 활성화해야 할 수 있습니다.

2.4 교사의 최신 과제를 볼 수 없음

가능한 원인	해결 방법
학생이 반에 올바르게 등록되지 않았습니다.	학생이 올바른 반에 등록되어 있는지 확인합니다.
교사가 잘못된 반에 과제를 할당했거나 시작 날짜가 오늘이 아닙니다.	과제가 올바른 반에 할당되었는지, 시작 날짜가 오늘인지 확인합니다.
브라우저 캐시가 최신 데이터 로드를 차단하고 있습니다.	브라우저 캐시를 삭제합니다.
학생이 잘못된 계정으로 로그인했습니다.	학생이 올바른 계정으로 로그인했는지 확인합니다.

2.5 앱이 느리거나 지연됨

원인:
기기 사양이 부족하거나 캐시가 쌓여있습니다.

해결 방법:

더 높은 처리 능력이나 더 많은 메모리를 가진 지원 기기로 전환합니다.
브라우저의 캐시를 삭제합니다.

2.6 학생 앱에 로그인할 수 없음

오류:
"자격증명이 일치하지 않습니다."

원인:
이메일 또는 비밀번호가 올바르지 않습니다.

해결 방법:

로그인 페이지의 **"비밀번호를 잊으셨나요?"**를 클릭하고 비밀번호를 재설정합니다.
- 학교 이메일을 사용하는 경우 해당 이메일을 입력하고 받은 편지함에서 재설정 링크를 확인합니다.
xxxxx@elsaspeak.com과 같은 별칭을 사용하는 경우 교사에게 ELSA 고객 지원팀에 문의하도록 알립니다.
elsa_001@k12.elsanow.io와 같은 별칭을 사용하는 경우 교사에게 알립니다.
- 교사는 관리자 대시보드를 통해 비밀번호를 직접 재설정할 수 있습니다.

오류:
"계정이 비활성화되었습니다. 교사에게 문의해주세요."

원인:
학생 계정이 관리자 대시보드에서 비활성으로 표시되었습니다.

해결 방법:

교사는 관리자 대시보드에서 계정을 다시 활성화해야 합니다.
계정이 이미 활성화되어 있으면 ELSA 지원팀에 문의합니다.
- 학생이 다른 조직에서 비활성일 수 있으며, ELSA에서 수정해야 합니다.

2.7 음성 읽기에서 녹음 저장 실패

오류:

음성 읽기에서 녹음을 마칠 때 _"내부 오류"_가 나타납니다.

원인:
녹음 처리 중 오류가 발생했습니다.

가능한 원인 및 해결 방법:

원인	해결 방법
녹음이 너무 짧음 (3초 미만).	텍스트를 따라 읽고 더 길게 말합니다. 텍스트를 완료하기 전에 녹음을 중지하지 마세요.
텍스트 문구에 시스템이 인식하지 못하는 구두점 또는 기호가 포함되어 있습니다.	관리자 대시보드에서 쉼표와 마침표를 제외한 다른 모든 구두점 또는 기호를 제거하고 과제를 다시 할당한 후 오류가 해결되는지 확인합니다.
서버 연결에 문제가 있었습니다.	로그아웃하고 다시 로그인합니다. 다른 시간에 다시 시도합니다.

3. ELSA 지원팀에 문의할 시점

위의 단계를 완료한 후 다음의 경우 이 보고 양식 (https://forms.gle/beGvWffUr8A6nKiE6)을 통해 ELSA에 문의하세요:

여러 기기에서 문제가 지속되는 경우
설정이 올바름에도 불구하고 학생이 앱을 사용할 수 없는 경우