未验证 提交 4ece19fb 编写于 作者: DCloud_JSON's avatar DCloud_JSON 提交者: Gitee

update docs/uniCloud/uni-cloud-push/api.md.

上级 ea85f066
......@@ -167,9 +167,11 @@ uni-push产品有2个入口:
#### 在线推送@online
当应用在线时,不会创建“通知栏消息”,此时客户端会立即监听到消息内容。
如果业务逻辑上需要创建“通知栏消息”来提醒用户;可以在监听到消息内容后,使用创建本地消息API [plus.push.createMessage](https://www.html5plus.org/doc/zh_cn/push.html#plus.push.createMessage)手动创建通知栏消息。
如果你希望当应用在线时,也通过“通知栏消息”来提醒用户;可以通过以下两种方式实现:
1. 监听到消息内容后,根据业务需要自己判断是否要创建“通知栏消息”,需要就调用创建本地消息API [uni.createPushMessage](https://uniapp.dcloud.io/api/plugins/push.html#createpushmessage)手动创建通知栏消息。
2. 服务端执行推送时,传递参数`force_notification:true`,客户端就会自动创建“通知栏消息”(此时你监听不到消息内容),当用户点击通知栏消息后,APP才能监听到消息内容。
> 注意:在ios设备,创建通知栏需要权限;推荐使用[navite.js权限管理插件](https://ext.dcloud.net.cn/plugin?id=594),判断或取得权限后再调用;后续官方会封装api内置此逻辑
以上两种方案各有优劣,方案1更加灵活;比如:客服功能,客户端接收到聊天消息时,应用如果已经打开聊天对话框,就直接将监听到的推送内容,渲染到页面。如果应用未打开聊天页面,则调用api创建“通知栏消息”提醒用户;此时你还可以执行一些其他逻辑,比如将tabBar的消息中心加红点等。方案2比较简便,客户端无需额外编写代码,自动插件通知栏消息;但仅适用于客户端一定要创建“通知栏消息”的场景,如广告营销内容推送
### 客户端启用uniPush2.0
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册