提交 2586672a 编写于 作者: taohebin@dcloud.io's avatar taohebin@dcloud.io

update: push.md

上级 0c90173d
...@@ -50,7 +50,7 @@ ...@@ -50,7 +50,7 @@
``` ```
### uni.onPushMessage(callback)@onPushMessage ### uni.onPushMessage(callback)@onpushmessage
启动监听推送消息事件 启动监听推送消息事件
代码示例: 代码示例:
```js ```js
...@@ -80,7 +80,7 @@ uni.offPushMessage(callback); ...@@ -80,7 +80,7 @@ uni.offPushMessage(callback);
- 如果uni.offPushMessage没有传入参数,则移除App级别的所有事件监听器; - 如果uni.offPushMessage没有传入参数,则移除App级别的所有事件监听器;
- 如果只提供了事件名(callback),则移除该事件名对应的所有监听器; - 如果只提供了事件名(callback),则移除该事件名对应的所有监听器;
### uni.getChannelManager()@getChannelManager ### uni.getChannelManager()@getchannelmanager
获取通知渠道管理器,Android 8系统以上才可以设置通知渠道。 获取通知渠道管理器,Android 8系统以上才可以设置通知渠道。
...@@ -88,7 +88,7 @@ uni.offPushMessage(callback); ...@@ -88,7 +88,7 @@ uni.offPushMessage(callback);
|类型| |类型|
|:-| |:-|
|[ChannelManager](#ChannelManager)| |[ChannelManager](#channelmanager)|
#### getChannelManager兼容性 #### getChannelManager兼容性
...@@ -106,7 +106,7 @@ uni.offPushMessage(callback); ...@@ -106,7 +106,7 @@ uni.offPushMessage(callback);
|名称|类型|必填| |名称|类型|必填|
|:-|:-|:-| |:-|:-|:-|
|options|[SetPushChannelOptions](#SetPushChannelOptions)|是| |options|[SetPushChannelOptions](#setpushchanneloptions)|是|
##### SetPushChannelOptions 的属性值 ##### SetPushChannelOptions 的属性值
...@@ -125,11 +125,11 @@ uni.offPushMessage(callback); ...@@ -125,11 +125,11 @@ uni.offPushMessage(callback);
```typescript ```typescript
const manager = uni.getChannelManager() const manager = uni.getChannelManager()
manager.setPushChannel({ manager.setPushChannel({
channelId: "xxx", channelId: "xxx",
channelDesc: "通知渠道描述", channelDesc: "通知渠道描述",
soundName: "pushsound" // 已经把声音文件存储到/res/raw/pushsound.mp3 soundName: "pushsound" // 已经把声音文件存储到/res/raw/pushsound.mp3
}) })
``` ```
...@@ -163,7 +163,7 @@ manager.setPushChannel({ ...@@ -163,7 +163,7 @@ manager.setPushChannel({
* 离线推送申请自分类权益时,需要客户端创建channel,因此客户端提供了`setPushChannel`来进行channel的创建,通过此Api来创建渠道进行推送。客户端创建渠道成功后,即可通过云函数进行推送,[uni-push2服务端文档](https://doc.dcloud.net.cn/uniCloud/uni-cloud-push/api.html) * 离线推送申请自分类权益时,需要客户端创建channel,因此客户端提供了`setPushChannel`来进行channel的创建,通过此Api来创建渠道进行推送。客户端创建渠道成功后,即可通过云函数进行推送,[uni-push2服务端文档](https://doc.dcloud.net.cn/uniCloud/uni-cloud-push/api.html)
* 由于Android通知渠道的机制问题,一旦通知渠道建立,便不能修改此渠道的配置,即使删除渠道后再次创建同channelId名称的渠道,也不会改变原先渠道的配置(除非删除应用),最明显的现象就是铃声动态修改失败,比如调用`setPushChannel`时,第一次的设置参数是`{"channelId":"test","soundName":"pushsound"}` , 这时你想切换铃音,你的channelId就不能再叫test了,而应该为`{"channelId":"test2","soundName":"ring"}` ,此时会新建一个渠道。 * 由于Android通知渠道的机制问题,一旦通知渠道建立,便不能修改此渠道的配置,即使删除渠道后再次创建同channelId名称的渠道,也不会改变原先渠道的配置(除非删除应用),最明显的现象就是铃声动态修改失败,比如调用`setPushChannel`时,第一次的设置参数是`{"channelId":"test","soundName":"pushsound"}` , 这时你想切换铃音,你的channelId就不能再叫test了,而应该为`{"channelId":"test2","soundName":"ring"}` ,此时会新建一个渠道。
### uni.createPushMessage(OBJECT)@createPushMessage ### uni.createPushMessage(OBJECT)@createpushmessage
创建本地通知栏消息(HBuilderX 3.5.2起支持) 创建本地通知栏消息(HBuilderX 3.5.2起支持)
**平台差异说明** **平台差异说明**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册