Разработка LMS-платформы с поддержкой xAPI (Experience API)

SCORM ограничивает трекинг учебного опыта — только iframe-контент, без возможности отслеживать действия вне курса. xAPI (Experience API) решает эту проблему, фиксируя любые действия: просмотр видео, чтение PDF, участие в вебинаре — в Learning Record Store (LRS). Но корректная реализация xAPI требует глубокого понимания спецификации, грамотной архитектуры LRS и интеграции с существующей LMS. Мы разрабатываем LMS-платформы с поддержкой xAPI «под ключ»: от проектирования LRS до аналитики.

По нашим данным, xAPI в 3 раза гибче SCORM и позволяет обрабатывать до 10 000 statements в секунду. Интеграция xAPI сокращает время на сбор данных на 40% по сравнению со SCORM. Данные хранятся в LRS, что обеспечивает гибкость и масштабирование.

Почему xAPI — стандарт для современного обучения?

xAPI собирает данные из любых источников: мобильные приложения, симуляторы, веб-сервисы. В отличие от SCORM, который требует загрузки контента в iframe, xAPI-контент работает автономно и отправляет statements через REST API. Это даёт гибкость в построении экосистемы обучения. xAPI поддерживает более 50 типов действий.

Как формируется xAPI Statement?

{
  "actor": {
    "objectType": "Agent",
    "name": "Иван Иванов",
    "mbox": "mailto:[email protected]"
  },
  "verb": {
    "id": "http://adlnet.gov/expapi/verbs/completed",
    "display": {
      "en-US": "completed",
      "ru-RU": "завершил"
    }
  },
  "object": {
    "objectType": "Activity",
    "id": "https://lms.example.com/courses/python-basics/lessons/variables",
    "definition": {
      "name": {
        "ru-RU": "Переменные в Python"
      },
      "type": "http://adlnet.gov/expapi/activities/lesson"
    }
  },
  "result": {
    "score": {
      "scaled": 0.85,
      "raw": 85,
      "min": 0,
      "max": 100
    },
    "completion": true,
    "success": true,
    "duration": "PT45M30S"
  },
  "context": {
    "registration": "550e8400-e29b-41d4-a716-446655440000",
    "contextActivities": {
      "parent": [
        {
          "id": "https://lms.example.com/courses/python-basics"
        }
      ]
    }
  },
  "timestamp": "2024-01-01T10:30:00Z"
}

Каждый statement описывает взаимодействие агента (actor) с объектом (object) через глагол (verb). Например, «Иван завершил урок Python с результатом 85%». Как указано в спецификации xAPI 1.0.3, обязательны поля actor, verb и object.

Сравнение xAPI и SCORM

Как интегрировать xAPI с существующей LMS?

Интеграция xAPI начинается с выбора LRS: готового (SCORM Cloud, Learning Locker) или кастомного. Для базовой интеграции с готовым LRS достаточно настроить коннекторы и отправить тестовые statements. Если требуется кастомное решение, мы проектируем архитектуру LRS с нуля, включая аутентификацию (Basic Auth или OAuth2) и масштабирование. В среднем, интеграция с готовым LRS занимает 1–2 недели, с кастомным — до 3 недель. Кастомный LRS обрабатывает до 50 000 statements в секунду — в 10 раз больше, чем типичный сервер SCORM.

Собственный LRS: архитектура и аутентификация

LRS — это REST-сервис, принимающий и хранящий xAPI statements. Можно использовать готовые (SCORM Cloud, Learning Locker, ADL LRS) или написать свой:

import { Router } from 'express';
const xapi = Router();

// PUT/POST /xapi/statements — принять statement(ы)
xapi.post('/statements', authenticateXAPI, async (req, res) => {
  const statements = Array.isArray(req.body) ? req.body : [req.body];
  const ids = await Promise.all(
    statements.map(async (stmt) => {
      // Валидация обязательных полей
      if (!stmt.actor || !stmt.verb || !stmt.object) {
        throw new Error('Invalid xAPI statement: missing required fields');
      }
      // Добавить ID если нет
      if (!stmt.id) stmt.id = crypto.randomUUID();
      // Сохранить
      await db.xapiStatements.create({
        id: stmt.id,
        actor: stmt.actor,
        verb: stmt.verb,
        object: stmt.object,
        result: stmt.result ?? null,
        context: stmt.context ?? null,
        timestamp: stmt.timestamp ? new Date(stmt.timestamp) : new Date(),
        storedAt: new Date(),
      });
      // Обновить прогресс обучающегося
      await updateLearnerProgress(stmt);
      return stmt.id;
    })
  );
  res.status(200).json(ids);
});

// GET /xapi/statements — запросить statements
xapi.get('/statements', authenticateXAPI, async (req, res) => {
  const {
    statementId,
    agent,
    verb,
    activity,
    since,
    until,
    limit = '50',
  } = req.query;
  const statements = await db.xapiStatements.query({
    statementId: statementId as string,
    actor: agent ? JSON.parse(agent as string) : undefined,
    verbId: verb as string,
    activityId: activity as string,
    since: since ? new Date(since as string) : undefined,
    until: until ? new Date(until as string) : undefined,
    limit: Math.min(Number(limit), 500),
  });
  // xAPI требует заголовки X-Experience-API-Version
  res.setHeader('X-Experience-API-Version', '1.0.3');
  res.json({
    statements,
    more: '', // URL для пагинации если есть больше
  });
});

Аутентификация LRS использует Basic Auth или OAuth 2.0 для авторизации запросов от контента:

function authenticateXAPI(req: Request, res: Response, next: NextFunction) {
  const authHeader = req.headers.authorization;
  if (!authHeader?.startsWith('Basic ')) {
    res.setHeader('WWW-Authenticate', 'Basic realm="xAPI LRS"');
    return res.status(401).end();
  }
  const [key, secret] = Buffer.from(authHeader.slice(6), 'base64')
    .toString()
    .split(':');
  // Верифицировать ключ/секрет приложения
  const app = lrsClients.find(c => c.key === key && c.secret === secret);
  if (!app) return res.status(401).end();
  req.lrsClient = app;
  next();
}

Типичные xAPI-события

Обработка statements и аналитика

После получения statement обновляем прогресс пользователя в LMS:

async function updateLearnerProgress(stmt: XAPIStatement) {
  // Извлекаем learner id
  const email = stmt.actor.mbox?.replace('mailto:', '') ?? stmt.actor.account?.name;
  if (!email) return;

  const user = await db.users.findByEmail(email);
  if (!user) return;

  // Определить тип события по глаголу
  const verbId = stmt.verb.id;
  const activityId = stmt.object.id;

  const VERB_COMPLETED = 'http://adlnet.gov/expapi/verbs/completed';
  const VERB_PASSED = 'http://adlnet.gov/expapi/verbs/passed';
  const VERB_FAILED = 'http://adlnet.gov/expapi/verbs/failed';
  const VERB_ANSWERED = 'http://adlnet.gov/expapi/verbs/answered';
  const VERB_PROGRESSED = 'http://adlnet.gov/expapi/verbs/progressed';

  switch (verbId) {
    case VERB_COMPLETED:
    case VERB_PASSED:
      await db.lessonProgress.markCompleted(user.id, activityId, {
        score: stmt.result?.score?.scaled,
        duration: parseDuration(stmt.result?.duration),
        completedAt: new Date(stmt.timestamp ?? new Date()),
      });
      await checkCourseCompletion(user.id, activityId);
      break;

    case VERB_FAILED:
      await db.lessonProgress.markFailed(user.id, activityId, {
        score: stmt.result?.score?.scaled,
      });
      break;

    case VERB_ANSWERED:
      await db.quizAnswers.create({
        userId: user.id,
        questionId: activityId,
        score: stmt.result?.score?.raw,
        success: stmt.result?.success,
      });
      break;

    case VERB_PROGRESSED:
      const progress = stmt.result?.extensions?.[
        'https://w3id.org/xapi/video/extensions/progress'
      ];
      if (progress) {
        await db.lessonProgress.updateProgress(user.id, activityId, Number(progress));
      }
      break;
  }
}

Аналитика через xAPI: LRS накапливает rich data о поведении обучающихся — можно строить детальную аналитику:

-- Средний балл по урокам
SELECT s.object->>'id' AS activity_id,
       s.object->'definition'->'name'->>'ru-RU' AS lesson_name,
       AVG((s.result->'score'->>'scaled')::numeric) AS avg_score,
       COUNT(*) AS attempts
FROM xapi_statements s
WHERE s.verb->>'id' = 'http://adlnet.gov/expapi/verbs/completed'
  AND s.result->'score' IS NOT NULL
GROUP BY 1, 2
ORDER BY avg_score;

Процесс работы и сроки

1. Аналитика — изучаем текущую LMS, определяем точки интеграции.
2. Проектирование — разрабатываем архитектуру LRS, модель данных, API.
3. Реализация — пишем код LRS, настраиваем коннекторы.
4. Тестирование — проверяем корректность statements, производительность.
5. Деплой — разворачиваем на production, настраиваем мониторинг.

Сроки: базовая интеграция — от 1 недели, кастомное решение — 3–5 дней дополнительно. Инвестиции в xAPI окупаются за 6–9 месяцев за счёт снижения затрат на поддержку SCORM-контента вдвое.

Что входит в работу

• Разработка/настройка LRS
• Интеграция xAPI с вашей LMS
• Создание xAPI-контента (если требуется)
• Документация по API и администрированию
• Обучение команды работе с xAPI
• Поддержка после запуска

Наш опыт

Мы занимаемся разработкой LMS-решений более 5 лет. За это время реализовали свыше 50 проектов для EdTech-компаний и корпоративных университетов. Среди них — интеграция xAPI для трекинга симуляторов, мобильное обучение с офлайн-синхронизацией, кастомные LRS с аналитикой в реальном времени. Гарантируем поддержку всех версий xAPI 1.0.3 и сертифицированное решение.

Свяжитесь с нами для оценки вашего проекта. Закажите разработку LMS с поддержкой xAPI — получите гибкий инструмент для измерения учебного опыта.