跳到主要内容

本地通知

本地通知指应用在前台或后台运行时,由应用客户端直接调用系统接口创建并发送的通知(Notification)。RCUIKit 内部已实现本地通知功能 (Notification),当应用处于前台或后台运行状态并接收到新消息时,RCUIKit 默认会在通知中心弹出通知提醒,即本地通知。

注意

本地通知仅 Android 和 iOS 平台支持,小程序、H5 平台不支持。

初始化通知

在使用本地通知功能前,需要先进行初始化,建议在 App.vue 中进行初始化,NotificationManager.getInstance() 方法支持传入 NotificationConfig 配置对象,用于控制通知的显示行为。

参数类型必填默认值说明
disableInCurrentChatbooleanfalse通知消息为当前会话页面时,是否禁用通知
disableInConversationListbooleanfalse当前页面为会话列表页面时,是否禁用通知
typescript
import { NotificationManager } from '@/RCUIKit/utils/notification';

// 获取本地通知实例,并挂在到 uni 实例上
uni.$NotificationManager = NotificationManager.getInstance();

发送本地通知

typescript
const id = message.messageUId; // 消息的 Uid
uni.$NotificationManager.createNotification(id, {
title: '测试通知',
content: '这是一条测试通知',
});