Frontend SDK: встраивание прокторинга TrustExam

Подключение SDK

Добавьте скрипт на вашу страницу:

<script src="https://cdn.trustexam.ai/extension/app.js"></script>

<script src="https://cdn.trustexam.ai/extension/app.js"></script>

<script src="https://cdn.trustexam.ai/extension/app.js"></script>

Инициализация

'''javascript'''

Proctoring.initialize('.wrapper', {
  language: 'ru', // 'en' / 'ru' / 'kz'
  token: 'external_session.token из ответа backend API',

  protector: {
    match: '.question-wrapper',
    textColor: '#000'
  },

  onMounted: function () { /* SDK смонтирован */ },
  onConfigured: function () { /* конфигурация загружена */ },
  onStarted: function () { /* экзамен начат */ },
  onFinished: function () { /* экзамен завершён */ },
  onAction: function (action) { /* события / действия */ },
  onError: function (error) { /* обработка ошибок */ }
});

'''javascript'''

Proctoring.initialize('.wrapper', {
  language: 'ru', // 'en' / 'ru' / 'kz'
  token: 'external_session.token из ответа backend API',

  protector: {
    match: '.question-wrapper',
    textColor: '#000'
  },

  onMounted: function () { /* SDK смонтирован */ },
  onConfigured: function () { /* конфигурация загружена */ },
  onStarted: function () { /* экзамен начат */ },
  onFinished: function () { /* экзамен завершён */ },
  onAction: function (action) { /* события / действия */ },
  onError: function (error) { /* обработка ошибок */ }
});

'''javascript'''

Proctoring.initialize('.wrapper', {
  language: 'ru', // 'en' / 'ru' / 'kz'
  token: 'external_session.token из ответа backend API',

  protector: {
    match: '.question-wrapper',
    textColor: '#000'
  },

  onMounted: function () { /* SDK смонтирован */ },
  onConfigured: function () { /* конфигурация загружена */ },
  onStarted: function () { /* экзамен начат */ },
  onFinished: function () { /* экзамен завершён */ },
  onAction: function (action) { /* события / действия */ },
  onError: function (error) { /* обработка ошибок */ }
});

Параметры

• selector (string)

  CSS-селектор контейнера (например, .wrapper), в который будет встроен интерфейс прокторинга.

• language (string)

  Язык интерфейса: "en", "ru", "kz".

• token (string)

  Значение external_session.token, полученное от backend-API.

• protector (object, опционально)

  Настройки Content Protect:

  • match – селектор защищаемого элемента (например, .question-wrapper).

  • textColor – цвет текста внутри контейнера (для корректного отображения).

Колбэки

• onMounted() – вызывается после монтирования SDK в DOM.

• onConfigured() – SDK успешно сконфигурирован.

• onStarted() – попытка экзамена начата.

• onFinished() – попытка экзамена завершена.

• onAction(action) – вызывается при внутренних событиях (например, фиксация нарушений).

• onError(error) – вызывается при ошибке.

Основные методы

1. Proctoring.start()

'''javascript'''

Proctoring.start()
  .then(() => console.log('started'))
  .catch(err => console.log(err));

'''javascript'''

Proctoring.start()
  .then(() => console.log('started'))
  .catch(err => console.log(err));

'''javascript'''

Proctoring.start()
  .then(() => console.log('started'))
  .catch(err => console.log(err));

Запускает попытку экзамена после инициализации.

2. Proctoring.finish()

'''javascript'''

Proctoring.finish()
  .then(() => console.log('finished'))
  .catch(err => console.log(err));

'''javascript'''

Proctoring.finish()
  .then(() => console.log('finished'))
  .catch(err => console.log(err));

'''javascript'''

Proctoring.finish()
  .then(() => console.log('finished'))
  .catch(err => console.log(err));

Явно завершает попытку экзамена (например, при нажатии «Отправить»).

3. Proctoring.startNewAttempt()

'''javascript'''

Proctoring.startNewAttempt()
  .then(() => console.log('new attempt started'))
  .catch(err => console.log('cannot start new attempt'));

'''javascript'''

Proctoring.startNewAttempt()
  .then(() => console.log('new attempt started'))
  .catch(err => console.log('cannot start new attempt'));

'''javascript'''

Proctoring.startNewAttempt()
  .then(() => console.log('new attempt started'))
  .catch(err => console.log('cannot start new attempt'));

Запускает новую попытку, если это разрешено настройками задания.

4. Вспомогательные методы

• Proctoring.isFinished() – возвращает true, если задание уже завершено.

• Proctoring.isCanStartNewAttempt() – возвращает true, если возможен запуск новой попытки.

Content Protect

Content Protect защищает содержимое от:

• скриншотов и записи экрана,

• инструментов удалённого управления, пытающихся захватить область экзамена.

Чтобы включить Content Protect:

• На backend: установите content_protect: true в assignment.settings.proctoring_settings.

• На frontend: передайте объект protector в Proctoring.initialize:

protector: { match: '.question-wrapper', textColor: '#000' }

protector: { match: '.question-wrapper', textColor: '#000' }

protector: { match: '.question-wrapper', textColor: '#000' }

Где:

• match – селектор защищаемого элемента.

• textColor – цвет текста внутри контейнера.