FAQ

학생이 "연결되지 않음" 상태로 남아 교사에 도달할 수 없습니다

순서대로 확인하세요:

1. 같은 서브넷: 교사와 학생이 같은 LAN/서브넷에 있음(서로 ping 가능).
2. 교사 실행 중: 방송하려면 교사 앱이 실행 중이어야 함.
3. 같은 채널: 학생은 기본적으로 채널 1; 교사의 첫 실행 시 선택한 채널이 일치해야 함.
4. 포트 열림: UDP 11100과 TCP 11100–11105 허용(Windows 설치 프로그램은 방화벽을 구성하고, Linux에서는 ufw/보안 소프트웨어를 주시).
5. 격리: 스위치/AP의 "AP/클라이언트 격리"는 방송을 차단함 — 끄세요.

교사 앱이 "이 컴퓨터는 교사로 표시되지 않아 시작하지 않음"이라고 표시합니다

컴퓨터 이름이 교사로 인식되지 않았습니다. 다음 중 하나:

• 컴퓨터 이름을 teacher 또는 -t 태그를 포함하도록(예: teacher-1, PC001-T) 변경하고 재부팅한 다음 교사 앱을 시작;

• 클라우드 데스크톱 환경에서는 클라우드 데스크톱 컴퓨터 이름을 변경(OS 호스트명보다 우선함) — 자동 감지 참조.

• 긴급 우회로, 검사를 건너뛰고 시작:

  # Linux
  /opt/cc-class/TeacherApp --no-host-check

  # Windows
  & "C:\Program Files\cc-class Electronic Classroom\TeacherApp.exe" --no-host-check

학생이 교사로 잘못 감지됩니다(또는 그 반대)

• 역할은 오직 컴퓨터 이름에 따라 결정됩니다. 이름에 실수로 -t/teacher 태그가 포함되어 있는지 확인하세요.

• 클라우드 데스크톱 설정에서는 클라우드 데스크톱 이름이 우선합니다 — 플랫폼이 그 컴퓨터에 푸시하는 이름을 확인하세요.

• Linux에서는 소프트웨어가 감지한 이름을 결정 로그에서 확인하세요:

  cat /tmp/cc-class-service.log     # contains "Effective computer name=[...], role=TEACHER/STUDENT"

• 이름 변경 후 재부팅하세요 — 데몬이 역할을 다시 평가하고 바탕화면 아이콘을 재생성/정리합니다.

Linux 교사가 "Wayland 감지됨, 방송/원격 제어 사용 불가"라고 경고하거나, 방송이 검게 나옵니다

Wayland 세션은 화면을 캡처하거나 입력을 주입할 수 없습니다. Xorg로 전환하세요:

• 설치 프로그램이 이미 WaylandEnable=false를 작성했습니다. 로그아웃했다가 다시 로그인하여 로그인 화면에서 Xorg 세션을 선택하거나 재부팅하세요.
• 확인: echo $XDG_SESSION_TYPE는 x11을 출력해야 합니다.

바탕화면에 바로 가기가 나타나지 않았습니다

• 학생 컴퓨터에는 의도적으로 바탕화면 아이콘이 없습니다(설계상); 응용 프로그램 메뉴에는 항목이 여전히 있습니다.
• 교사 컴퓨터에 아이콘이 없는 경우: 실제로 교사로 감지되는지 확인하고, 재부팅하여 데몬이 다시 만들도록 하세요. Linux에서는 GNOME의 "신뢰할 수 없는 실행기" 문제를 피하기 위해 아이콘이 자동으로 "신뢰됨"으로 표시됩니다.

한 방에서 여러 수업이 서로 간섭하나요?

아니요 — 각 수업의 교사/학생에게 다른 교육 채널을 부여하세요. 학생은 같은 채널의 교사에만 연결됩니다.

몇 명의 학생이 연결할 수 있나요?

체험판은 최대 5명을 허용합니다. 더 많은 인원이 필요하면 교사 앱에서 "머신 코드"와 함께 소프트웨어 등록을 사용하여 라이선스 키를 받으세요.

학생 앱이 닫히지 않거나 계속 다시 시작됩니다

이는 의도적입니다: 백그라운드 서비스가 학생 앱을 보호하고 닫히거나 충돌하면 다시 실행하므로 제어가 중단되지 않습니다. 영구적으로 중지하려면 관리자 권한으로 제거하거나, Linux에서는 systemctl stop cc-class-student.

컴퓨터 이름을 변경한 후 재설치해야 하나요?

아니요. 그냥 재부팅하세요 — 소프트웨어가 역할을 다시 평가하고 아이콘과 서비스를 자동으로 처리합니다.