UniApp消息提醒无法在锁屏或后台正常显示通知声音和图标 badge 更新问题

Question

在UniApp开发中，消息提醒在锁屏或后台时通知声音无法播放、图标 badge 未更新是常见问题。主要原因可能涉及权限设置不足、配置文件（如 `manifest.json`）未正确配置推送服务或 iOS/Android 系统特性限制。例如，iOS 需要显式申请通知权限并配置 APNs，而 Android 则需检查是否正确集成了华为、小米等厂商的推送通道。此外，锁屏或后台运行受限可能导致 badge 更新失败，需要通过系统 API 或第三方 SDK 实现强制刷新。建议开发者逐一排查推送服务集成、权限声明以及平台特有配置，确保消息提醒功能在不同场景下稳定工作。

Answer 1

1. 问题概述

在UniApp开发中，消息提醒功能是一个常见需求，但在锁屏或后台运行时，通知声音无法播放、图标 badge 未更新的问题尤为突出。这类问题的根源可能涉及权限设置不足、配置文件（如 `manifest.json`）未正确配置推送服务，或者 iOS/Android 系统特性限制。

• iOS 需要显式申请通知权限并配置 APNs。
• Android 则需检查是否正确集成了华为、小米等厂商的推送通道。
• 锁屏或后台运行受限可能导致 badge 更新失败。

开发者需要逐一排查推送服务集成、权限声明以及平台特有配置，确保消息提醒功能在不同场景下稳定工作。

2. 常见技术问题分析

以下是 UniApp 开发中常见的消息提醒问题及其可能原因：

问题描述	可能原因
锁屏时通知声音无法播放	权限未正确申请，或系统限制了后台运行能力。
图标 badge 未更新	badge 更新逻辑未正确实现，或未调用系统 API 实现强制刷新。
推送服务未生效	`manifest.json` 配置错误，或未正确集成第三方推送 SDK。

通过表格可以看出，这些问题的解决需要从多个角度入手。

3. 解决方案与实现步骤

以下是针对上述问题的解决方案和实现步骤：

1. 权限设置：确保在 `manifest.json` 中正确声明推送相关权限。例如，在 Android 平台中添加以下权限：

"permissions": [
    "notification",
    "push"
]

同时，iOS 需要在应用启动时显式请求通知权限，并确保已配置 APNs。

1. 推送服务集成：根据目标平台选择合适的推送服务。例如，Android 可使用 Firebase Cloud Messaging (FCM)，而国内厂商设备则需集成华为、小米等推送通道。

以下为 FCM 推送服务的集成示例：

uni.request({
    url: 'https://fcm.googleapis.com/fcm/send',
    method: 'POST',
    header: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_SERVER_KEY'
    },
    data: {
        to: 'DEVICE_TOKEN',
        notification: {
            title: '新消息',
            body: '您有一条新消息！'
        }
    }
});

1. badge 更新实现：在 iOS 平台上，可以通过调用系统 API 实现 badge 更新。以下为 badge 更新的伪代码：

if (plus.runtime.isApplicationForeground()) {
    // 应用在前台
    plus.push.createMessage('新消息内容', '', { badge: 1 });
} else {
    // 应用在后台或锁屏
    plus.push.setBadgeNumber(1);
}

对于 Android 平台，badge 更新通常依赖于第三方库或系统特定实现。

4. 流程图说明

以下是解决 UniApp 消息提醒问题的整体流程图：

graph TD;
            A[开始] --> B{检查权限};
            B --权限不足--> C[申请权限];
            B --权限正常--> D{检查推送服务};
            D --未集成--> E[集成推送服务];
            D --已集成--> F{检查 badge 更新};
            F --未实现--> G[实现 badge 更新];
            F --已实现--> H[测试功能];

此流程图展示了从权限检查到功能测试的完整过程。