INSTALACIÓN / NPM
Instalación con NPM
Usa esta guía cuando P2LRN forma parte de un proyecto que gestiona sus dependencias con NPM. Cada paquete tiene una función distinta y puedes instalar sólo los que necesites.
1. Paquetes disponibles
@p2lrn/playerReproduce cursos .p2lrn y expone Host Adapter, capacidades, colaboración, offline/cache y analítica del navegador.
@p2lrn/studioIntegra el editor visual. Usa @p2lrn/player para la vista previa.
@p2lrn/toolkitAutoría, Reader, validación, Host de referencia y herramientas Node.js/TypeScript.
@p2lrn/analyticsPanel y agregación para alumnos, cursos, progreso, actividad, intentos y notas autoritativas.
@p2lrn/h5p-librariesCorpus opcional de librerías H5P reutilizables para contenidos que no incluyen toda su closure.
Los cinco paquetes de la prerelease actual están alineados en 0.5.0-alpha.11 y se publican bajo el dist-tag next. Los ejemplos usan la versión exacta para evitar resolver otro canal por accidente.
2. Instalar el Player
Instala el paquete y después impórtalo una vez desde el código de tu aplicación.
npm install @p2lrn/player@0.5.0-alpha.11import '@p2lrn/player';<p2lrn-player src="/courses/course.p2lrn"></p2lrn-player>Después del import, el elemento <p2lrn-player> queda disponible en la página.
3. Instalar Studio
Studio utiliza Player como dependencia del entorno de navegador, por lo que ambos deben estar disponibles en la misma aplicación.
npm install @p2lrn/studio@0.5.0-alpha.11 @p2lrn/player@0.5.0-alpha.11import '@p2lrn/studio';4. Instalar el Toolkit
Instala Toolkit cuando necesites crear/procesar paquetes, Reader documental o el Host autoritativo de referencia desde Node.js/TypeScript.
npm install @p2lrn/toolkit@0.5.0-alpha.11Toolkit requiere Node.js 22 o posterior. Player y Studio declaran Node.js 18 o posterior para sus herramientas de paquete.
5. Instalar Analytics
Analytics es independiente de Studio y Player: sólo necesita el dataset autorizado que entregue tu Host.
npm install @p2lrn/analytics@0.5.0-alpha.116. Instalar librerías H5P compartidas (opcional)
No todos los cursos las necesitan. Instálalas cuando un .h5p real dependa de librerías que no viajan dentro del propio archivo.
npm install @p2lrn/h5p-libraries@0.5.0-alpha.11El runtime puede resolver ese catálogo desde el host de librerías configurado. Una librería ausente no se inventa: la carga falla de forma explícita.
7. Comprobar que la integración está lista
Después de instalar e importar un componente, abre la página donde lo has montado y verifica dos cosas: que el elemento se registra sin errores de JavaScript y que puede acceder al archivo .p2lrn indicado en src. Si el paquete está en otro origen, el servidor que lo aloja debe permitir su lectura desde el navegador.
8. Elegir qué instalar
Instala @p2lrn/player.
Instala @p2lrn/studio y @p2lrn/player.
Instala @p2lrn/toolkit.
Instala @p2lrn/analytics.
Añade @p2lrn/h5p-libraries sólo cuando esas dependencias no estén embebidas.
9. Siguiente paso
Si sólo necesitas reproducir, continúa con Player. Si vas a integrar el editor, sigue la guía de Studio con NPM. Para autoría por código, continúa con Toolkit.