====== Локальный прокторинг ======

===== Поддерживаемые браузеры =====
==== Расширение предназначено для работы с браузером Google Chrome. Требуемая версия браузера Google Chrome 134 и выше. ====

Узнать свою версию браузера Google Chrome можно по адресу <code>chrome://version</code>.

Поскольку расширение разработано на базе Chromium, оно может работать в других браузерах (Microsoft Edge, Yandex Browser, Opera), однако официальной поддержки нет.

===== Поддерживаемые операционные системы =====
==== Расширение предназначено для работы с Linux и Windows. ====

Поддержка MacOS не планируется.
  * Инструкция ознакомительная — следите за уведомлениями системы

====== Инструкция по использованию системы локального прокторинга ======

===== Подготовка папки расширения =====
  - Скачайте архив https://github.com/moevm/local-proctoring/releases/tag/v2.0.1 <code>client_v*.*.*.zip</code>
  - Распакуйте архив. Нужная папка — <code>client</code>

===== Установка расширения в Google Chrome =====
  - Откройте «Управление расширениями»
  - Включите режим разработчика
  - Нажмите «Load unpacked» и выберите папку <code>client</code>
  - Убедитесь, что расширение появилось
  - Закрепите расширение на панели

===== Работа с клиентской частью =====

  - **Откройте интерфейс расширения**
    * Через иконку на панели
    * Или через меню расширений

  - **Заполните данные**
    * Группа — 4 цифры (например <code>1234</code>)
    * Фамилия, Имя, Отчество — с заглавной буквы
    * Ссылка на экзамен — корректный URL

  - **Настройте разрешения**
    * Нажмите «Разрешения»
    * Разрешите:
      - экран
      - микрофон
      - камеру

  - **Начните запись**
    * Нажмите «Начать запись»
    * Для остановки — «Остановить запись»

===== Важно =====
Перед началом обязательно ознакомьтесь с инструкцией полностью.

===== Подробные инструкции =====

==== 1. Открытие popup ====
  - Нажмите на иконку расширения
  - Или через значок «Пазл»
  - Выберите расширение

==== 2. Интерфейс ====
Поля:
  * Группа
  * Фамилия
  * Имя
  * Отчество
  * Ссылка на экзамен

Дополнительно:
  * Чекбокс «без отчества»
  * Статусы разрешений:
    * Микрофон
    * Камера
    * Экран
  * Кнопки:
    * Разрешения
    * Начать запись
    * Остановить запись

==== 3. Заполнение данных ====
  * Группа — 4 цифры
  * ФИО — буквы и тире
  * Ссылка — обязательна

Система автоматически проверяет ввод.

==== 4. Настройка разрешений ====
  - Нажмите «Разрешения»
  - НЕ закрывайте системную вкладку
  - Разрешите:
    * экран
    * микрофон
    * камеру

Если отказать — появится ошибка, нужно повторить.

После успешной настройки появится предпросмотр:
  * слева — экран
  * справа — камера

==== 5. Начало записи ====
  - Нажмите «Начать запись»
  - Начнётся запись
  - Предпросмотр отключится

При отзыве разрешений:
  - запись остановится
  - потребуется повторная настройка

==== 6. Конец записи ====
  - Нажмите «Остановить запись»
  - Файлы сохранятся в папку загрузок

Система покажет:
  * время начала и конца
  * длительность
  * файлы записей
  * лог

===== Просмотр записей =====

Кодеки:
  * H264 (avc1)
  * OPUS

Плеер должен поддерживать эти кодеки.

==== Полная поддержка ====
  * Linux:
    - Chrome
    - Microsoft Edge
    - Totem
    - Haruna
  * Windows:
    - Chrome
    - Microsoft Edge
    - Vivaldi

==== Частичная поддержка ====
  * Linux:
    - VLC (возможны проблемы)
    - Firefox (нет перемотки)
    - Dragon Player (артефакты)
  * Windows:
    - Кино и ТВ
    - Фотографии
    - Медиаплеер
    - Firefox
    - VLC (искажения при перемотке)