EMPEZAR / COMPONENTES

Mapa de componentes

P2LRN está dividido en piezas pequeñas con responsabilidades distintas. Elegir la pieza correcta evita duplicar funciones de tu aplicación dentro del paquete.

1. El recorrido completo

Studio o Toolkit→.p2lrn→Player↕Host Adapter / Capability Broker↕tu plataforma

Studio y Toolkit producen o modifican el paquete. Player lo reproduce. Host Adapter comunica estado, puntuación, eventos y recursos; Capability Broker conecta servicios vivos opcionales como colaboración sin introducir endpoints ni credenciales en el curso.

2. Componentes principales

Studio

Editor visual para cursos, imágenes, cuestionarios, juegos, colaboración, recursos compartidos y grupos de actividades.

Componentes nativos

Contenido portable sin dependencias externas, incluidos texto, imagen, vídeo, Aviso, pestañas y línea temporal.

Toolkit

Autoría/Reader/validación/conversión, Host de referencia y CLI.

Player

Abre y verifica el paquete, negocia capacidades y reproduce representaciones.

Host Adapter

Estado, puntuación, eventos y recursos protegidos.

Capability Broker

Servicios vivos opcionales como colaboración/IA sin entregar secretos al curso.

Offline Host Adapter

Estado local y outbox ordenado; puede sincronizar al volver la red.

Package Cache

Conserva bytes verificados del curso para reabrirlos offline. No contiene estado del alumno.

Resource Library

Biblioteca content-addressed de recursos compartidos verificados por SHA-256.

Host autoritativo

Referencia server-side para separar evidencia del navegador de estado/nota oficial.

Reader

Extrae estructura de documentos para decidir cómo convertirla a contenido.

Multipart

Transporte verificado de recursos grandes fuera del archivo principal.

3. Qué componente usar según la tarea

Un profesor crea un curso

Studio.

Un proceso genera muchos cursos

Toolkit y CLI.

Una web reproduce el curso

Player.

Guardar progreso o notas oficiales

Host Adapter y backend autorizado; usa el Host autoritativo de referencia como patrón, no como sistema de identidad.

Seguir trabajando sin red

Offline Host Adapter para estado/outbox y Package Cache para bytes del curso.

Reutilizar recursos entre cursos

Resource Library o representación remota con expectedDigest + resolver verificado.

Dos alumnos colaboran

Capability Broker + provider de colaboración del Host.

Integrar en un LMS

Player/Host directo o proveedor LTI 1.3 self-hosted.

Importar un documento

Reader.

Recurso muy grande

Multipart.

4. Qué no debe guardarse dentro del paquete

El paquete contiene estructura, contenido, perfiles y metadatos portables. No debe convertirse en una base de datos de usuarios. Identidad, contraseñas, permisos, matrículas, secretos, progreso individual y datos privados permanecen en la plataforma.

5. Cómo encaja la instalación

NPM y CDN son formas de cargar componentes del navegador; no son productos distintos. Una vez elegido el recorrido de instalación, la API del Player o de Studio es la misma para esa versión.