EasySignage - Guía de Integración MRSS

¿Qué es MRSS?

MRSS significa Media RSS, una extensión del formato RSS estándar diseñada específicamente para entregar contenido multimedia como imágenes y videos. Se usa ampliamente para actualizar automáticamente listas de reproducción y pantallas de señalización digital con contenido dinámico extraído de feeds externos.

¿Por Qué Usar MRSS en EasySignage?

Con MRSS, puedes automatizar las actualizaciones de contenido de tus pantallas apuntándolas a un feed externo. No necesitas subir ni reorganizar archivos manualmente — los cambios en el feed se reflejan automáticamente en tus pantallas.

Perfecto para:

Promociones retail
Noticias y anuncios
Tableros de menú
Campañas dinámicas de imágenes o videos

Cómo Usar MRSS en EasySignage

Abre la consola de administración.
Selecciona la lista de reproducción y luego la capa donde deseas agregar el archivo MRSS.
Si la capa no tiene medios, el diálogo de apps se abrirá automáticamente. De lo contrario, haz clic en Add New (Agregar nuevo).
Puedes encontrar MRSS en General Apps, Video Apps y News Apps.
Haz clic en MRSS para continuar.
Ingresa la URL del archivo MRSS.
Elige cuántos elementos multimedia deseas mostrar seleccionando un conteo de medios.
Selecciona el tipo de medio de la lista desplegable. Puedes elegir mostrar imágenes, videos o ambos.
Haz clic en “Save” (Guardar) para aplicar tus cambios.

Requisitos del Feed

Tu archivo MRSS debe estar:

Alojado en un servidor HTTPS válido
O devuelto como respuesta de una llamada API

Ejemplo de Formato MRSS:

<rss xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
  <channel>
    <title>Media RSS</title>
    <description>Media RSS Feed</description>
    <item>
      <title>Image 1</title>
      <media:content
        url="https://your-domain.com/path/image1.jpg"
        type="image/jpeg"
        medium="image"
        key_change="hash1"
        duration="10"/>
    </item>
    <item>
      <title>Video 1</title>
      <media:content
        url="https://your-domain.com/path/video1.mp4"
        type="video/mp4"
        medium="video"
        key_change="hash2"
        duration="10"/>
    </item>
  </channel>
</rss>

Descargar archivo de ejemplo del feed: Ejemplo de archivo MRSS

Guía de Campos XML MRSS

Entender los distintos campos de tu feed MRSS es crucial para asegurar que tus medios se actualicen correctamente en tus pantallas. A continuación se muestra una guía detallada de cada campo y atributo:

Raíz y Estructura

Campo	Requerido	Descripción
`<rss>`	✅	Elemento raíz del feed. Debe incluir `xmlns:media="http://search.yahoo.com/mrss/"` y `version="2.0"`.
`<channel>`	✅	Contiene metadatos sobre el feed y la lista de elementos multimedia.
`<title>`	✅	Título del canal o elemento (usado para identificación, no necesariamente se muestra en pantalla).
`<description>`	✅	Descripción del feed o del contenido del elemento.

`<item>` (Se repite por cada entrada multimedia)

Cada <item> representa un contenido multimedia (imagen o video).

Campo	Requerido	Descripción
`<title>`	✅	Título del elemento multimedia. Útil para referencia interna y organización.
`<media:content>`	✅	Contiene detalles sobre el archivo multimedia. Debe incluir atributos esenciales como URL, tipo y medio.

Atributos de `<media:content>`

Atributo	Requerido	Descripción
`url`	✅	Enlace directo al archivo multimedia (debe ser HTTPS). Ejemplo: `https://yourdomain.com/media/image.jpg`.
`type`	✅	El tipo MIME del archivo. Ejemplos: `image/jpeg` para imágenes, `video/mp4` para videos.
`medium`	✅	Especifica el tipo de medio, `image` o `video`. Esto ayuda al sistema a procesar y mostrar el archivo correctamente.
`duration`	✅	Duración (en segundos) durante la cual se muestra o reproduce el medio.
`key_change`	❌ (Recomendado)	Un identificador único (ej. un hash MD5) del archivo multimedia. Cambiar este valor fuerza al sistema a actualizar el archivo aunque la URL no cambie.

Ejemplo de Entrada

<item>
  <title>Video 1</title>
  <media:content
    url="https://yourdomain.com/media/video1.mp4"
    type="video/mp4"
    medium="video"
    duration="15"
    key_change="abc123xyz456def789"/>
</item>

Esta entrada reproduce video1.mp4 durante 15 segundos y solo activará una nueva descarga si la URL o el atributo key_change cambian.

Cómo Funcionan las Actualizaciones

El campo URL o key_change debe ser modificado para detectar un cambio.
Si no se detectan cambios, el sistema omitirá la descarga para conservar ancho de banda.
El atributo key_change debe actualizarse con una nueva cadena única (como un hash MD5) cuando el archivo multimedia cambie, incluso si la URL permanece igual.

Frecuencia de Actualización

Los feeds se verifican cada 15 minutos
Solo las listas de reproducción activas asignadas a reproductores en línea activarán las verificaciones de actualización
Si un reproductor está fuera de línea, no se enviarán actualizaciones
Cuando el reproductor vuelva a estar en línea, puede tomar hasta 15 minutos para actualizar el contenido

Almacenamiento de Medios

Todos los archivos multimedia del feed MRSS se descargan a nuestro almacenamiento en la nube
Los archivos se sincronizan con tu reproductor para una reproducción sin conexión confiable

Tipos de Medios Compatibles

Imágenes: image/jpeg, image/png
Videos: video/mp4, video/webm

Cada <media:content> debe incluir:

url (enlace al archivo)
type (tipo MIME)
medium (image o video)
duration (en segundos)
key_change (opcional pero recomendado)

Consejos

Mantén tu feed MRSS ligero y rápido de cargar.
Aloja tus archivos multimedia en un CDN confiable o servidor en la nube.
Siempre actualiza el valor de key_change para forzar actualizaciones cuando el contenido multimedia cambie, incluso si la URL permanece sin cambios.

Si tienes preguntas o necesitas ayuda para configurar tu feed, contacta al soporte de EasySignage.

Integración MRSS