Capacitor-rich-notifications

富媒体通知 Capacitor 插件

本地通知支持 Android 通道、进度布局、操作按钮、调度和 iOS 中断级别

安装

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

指南

如何在 Capacitor 中使用富通知

使用 @capgo/capacitor-rich-notifications

本地通知与 Android 通道、进度布局、操作按钮、调度和 iOS 中断级别

安装

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

此插件暴露的内容

  • checkPermission - 检查本地通知权限状态。
  • requestPermission - 请求本地通知权限。
  • createChannel - 创建一个 Android 通知频道。
  • createChannelGroup - 创建一个 Android 通道组。
  • deleteChannel - 删除一个 Android 通知频道。
  • display - 立即显示一个本地通知。
  • schedule - 为后续显示安排一个本地通知。
  • cancel - 根据 id 取消一个通知。
  • cancelAll - 取消此插件管理的所有通知。
  • getDisplayed - 列出在阴影或中心显示的通知。
  • getPending - 列出尚未显示的预定通知。
  • getInitialNotification - 返回打开应用的通知,如果有的话。
  • setBadge - 在 iOS 设备上设置应用图标的徽章数量。
  • registerActions - 可复用动作类别的注册。
  • getPluginVersion - 返回平台实现版本标记。
  • addListener - 监听按压和dismiss事件。

- 使用示例

requestPermission - 并且 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 },
});

- 全部参考

常见问题

富媒体通知插件FAQ

如何在Capacitor应用中安装富媒体通知插件?

运行"bun add @capgo/capacitor-rich-notifications" (或"npm install @capgo/capacitor-rich-notifications"),然后运行"bunx cap sync"以便iOS和Android项目捕获native code。在应用code中从"@capgo/capacitor-rich-notifications"中导入。

是否@capgo/capacitor-rich-notifications与React、Vue和Angular兼容?

是。富媒体通知是一个Capacitor包,因此它与任何在Capacitor中运行的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

哪个Capacitor版本支持@capgo/capacitor-rich-notifications?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容版本表中可以找到支持的版本。

是否@capgo/capacitor-rich-notifications 免费且开源?

是。源码code在GitHub上公开,https://github.com/Cap-go/capacitor-rich-notifications/,并且可以从npm免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审核的情况下更新code使用Rich Notifications?

安装或升级插件会更改原生code,因此需要新建一个商店包。之后,使用Capgo实时更新的JavaScript、HTML和CSS更改可以立即部署。

不必等待应用程序审查就可以将Rich Notifications的更改推送到用户

一旦插件在您的商店中构建完成,Capgo即刻将您的JavaScript、HTML和CSS更改推送给用户

从Capgo开始