Saltar al contenido principal
@capgo/capacitor-rich-notifications Comunicación Código abierto

Notificaciones enriquecidas plugin Capacitor

Notificaciones locales con canales de Android, layouts de progreso, botones de acción, programación y niveles de interrupción en iOS

Instalar

bun add @capgo/capacitor-rich-notifications bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-rich-notifications
  • pnpm add @capgo/capacitor-rich-notifications
  • yarn add @capgo/capacitor-rich-notifications

Guía

Cómo usar Rich Notifications en Capacitor

Uso de @capgo/capacitor-rich-notifications

Notificaciones locales con canales de Android, layouts de progreso, botones de acción, programación y niveles de interrupción de iOS.

Instalar

bun add @capgo/capacitor-rich-notifications
bunx cap sync

Lo que expone este plugin

  • checkPermission - Verificar el estado del permiso de notificaciones locales.
  • requestPermission - Solicitar el permiso de notificaciones locales.
  • createChannel - Crear un canal de notificaciones de Android.
  • createChannelGroup - Crear un grupo de canales de Android.
  • deleteChannel - Eliminar un canal de notificaciones de Android.
  • display - Mostrar una notificación local de inmediato.
  • schedule - Programar una notificación local para más tarde.
  • cancel - Cancelar una notificación por id.
  • cancelAll - Cancelar todas las notificaciones gestionadas por este plugin.
  • getDisplayed - Listar las notificaciones mostradas en la bandeja o el centro.
  • getPending - Lista las notificaciones programadas que aún no se han mostrado.
  • getInitialNotification - Devolver la notificación que abrió la app, si la hay.
  • setBadge - Establece el contador de insignias de la app en iOS.
  • registerActions - Registra una categoría de acción reutilizable.
  • getPluginVersion - Devuelve el marcador de versión de la implementación de la plataforma.
  • addListener - Escucha los eventos de pulsación y descarte.

Ejemplo de uso

requestPermission y display

import { RichNotifications } from '@capgo/capacitor-rich-notifications';

await RichNotifications.requestPermission();

await RichNotifications.createChannel({
  id: 'messages',
  name: 'Messages',
  importance: 'high',
});

await RichNotifications.display({
  title: 'Hello',
  body: 'Tap to open the app',
  channelId: 'messages',
});

schedule

import { RichNotifications } from '@capgo/capacitor-rich-notifications';

await RichNotifications.schedule({
  notification: {
    id: 'reminder-1',
    title: 'Reminder',
    body: 'Your appointment starts soon',
    channelId: 'messages',
  },
  trigger: { type: 'timestamp', timestamp: Date.now() + 60_000 },
});

Referencia completa

FAQ

FAQ del plugin Rich Notifications

¿Cómo instalo el plugin Rich Notifications en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-rich-notifications" (o "npm install @capgo/capacitor-rich-notifications") y luego "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-rich-notifications" en tu code.

¿Es compatible @capgo/capacitor-rich-notifications con React, Vue y Angular?

Sí. Rich Notifications es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-rich-notifications?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-rich-notifications gratuito y de código abierto?

Sí. El code de código abierto es público en GitHub en https://github.com/Cap-go/capacitor-rich-notifications/ y el paquete se puede instalar gratis desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa Rich Notifications sin una revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios en Rich Notifications sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo