Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
aca31d13
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3178
Star
105
Fork
805
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
68
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
68
合并请求
68
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
aca31d13
编写于
11月 20, 2023
作者:
taohebin@dcloud.io
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update push.md
上级
7540752f
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
18 addition
and
1 deletion
+18
-1
docs/uni-app-x/api/push.md
docs/uni-app-x/api/push.md
+18
-1
未找到文件。
docs/uni-app-x/api/push.md
浏览文件 @
aca31d13
...
...
@@ -28,6 +28,10 @@ uni-push是DCloud与合作伙伴共同推出的统一推送服务。该业务的
<!-- UTSAPIJSON.onPushMessage.tutorial -->
## 注意事项
*
如果多次监听
`onPushMessage`
,那么事件也会多次触发,所以当不需要监听的时候需要
`offPushMessage`
。
## uni.offPushMessage(callback) @offpushmessage
<!-- UTSAPIJSON.offPushMessage.description -->
...
...
@@ -54,8 +58,20 @@ uni-push是DCloud与合作伙伴共同推出的统一推送服务。该业务的
## 注意事项
*
由于各大厂商限制推送频次,当使用厂商离线推送的时,需要在不同品牌手机后台开通自分类权益,
[
限制数量说明
](
https://docs.getui.com/getui/mobile/vendor/qps/
)
-
[
华为
](
https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/message-classification-0000001149358835
)
-
[
小米
](
https://dev.mi.com/console/doc/detail?pId=2422
)
-
[
oppo
](
https://open.oppomobile.com/new/developmentDoc/info?id=11227
)
-
[
vivo
](
https://dev.vivo.com.cn/documentCenter/doc/359
)
开通自分类权益后,需要客户端创建channel,因此客户端提供了
`setPushChannel`
来进行channel的创建,通过此Api来创建渠道进行推送。
客户端创建渠道成功后,即可通过云函数进行推送,
[
uni-push2服务端文档
](
https://uniapp.dcloud.net.cn/uniCloud/uni-cloud-push/api.html
)
。
*
由于Android通知渠道的机制问题,一旦通知渠道建立,便不能修改此渠道的配置,即使删除渠道后再次创建同channelId名称的渠道,也不会改变原先渠道的配置(除非删除应用),最明显的现象就是铃声动态修改失败,比如调用
`setPushChannel`
时,第一次的设置参数是
`{"channelId":"test","soundName":"pushsound"}`
, 这时你想切换铃音,你的channelId就不能再叫test了,而应该为
`{"channelId":"test2","soundName":"ring"}`
,此时会新建一个渠道。
## uni.createPushMessage(options) @createpushmessage
<!-- UTSAPIJSON.createPushMessage.description -->
...
...
@@ -114,4 +130,5 @@ uni-push是DCloud与合作伙伴共同推出的统一推送服务。该业务的
*
uni-app x 的push模块仅支持uni-push2,不再支持uni-push1。但这不意味着强绑uniCloud的付费行为。而是DCloud的所有云服务都将统一纳入到uniCloud体系管理,开发者在开通uni-push2后,也可以拿到mastersecret,然后在自己的服务器去直接连接个推服务器。
*
uni-push是一个独立的模块,在标准基座中并不包含。开发push需要首先编写push相关代码,然后打包自定义基座,根据摇树规则,打出的自定义基座才会包含push模块。详见
[
摇树
](
../manifest.md#treeShaking
)
*
创建本地通知栏,理论上可以和个推的服务无关。但目前也都包含在push模块里了。如果您不需要服务器推送,只需要本地创建通知栏,也需要打包push模块才行。
*
hello uni-push是可跑通的参考代码。
[
https://gitcode.net/dcloud/hello-uni-push
](
https://gitcode.net/dcloud/hello-uni-push
)
\ No newline at end of file
*
hello uni-push是可跑通的参考代码。
[
https://gitcode.net/dcloud/hello-uni-push
](
https://gitcode.net/dcloud/hello-uni-push
)
*
部分手机创建本地通知时,App如果在后台状态,点击通知消息并不会拉起App,原因是厂商增加了后台弹窗权限,需要用户手动打开此权限。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录