手册阅读须知:本手册仅针对JONLUN多店版-商户端APP
介绍
JooLun商户 APP 消息推送功能
注意:消息推送仅支持商户端 App,商城端暂时不支持。如需要可自行参考商户端进行开发。
- 目前能够进行客服消息和订单消息推送
- 测试:在 iOS 或 安卓登录客服账号发送消息或对应店铺下单即可收到消息
- 注意:目前安卓必须上架到应用市场才能使用相应厂商的离线消息推送功能,如需要请自行上架对应市场后在uniapp后台配置即可
- 注意:请确保手机的应用打开了通知提醒权限
概述
- 使用 uniapp 的
unipush1.0进行消息推送,unipush1.0使用的是 个推 的消息推送。 - 目前能够配合 OpenIM 进行客服消息推送
- 各厂商的离线推送,需要自行申请对接 厂商推送设置
- 个推文档
- UniPush1.0文档
- 说明:因为 UniPush2.0 没有个推的 MasterSecret 值,而该值在 openIM 所必需,所以只能接入 UniPush1.0
- 个推消息推送获取不到说明文档
使用
1.App开通Unipush1.0功能
建议请直接参考 UniPush官方开通指南
- 首先点击项目文件 【
joolun-plus-app/manifest.json】 - 【App模块配置】 - 勾选【Push(消息推送)】和【uniPush 1.0】,uniPush推送小图标配置也建议进行配置
- 进入 UniDClound 后台进行应用配置,该步骤可参考 unipush的文档。具体在
UniDClound平台的步骤:- 点击菜单【uniPush】-【1.0(老版本)】-【应用信息】按提示的文档完善
- 需要配置正确应用的
Android 包名Android 应用签名 - 如有不会开通,请查询官方文档,官方文档有很详细的开通说明
2.iOS推送需要证书支持推送功能
3.获取个推AppID/AppKey/AppSecret/MasterSecret
提示:这些是在后台配置使用,前端无需关注
- 进入 UniDClound 后台进行消息推送,点击菜单【uniPush】-【1.0(老版本)】-【消息推送】会显示个推的消息推送页面。
- 在当前页面中【配置管理】-【应用配置】菜单中可查询到AppID/AppKey/AppSecret/MasterSecret
注意:如果该步骤没有页面显示,那么检查所选择的应用是否正确,或者在第一步中没有完善好应用信息。 - nacos中配置
- openIM配置
config/config.yaml
getui: #个推推送
pushUrl: "https://restapi.getui.com/v2/PZvsu5jVry5JPMwetwg5Q"
masterSecret: "qtC1HCxRXLetwetrBUaO82"
appKey: "4vNGi6o1rF888cQuwtew96"
intent: "launchFlags=0x10000000;action=android.intent.action.gtpush;package=com.cn.JooLunPlus.ShopApp;"
enable: true
channelID: "Push"
channelName: "Push"
pushUrl、masterSecret、appKey填写自己的实际信息,intent里的package是你app打包的包名
其他说明
JooLun新开发了两个接口:
- cid是否绑定别名查询接口
根据当前设备cid查询的别名与当前登录人不相符就进行调用绑定接口进行绑定操作 - cid绑定别名接口
绑定 cid
注意:重复绑定别名以最后一次为准,同一个 cid 绑定接口调用的间隔需大于 1 s,客户端单个设备每天限制调用 100 次。
一个 cid 只支持绑定一个别名,,一个别名至多绑定 10 个 cid 。
