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 の「信頼されていないランチャー」問題を避けるため、アイコンは自動的に「信頼済み」とマークされます。

1 つの部屋で複数のクラスが干渉しますか？

いいえ — クラスごとに教師／生徒に異なる授業チャンネルを割り当ててください。生徒は同じチャンネルの教師にのみ接続します。

何人の生徒が接続できますか？

試用版では最大 5 名です。それ以上必要な場合は、教師アプリの ソフトウェア登録 で「マシンコード」を使ってライセンスキーを取得してください。

生徒アプリが閉じない／再起動を繰り返す

これは意図的です：バックグラウンドサービスが生徒アプリを保護し、閉じられたりクラッシュしたりすると再起動するため、制御が中断されることはありません。永久に停止するには、管理者としてアンインストールするか、Linux では systemctl stop cc-class-student を実行してください。

機器の名前を変更した後、再インストールが必要ですか？

いいえ。再起動するだけです — ソフトウェアが役割を再評価し、アイコンとサービスを自動的に処理します。