跳到主要内容

本地通知

本地通知是应用客户端在收到实时消息后,直接调用系统接口创建的 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: '这是一条测试通知',
});