跳过主要内容

富媒体通知 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 },
});

全局参考

常见问题

富媒体通知插件常见问题

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

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

是否@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请求。

code 使用 Rich Notifications 是否可以在 App Store 评论中更新?

安装或升级插件会更改本机 code,因此需要新建商店。之后,JavaScript、HTML 和 CSS 调用插件的更改可以立即通过 Capgo 实时更新。

不必等待应用程序审查

在您的商店构建中安装插件后,Capgo即刻推送您的JavaScript、HTML和CSS更改到用户中。

使用Capgo