uni-app如何配置App端的极光推送分类通道并实现精准送达

云敏姑娘_7491

云敏姑娘_7491

2026-07-16

291人浏览

原创

极光推送在uni-app中需服务端指定通道标识并配合客户端预配置才能实现消息分类管理。android须在manifest.json注册notificationchannel并声明权限,ios需在控制台配置unnotificationcategory并在客户端注册,否则无法实现独立开关和正确展示。

uni-app如何配置app端的极光推送分类通道并实现精准送达

极光推送在uni-app中默认走统一通道,但实际业务中必须区分“运营消息”“系统通知”“客服消息”等类型——否则用户会因消息泛滥关闭通知权限。分类通道不是靠前端代码控制的,而是由服务端调用极光API时指定android_channel_id或iOS的category,再配合客户端预注册通道配置才能生效。没配通道ID或没在manifest里声明,推送过来就是普通通知,系统无法归类、也无法设置独立开关。

Android端必须提前在manifest.json里注册通知渠道

Android 8.0+强制要求每个通知必须归属一个NotificationChannel,否则静默失败。uni-app不自动创建,得手动填。

  • manifest.json的"permissions"节点下,确保已添加"android.permission.POST_NOTIFICATIONS"(Android 13+必需)
  • 在"nativePlugins" > "JG-JPush" > "android"里,加"JPUSH_ANDROID_CHANNEL_ID"字段,值为自定义渠道ID(如"channel_system")
  • 同时必须在"android"对象内补充"JPUSH_ANDROID_CHANNEL_NAME"和"JPUSH_ANDROID_CHANNEL_DESCRIPTION",否则部分厂商(如小米)会拒绝创建渠道
  • 渠道ID一旦上线就不能改名,否则旧设备上会残留废弃渠道,新消息可能进错入口

iOS端需在极光控制台配置category并同步到客户端

iOS没有“渠道”概念,但有UNNotificationCategory,它决定通知上的按钮、是否允许横滑、是否触发后台唤醒等行为。这个category必须和服务端推送时传的category字段严格一致,否则按钮不显示。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • 登录极光控制台 → 应用设置 → iOS高级设置 → 添加Notification Category,比如填"order_alert"
  • 在manifest.json的"ios"配置块中,加入"JPUSH_IOS_CATEGORY",值与控制台一致(如"order_alert")
  • App首次启动时,需调用jpushModule.requestNotificationAuthorization并传入categories参数,否则系统不识别该category
  • 注意:iOS 15+对category数量有限制(最多25个),别为每个子类型都建一个

服务端推送时必须显式指定通道标识

前端只负责注册和监听,真正分流靠服务端发请求时带参数。漏掉任何一项,分类就失效。

  • Android:HTTP API中必须带android_channel_id字段,值要和manifest.json里写的JPUSH_ANDROID_CHANNEL_ID完全一致(大小写敏感)
  • iOS:API中必须带ios_category字段,值要和极光控制台创建的category名称一致
  • 如果用极光控制台手动推送测试,务必在“高级设置”里展开填写对应字段,网页版默认不显示这些选项
  • 别依赖extras字段做分类判断——系统级通道控制发生在通知展示前,extras只影响点击后逻辑

用户通知权限开关是按通道独立管理的

这是分类通道最核心的价值:用户可以单独关闭“营销消息”,但保留“订单提醒”。但这个能力只有在通道真实生效后才起作用。

  • Android用户长按通知 → “设置” → 能看到每个channel_name对应的开关,名字来自JPUSH_ANDROID_CHANNEL_NAME
  • iOS用户进入「设置」→「你的App」→「通知」→ 每个category会显示为独立条目(前提是category已正确注册且推送时指定了)
  • 测试时务必用真机,模拟器无法触发完整通知链路;华为/小米手机还要额外检查“省电管理”里是否禁用了该通道的自启动
  • 用户关闭某通道后,jpushModule.isNotificationEnabled返回的仍是全局状态,无法感知单个通道,得靠服务端记录用户偏好来规避推送

通道ID和category名称一旦上线就锁死,改名等于新建通道,老用户不会自动迁移。别图省事全用同一个ID,也别在测试环境用生产ID——不同环境的极光AppKey对应不同通道命名空间,混用会导致渠道创建失败或通知乱入。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

uni-app uni-app配置

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2463

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5303

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6350

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5938

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

843

5

Python uv使用教程
Python uv使用教程

本专题汇总了 Python uv 使用教程与高效使用指南,从 uv 安装配置、常用命令到虚拟环境、依赖管理与项目打包,系统讲解如何用 uv 替代 pip 与 poetry,全面提升 Python 项目开发效率,助你快速上手这一现代化包管理工具,打造干净高效的 Python 工作流。

2026.10.15

0

15

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习