Multimedia
Imágenes, GIF, audio y video en las notificaciones, por plataforma.
Qué permite cada plataforma
| Contenido | Android | iOS |
|---|---|---|
| Imagen (JPG, PNG) | Sí, imagen grande. Sin código en la app | Sí, con Notification Service Extension |
| GIF animado | Se muestra estático (póster) | Animado (extensión) |
| Audio | No como adjunto: se abre en la app | Reproducible (extensión) |
| Video | Se muestra el póster y se abre en la app | Reproducible (extensión) |
| Icono grande | Sí (largeIcon) |
No aplica |
Subir archivos
Desde Multimedia en el panel o con POST /v1/media (multipart, campo file). PushHub procesa cada archivo: lo optimiza, genera un póster para GIF y video, y una miniatura. Cuando el estado pasa a ready, usa su mediaId:
"media": { "type": "image", "mediaId": "01J…" }
También puedes usar una URL https externa: "media": { "type": "image", "url": "https://…" }.
Límites
| Tipo | Tamaño máximo |
|---|---|
| Imagen y GIF | 10 MB |
| Audio | 5 MB (hasta 2 minutos) |
| Video | 50 MB (hasta 2 minutos) |
Además, el almacenamiento total depende de tu plan.
Recomendaciones:
- Imágenes de menos de 1 MB, en proporción 2:1 para Android.
- En iOS, la extensión tiene pocos segundos para descargar el archivo: cuanto más liviano, mejor.
iOS: la extensión
Sin una Notification Service Extension, iOS muestra la notificación sin el adjunto. Ver iOS nativo.
PushHub pone mutable-content: 1 y la URL en _ph.media.url.