Integración Media JSON

¿Qué es Media JSON?

Media JSON es una estructura JSON ligera diseñada para entregar contenido multimedia como imágenes y videos. Sirve como una alternativa moderna a MRSS, optimizada para integración con APIs y automatización sencilla de contenido.

¿Por Qué Usar Media JSON en EasySignage?

Con Media JSON, puedes automatizar las actualizaciones de contenido apuntando tu pantalla a un feed JSON externo. No necesitas subir archivos manualmente — cualquier cambio en el feed se refleja instantáneamente 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 Media JSON en EasySignage

• Abre la consola de administración.
• Selecciona la lista de reproducción y luego la capa donde deseas agregar el feed.
• Si la capa está vacía, el diálogo de apps se abrirá automáticamente. De lo contrario, haz clic en Add New (Agregar nuevo).
• Busca Media JSON en General Apps, Video Apps y News Apps.
• Haz clic en Media JSON para continuar.
• Ingresa la URL del feed.
• Elige el número de elementos a mostrar usando la opción de conteo de medios.
• Selecciona el tipo de medio: imágenes, videos o ambos.
• Haz clic en Save (Guardar) para aplicar tus cambios.

Requisitos del Feed

Tu feed Media JSON debe estar:

• Alojado en un servidor HTTPS válido
• O devuelto desde un endpoint de API público

Ejemplo de Formato Media JSON:

{
  "channel": {
    "items": [
      {
        "title": "Image 1",
        "mediaContent": {
          "url": "https://files.cloud-digitalsignage.com/mrss/files/1.jpg",
          "type": "image/jpeg",
          "medium": "image",
          "duration": "10",
          "changeKey": "a077ae97dfe45af878f0e0fafdc05c85"
        }
      },
      {
        "title": "Video 1",
        "mediaContent": {
          "url": "https://files.cloud-digitalsignage.com/mrss/files/a.mp4",
          "type": "video/mp4",
          "medium": "video",
          "duration": "10",
          "changeKey": "f11b8c8d750d2087e0a6c0478840063d"
        }
      }
    ]
  }
}

Descargar archivo de ejemplo del feed: Ejemplo de archivo Media JSON

Guía de Campos Media JSON

Entender cada campo asegura que tu contenido se muestre correctamente en las pantallas de EasySignage.

Estructura Raíz

Cada item

Atributos de mediaContent

Ejemplo de Entrada

{
  "title": "Video 1",
  "mediaContent": {
    "url": "https://yourdomain.com/media/video1.mp4",
    "type": "video/mp4",
    "medium": "video",
    "duration": "15",
    "changeKey": "abc123xyz456def789"
  }
}

Esta entrada mostrará video1.mp4 durante 15 segundos. El contenido se actualizará solo si la url o el changeKey cambian.

Cómo Funcionan las Actualizaciones

• El contenido se actualiza si la URL o el changeKey cambian.
• Si nada cambia, los medios no se vuelven a descargar.
• Actualiza el changeKey (ej. nuevo hash) cuando el contenido multimedia se reemplace sin cambiar su URL.

Frecuencia de Actualización

• Los feeds se verifican cada 15 minutos
• Solo los reproductores en línea con listas de reproducción activas activan las verificaciones del feed
• Los reproductores fuera de línea se actualizarán cuando se reconecten — puede tomar hasta 15 minutos

Almacenamiento de Medios

• Los archivos se descargan del feed JSON al almacenamiento en la nube
• Se sincronizan con tus reproductores para reproducción sin conexión

Tipos de Medios Compatibles

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

Cada objeto mediaContent debe incluir:

• url
• type
• medium
• duration
• changeKey (opcional, pero recomendado)

Consejos

• Mantén los feeds pequeños para una carga más rápida.
• Usa un CDN o un host rápido para los archivos multimedia.
• Siempre actualiza el changeKey cuando reemplaces archivos usando la misma URL.

¿Necesitas ayuda para configurar tu feed Media JSON? Contacta al soporte de EasySignage para obtener asistencia.