Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
aa8a8bbd
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
aa8a8bbd
编写于
11月 22, 2024
作者:
DCloud_JSON
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update push补充说明Harmony支持的category值
上级
db78bf8e
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
15 addition
and
15 deletion
+15
-15
docs/api/plugins/push.md
docs/api/plugins/push.md
+15
-15
未找到文件。
docs/api/plugins/push.md
浏览文件 @
aa8a8bbd
...
...
@@ -191,21 +191,21 @@ manager.setPushChannel({
**OBJECT 参数说明**
|参数名 |类型
|必填 |说明
|
|:-
|:- |:- |:-
|
|title |string
|否 |推送消息的标题,在系统消息中心显示的通知消息标题,默认值为程序的名称。
</br>
Android - ALL (支持)
</br>
iOS - 5.0+ (不支持): 不支持设置消息的标题,固定为程序的名称。
|
|content |string
|是 |消息显示的内容,在系统通知中心中显示的文本内容。
|
|payload |string、Object |否 |消息承载的数据,可根据业务逻辑自定义数据格式。 |
|icon
|string |否 |推送消息的图标
</br>
本地图片地址,相对路径 - 相对于当前页面的host位置,如"a.jpg",注意当前页面为网络地址则不支持; 绝对路径 - 系统绝对路径,如Android平台"/sdcard/logo.png",此类路径通常通过其它5+ API获取的; 扩展相对路径URL(RelativeURL) - 以"_"开头的相对路径,如"_www/a.jpg"; 本地路径URL - 以“file://”开头,后面跟随系统绝对路径。
</br>
Android - 2.3+ (支持)
</br>
iOS
- ALL (不支持): 不支持自定义图片,固定使用应用图标。 |
|sound |string
|否 |显示消息时播放的提示音;
</br>
可取值:
`system`
表示使用系统通知提示音,
`none`
表示不使用提示音;(默认值为system)。
</br>
注意:当程序在前台运行时,提示音不生效。 注:通常应该设置延迟时间,当程序切换到后台才创建本地推送消息时生效
</br>
支持的版本:Android 2.3+,iOS - 5.1+。
|
|cover |boolean
|否 |是否覆盖上一次提示的消息
</br>
可取值:
`true`
或
`false`
,true为覆盖,false不覆盖,默认为permission中设置的cover值
</br>
Android - ALL (支持)
</br>
iOS - 5.0+ (不支持): 不支持覆盖消息,只能创建新的消息。
|
|delay |number
|否 |提示消息延迟显示的时间
</br>
当设备接收到推送消息后,可不立即显示,而是延迟一段时间显示,延迟时间单位为s,默认为0s,立即显示。
|
|when
|Date |否 |消息上显示的提示时间
</br>
默认为当前时间,如果延迟显示则使用延时后显示消息的时间。
</br>
Android - ALL (支持)
</br>
iOS - 5.0+ (不支持): 不支持设定消息的显示时间,由系统自动管理消息的创建时间。
|
|channelId
|string |否 |渠道id, 支持的版本:HBuilder X 4.02+
|
|category |string
|否 |通知类别,支持的版本:HBuilder X 4.02+
|
|success |Function
|否 |接口调用成功的回调函数
|
|fail
|Function |否 |接口调用失败的回调函数
|
|complete |Function
|否 |接口调用结束的回调函数(调用成功、失败都会执行)
|参数名 |类型
|必填 |说明
|
|:-
|:- |:- |:-
|
|title |string
|否 |推送消息的标题,在系统消息中心显示的通知消息标题,默认值为程序的名称。
</br>
Android和Harmony - ALL (支持)
</br>
iOS - 5.0+ (不支持): 不支持设置消息的标题,固定为程序的名称。
|
|content |string
|是 |消息显示的内容,在系统通知中心中显示的文本内容。
|
|payload |string、Object |否 |消息承载的数据,可根据业务逻辑自定义数据格式。
|
|icon
|string |否 |推送消息的图标
</br>
本地图片地址,相对路径 - 相对于当前页面的host位置,如"a.jpg",注意当前页面为网络地址则不支持; 绝对路径 - 系统绝对路径,如Android平台"/sdcard/logo.png",此类路径通常通过其它5+ API获取的; 扩展相对路径URL(RelativeURL) - 以"_"开头的相对路径,如"_www/a.jpg"; 本地路径URL - 以“file://”开头,后面跟随系统绝对路径。
</br>
Android - 2.3+ (支持)
</br>
iOS和Harmony
- ALL (不支持): 不支持自定义图片,固定使用应用图标。 |
|sound |string
|否 |显示消息时播放的提示音;
</br>
可取值:
`system`
表示使用系统通知提示音,
`none`
表示不使用提示音;(默认值为system)。
</br>
注意:当程序在前台运行时,提示音不生效。 注:通常应该设置延迟时间,当程序切换到后台才创建本地推送消息时生效
</br>
支持的版本:Android 2.3+,iOS - 5.1+。Harmony - ALL (不支持)
|
|cover |boolean
|否 |是否覆盖上一次提示的消息
</br>
可取值:
`true`
或
`false`
,true为覆盖,false不覆盖,默认为permission中设置的cover值
</br>
Android - ALL (支持)
</br>
iOS - 5.0+ (不支持): 不支持覆盖消息,只能创建新的消息。
</br>
Harmony - ALL (不支持)
|
|delay |number
|否 |提示消息延迟显示的时间
</br>
当设备接收到推送消息后,可不立即显示,而是延迟一段时间显示,延迟时间单位为s,默认为0s,立即显示。
</br>
Harmony - ALL (不支持)
|
|when
|Date |否 |消息上显示的提示时间
</br>
默认为当前时间,如果延迟显示则使用延时后显示消息的时间。
</br>
Android (支持)
</br>
iOS - 5.0+ 和 Harmony - ALL (不支持): 不支持设定消息的显示时间,由系统自动管理消息的创建时间。
|
|channelId
|string |否 |渠道id, 支持的版本:HBuilder X 4.02+ ,Harmony - ALL (不支持)
|
|category |string
|否 |通知类别,支持的版本:HBuilder X 4.02+ ,Harmony支持的category值
[
详情查看
](
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/notification-slot-V5#通知渠道类型说明
)
|
|success |Function
|否 |接口调用成功的回调函数
|
|fail
|Function |否 |接口调用失败的回调函数
|
|complete |Function
|否 |接口调用结束的回调函数(调用成功、失败都会执行) |
**其他相关资源**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录