---
title: "EasySignage - Guía de Integración Media JSON"
description: "Automatiza el contenido de tus pantallas usando feeds Media JSON. Aprende cómo conectar feeds externos de imágenes y videos con EasySignage para actualizaciones programadas sin interrupciones."
url: https://easysignage.com/help/es/apps/digital-signage-media-json/
---

# 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:

```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: `https://files.cloud-digitalsignage.com/media-json/media-json.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

| Campo | Requerido | Descripción |
| --- | --- | --- |
| `channel` | ✅ | Contenedor para todos los elementos del feed |
| `items` | ✅ | Array de entradas multimedia |

* * *

### Cada `item`

| Campo | Requerido | Descripción |
| --- | --- | --- |
| `title` | ✅ | Título del elemento multimedia |
| `mediaContent` | ✅ | Objeto que contiene los detalles del archivo multimedia |

* * *

### Atributos de `mediaContent`

| Atributo | Requerido | Descripción |
| --- | --- | --- |
| `url` | ✅ | URL HTTPS directa al archivo multimedia |
| `type` | ✅ | Tipo MIME, ej. `image/jpeg` o `video/mp4` |
| `medium` | ✅ | `image` o `video` |
| `duration` | ✅ | Duración de visualización en segundos |
| `changeKey` | ❌ (Recomendado) | Identificador único (ej. hash MD5) que fuerza la actualización si el contenido cambia en la misma URL |

* * *

## Ejemplo de Entrada

```json
{
  "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.

[Anterior ##### Generador de Códigos QR](https://easysignage.com/help/es/apps/digital-signage-qr-code/)

[Siguiente ##### Integración MRSS](https://easysignage.com/help/es/apps/digital-signage-mrss/)