Розробка 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", "uk-UA": "завершив" } }, "object": { "objectType": "Activity", "id": "https://lms.example.com/courses/python-basics/lessons/variables", "definition": { "name": { "uk-UA": "Змінні в 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'->>'uk-UA' 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 — отримайте гнучкий інструмент для вимірювання навчального досвіду.