Solución de problemas de H5P

Prev Next

Puede haber casos en los que los administradores del sitio o los creadores de cursos se encuentren con errores comunes de H5P, específicamente:

  • Errores de validación relacionados con bibliotecas H5P faltantes
  • Errores relacionados con un UUID de sitio o un secreto de Hub faltantes

 

Resolución de errores H5P

Error: Error al validar el paquete H5P: Falta la biblioteca principal @library

Este error generalmente ocurre cuando se intenta cargar contenido H5P que depende de una biblioteca de tipos de contenido que no está instalada actualmente en el sitio.

Causas

La causa más común es la ausencia de la biblioteca H5P requerida para el tipo de contenido en uso.

Resoluciones

Prueba una de las siguientes soluciones:

Instalar el tipo de contenido requerido a través de una actividad del curso

  1. Ir a cualquier curso.
  2. Añadir una nueva actividad H5P.
  3. Selecciona el tipo de contenido que coincida con el utilizado en el archivo que estás intentando cargar.
  4. El sistema te pedirá que instales la biblioteca que falta si aún no está instalada.
  5. Una vez instalado, regresa a la ubicación original e intenta cargarlo de nuevo.

Buscar actualizaciones de biblioteca existentes

  1. Navega hasta el menú Quick-access > Plugins > Módulos de actividad > H5P > Bibliotecas H5P.
  2. Seleccione el botón Actualizar () junto a la biblioteca correspondiente.
    • Si está activo, haga clic para actualizar.
    • Si está deshabilitado, la biblioteca está actualizada.

Actualizar manualmente a través de una actividad

Si existe una versión anterior de un tipo de contenido y no se puede actualizar directamente:

  1. Añadir una nueva actividad H5P en un curso.
  2. Selecciona el mismo tipo de contenido que el archivo que deseas cargar.
  3. Si se muestra un aviso Actualizar disponible, haz clic en él para actualizar el tipo de contenido y las bibliotecas asociadas.
  4. Vuelva a intentar cargar el archivo después.

 

Error: UUID del sitio o secreto del centro faltantes. Por favor, verifica tu registro en Hub.

Este es un problema conocido con el marco H5P y no es específico de Totara.

Explicación

El error puede aparecer durante la prueba o en entornos de desarrollo, y el mensaje de error se mostrará en la página de bibliotecas H5P (Menú de acceso rápido > Plugins > Módulos de actividad > H5P > Bibliotecas H5P). Se relaciona con la funcionalidad H5P Hub, que requiere un UUID válido y una clave secreta.

Impacto

  • No afecta a los usuarios: este mensaje de error solo es visible para los administradores del sitio y los creadores del curso.
  • No se requiere ninguna acción para la mayoría de los usuarios: si el contenido funciona correctamente de lo contrario, la advertencia se puede ignorar de forma segura.

Ha habido múltiples intentos para resolver este error dentro de H5P, pero a partir de ahora, los desarrolladores de H5P no han lanzado ninguna solución a largo plazo.

Para resolver el error, haz clic en Actualizar caché de tipo de contenido.

Ten en cuenta que el UUID del sitio o el secreto del centro faltantes. Por favor, verifica que tu mensaje de error de registro del Hub pueda volver cuando vuelvas a visitar la página de Bibliotecas H5P. Selecciona Actualizar caché de tipo de contenido para borrar el mensaje de error.

 

Join the Totara Community for more resources to help you get the most out of Totara. 


© Copyright 2026 Totara Learning Solutions. All rights reserved.