Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
程序yang
unidocs-zh
提交
bab7e929
U
unidocs-zh
项目概览
程序yang
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
bab7e929
编写于
3月 09, 2022
作者:
DCloud-yyl
提交者:
DCloud_LXH
3月 11, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update unipush.md
上级
fa223681
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
31 addition
and
31 deletion
+31
-31
docs/unipush.md
docs/unipush.md
+31
-31
未找到文件。
docs/unipush.md
浏览文件 @
bab7e929
...
...
@@ -49,22 +49,22 @@ UniPush推送服务由“个推”专为DCloud订制提供技术支持,因此
## 第一步:开通UniPush推送服务
[
点此查看如何开通UniPush推送服务
](
https://ask.dcloud.net.cn/article/35716
)
[
点此查看如何开通UniPush推送服务
](
https://ask.dcloud.net.cn/article/35716
)
### Android平台支持厂商推送通道
**注意:开通UniPush后,需在后台配置“厂商推送设置”,配置好厂商参数后请一定要提交云打包,并且使用“自有证书”打签名包;将云打包后的安装包安装到手机上,再获取cid 进行离线厂商推送测试,不可使用基座方式获取的cid进行离线厂商推送测试。**
![](
https://www.dcloud.io/docs/a/unipush/s0.png
)
**注意:开通UniPush后,需在后台配置“厂商推送设置”,配置好厂商参数后请一定要提交云打包,并且使用“自有证书”打签名包;将云打包后的安装包安装到手机上,再获取cid 进行离线厂商推送测试,不可使用基座方式获取的cid进行离线厂商推送测试。**
![](
https://www.dcloud.io/docs/a/unipush/s0.png
)
获取手机厂商推送设置信息请参考:
[
厂商推送应用创建配置流程
](
https://www.dcloud.io/docs/a/unipush/manufacturer.pdf
)
### iOS平台配置推送证书
### iOS平台配置推送证书
iOS平台需要使用到苹果的APNS,务必在后台正确配置苹果推送证书,参考:
[
iOS推送证书配置
](
https://ask.dcloud.net.cn/article/35716#ios
)
## 第二步:服务端下发推送消息
## 第二步:服务端下发推送消息
<a
id=
"intent"
/>
使用厂商推送下发推送消息必须设置intent,该数据格式是Android原生Intent对象序列化由来。具体可参考
[
详情
](
https://blog.csdn.net/u011068702/article/details/51406572
)
。并且intent须符合以下格式,此格式时在个推定义额基础上二次封装,所以必须以此格式为准。不按此格式设置intent可能出现用户点击推送消息无法启动APP的问题。
intent数据格式如下:
intent数据格式如下:
```
intent://io.dcloud.unipush/?#Intent;scheme=unipush;launchFlags=0x4000000;component=io.dcloud.HBuilder/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=测试标题;S.content=测试内容;S.payload=test;end
```
...
...
@@ -73,31 +73,31 @@ intent://io.dcloud.unipush/?#Intent;scheme=unipush;launchFlags=0x4000000;compone
S.title=的值为推送消息标题,对应5+ API中
[
PushMessage
](
https://www.html5plus.org/doc/zh_cn/push.html#plus.push.PushMessage
)
对象的title属性值;
S.content=的值为推送消息内容,对应5+ API中
[
PushMessage
](
https://www.html5plus.org/doc/zh_cn/push.html#plus.push.PushMessage
)
对象的content属性值;
S.payload=的值为推送消息的数据,对应5+ API中
[
PushMessage
](
https://www.html5plus.org/doc/zh_cn/push.html#plus.push.PushMessage
)
对象的payload属性值;
**launchFlags=0x4000000字段,解决接收多条通知后点击可能无法触发click事件的问题**
**launchFlags=0x4000000字段,解决接收多条通知后点击可能无法触发click事件的问题**
注意事项:
注意事项:
-
intent格式与个推的多厂商pdf文档中描述的不一样,以此格式为准
-
intent是为了兼容Android平台的数据,但为了保持兼容性,建议iOS平台也配置此数据
-
action=android.intent.action.oppopush为固定的数据,是兼容oppo设备的离线推送功能,不需要修改
-
component=io.dcloud.HBuilder/io.dcloud.PandoraEntry中的io.dcloud.HBuilder为应用的包名,与App云端打包界面设置的Android包名一致
-
component=io.dcloud.HBuilder/io.dcloud.PandoraEntry中的io.dcloud.HBuilder为应用的包名,与App云端打包界面设置的Android包名一致
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/push/packagename.png
)
### 通过开发者中心后台Web页面发送Push消息
登录
[
DCloud开发者中心
](
https://dev.dcloud.net.cn/
)
,在“我创建的应用”列表中选择应用,左侧选择“Uni Push”,打开消息推送页面。
**tips**
推送页面改版,详情了解
[
开发者中心Unipush推送页面优化介绍
](
https://ask.dcloud.net.cn/article/36932
)
**使用厂商通道必须使用“透传消息”类型下发推送消息**
登录
[
DCloud开发者中心
](
https://dev.dcloud.net.cn/
)
,在“我创建的应用”列表中选择应用,左侧选择“Uni Push”,打开消息推送页面。
**tips**
推送页面改版,详情了解
[
开发者中心Unipush推送页面优化介绍
](
https://ask.dcloud.net.cn/article/36932
)
**使用厂商通道必须使用“透传消息”类型下发推送消息**
![](
https://www.dcloud.io/docs/a/unipush/p1.jpg
)
### 使用代码通过服务端接口推送消息
服务端集成时首先需要获取AppId、AppKey、MasterSecret参数,登录
[
DCloud开发者中心
](
https://dev.dcloud.net.cn/
)
,在“Uni Push”下的“应用配置”页面中获取,如下图所示:
服务端集成时首先需要获取AppId、AppKey、MasterSecret参数,登录
[
DCloud开发者中心
](
https://dev.dcloud.net.cn/
)
,在“Uni Push”下的“应用配置”页面中获取,如下图所示:
![
应用信息
](
https://img.cdn.aliyun.dcloud.net.cn/ask/img/UniPush/unipush-info.png
)
#### 如果使用uniCloud开发服务器
已经有封装好的易用插件负责服务器端开发,见:
[
https://ext.dcloud.net.cn/plugin?id=1680
](
https://ext.dcloud.net.cn/plugin?id=1680
)
已经有封装好的易用插件负责服务器端开发,见:
[
https://ext.dcloud.net.cn/plugin?id=1680
](
https://ext.dcloud.net.cn/plugin?id=1680
)
#### 如果使用传统服务器开发
参考“个推·消息推送”的服务端快速集成文档
[
http://docs.getui.com/
](
http://docs.getui.com/
)
参考“个推·消息推送”的服务端快速集成文档
[
http://docs.getui.com/
](
http://docs.getui.com/
)
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/push/unipush-api-getui.png
)
...
...
@@ -233,11 +233,11 @@ public class push2 {
```
**注意:把$intent变量赋值字符串中的io.dcloud.HBuilder换成自己应用的包名**
**注意:把$intent变量赋值字符串中的io.dcloud.HBuilder换成自己应用的包名**
<a
id=
"server"
/>
完整服务端厂商推送教程参考:
完整服务端厂商推送教程参考:
https://docs.getui.com/getui/server/rest_v2/common_args/
...
...
@@ -271,7 +271,7 @@ UniPush推送服务已经封装好iOS&Android平台的原生集成工作,开
默认(不设置badge参数)则角标数字不变,也可以在应用运行期调用5+ API
[
plus.runtime.setBadgeNumber
](
https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.setBadgeNumber
)
动态设置角标数字
## 注意事项
### 推送通道选择逻辑
### 推送通道选择逻辑
-
Android平台
**APP在线(个推推送通道可用)**
推送通知和透传消息都使用个推的推送通道下发推送消息。
...
...
@@ -298,17 +298,17 @@ UniPush推送服务已经封装好iOS&Android平台的原生集成工作,开
HBuilderX3.0.7 之后,华为除了配置原有的厂商信息之外,需要新增配置 agconnect-services.json文件。
该文件,需要从华为开发者后台--项目设置界面下载
该文件,需要从华为开发者后台--项目设置界面下载
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/push/huawei-apconnect-services.png
)
#### VIVO厂商通道
**需要在VIVO应用商店上线才能申请VIVO的厂商推送**
注意事项:
1.
vivo【运营消息】,一个设备一天只能收到5条离线消息
2.
vivo要求:通知文案中不能带 “包含测试、test字符”、“纯数字”、“纯表情”、“符号”或者“符号+数 字”、“表情+数字”、“表情+符号” 。
3.
1个自然日内相同文案的运营消息给同个设备发,vivo会在客户端做去重处理,导致消息不展示
4.
支持vivo推送功能HBuilderX最低版2.1.0及以上。
-
vivo【运营消息】,一个设备一天只能收到5条离线消息
-
vivo要求:通知文案中不能带 “包含测试、test字符”、“纯数字”、“纯表情”、“符号”或者“符号+数 字”、“表情+数字”、“表情+符号” 。
-
1个自然日内相同文案的运营消息给同个设备发,vivo会在客户端做去重处理,导致消息不展示
-
支持vivo推送功能HBuilderX最低版2.1.0及以上。
具体请参考图中数据
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/push/vivo-datas.png
)
...
...
@@ -318,19 +318,19 @@ HBuilderX3.0.7 之后,华为除了配置原有的厂商信息之外,需要
**需要在OPPO应用商店上线才能申请OPPO的厂商推送**
并且有以下要求:
1.
机型系统要求:oppo colorOS rom且版本号大于等于3.1
2.
检查手机通知权限是否打开,oppo是默认关闭的,将通知权限下的【Default】通道权限也打开。
3.
手机系统时间是否正常
-
机型系统要求:oppo colorOS rom且版本号大于等于3.1
-
检查手机通知权限是否打开,oppo是默认关闭的,将通知权限下的【Default】通道权限也打开。
-
手机系统时间是否正常
#### 小米厂商通道
1.
机型版本要求:小米rom且小米服务框架(包名:com.xiaomi.xmsf)版本号⼤于等于 105
2.
检查手机通知权限设置,小米有不重要通知功能,部分消息可能会存在通知栏不重要通知里
-
机型版本要求:小米rom且小米服务框架(包名:com.xiaomi.xmsf)版本号⼤于等于 105
-
检查手机通知权限设置,小米有不重要通知功能,部分消息可能会存在通知栏不重要通知里
#### 魅族厂商通道
1.
机型版本要求:魅族rom且魅族rom版本⼤于等于5.x
2.
检查消息是否存入了魅族手机右上角【魅族消息盒子】中
3.
清除缓存:魅族手机在设置 ---> 应用管理 ---> 所有应用 ---> 推送服务 ,点击里面的清除数据,然后再重新安装一下应用。
-
机型版本要求:魅族rom且魅族rom版本⼤于等于5.x
-
检查消息是否存入了魅族手机右上角【魅族消息盒子】中
-
清除缓存:魅族手机在设置 ---> 应用管理 ---> 所有应用 ---> 推送服务 ,点击里面的清除数据,然后再重新安装一下应用。
#### 谷歌FCM通道
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录