Skip to content

U
unidocs-unicloud-zh

DCloud / unidocs-unicloud-zh

通知 84
Star 2
Fork 20
U
unidocs-unicloud-zh
提交 60085a0d 编写于 作者: DCloud_JSON's avatar DCloud_JSON
浏览文件
操作

update docs/uni-cloud-push/options.md

上级 300eaf20
显示空白变更内容
内联 并排
Showing with 25 addition and 756 deletion
docs/uni-cloud-push/options.md
浏览文件 @ 60085a0d
> 需要HBuilderX 3.5.1 及其以上版本支持
options 更多参数配置
options 参数主要用于实现部分厂商支持但不常用的功能。详情查看：[https://docs.getui.com/getui/server/rest_v2/third_party/](https://docs.getui.com/getui/server/rest_v2/third_party/)
## 简述
由于各手机厂商特定推送参数支持不统一，uniPush为了降低开发者的接入成本，提供一致的推送API。
以下两种需求，可以在`options`参数传入参数实现。
1. 如果开发者希望在不同的厂商手机端，实现不同的效果；
例子:你希望实现在**iOS**和**华为**两款手机，收到消息后的角标变化分别为:在原值上**-1**和**+1**两种效果
options 配置示例如下：
```json
"options": {
"IOS":{
"auto_badge":"-1",
需注意，个推文档中的示例代码与在 uni-push 中的使用存在差异。个推代码示例如下：
```js
{
"android":{
"ups":{
"notification":{
// ...其他push_channel参数略
},
"HW": {
"/message/android/notification/badge/class": "io.dcloud.PandoraEntry",
"/message/android/notification/badge/add_num": 1
}
}
```
2. 部分特定厂商支持的且不常用的功能，uniPush未提供统一封装。
比如实现【小米】通道对app版本号筛选
options 配置示例如下：
```json
"options": {
其他配置...,
"XM": {
"/extra.app_version": "v3.3.0"
"options":{
"HW":{
"/message/android/ttl":"86400s"
}
}
```
## 参数详情
## 【华为】角标
* 参数示例
```json
"options": {
"HW": {
"/message/android/notification/badge/class": "io.dcloud.PandoraEntry",
"/message/android/notification/badge/add_num": 1,
"/message/android/notification/badge/set_num": 2
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/message/android/notification/badge/class |String |是 |无|value：io.dcloud.PandoraEntry|
|/message/android/notification/badge/add_num |Integer |是 |无|value：应用角标累加数字，并非应用角标实际显示数字<br>必须是大于0小于100的整数|
|/message/android/notification/badge/set_num |Integer |是 |无|value：角标设置数字<br>必须是大于0小于100的整数，如果set_num和add_num同时存在，以set_num为准|
> 注意事项<br>1. 点击启动图标或通知栏系统并不会清理角标数，需应用在端侧通过角标API去清理角标；<br>2. add_num：EMUI版本8.0.0(及以上)，推送服务App版本8.0.0（及以上）支持；<br>3. set_num：EMUI版本10.0.0（及以上），推送服务App版本10.1.0（及以上）支持。
## 【华为】富文本消息
### Options参数说明:
* 参数示例
```json
"options": {
"HW": {
"/message/android/notification/image": "公网可以访问的https图标链接",
"/message/android/notification/style": 1,
"/message/android/notification/big_title": "big_title",
"/message/android/notification/big_body": "big_body"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/message/android/notification/image |String |是 |无|通知小图；<br>value：请写入对应图标https地址<br>URL使用的协议必须是HTTPS协议，取值样例：<a href="javascript:void(0)">https://example.com/image.png。</a>|
|/message/android/notification/style |Integer |是 |无|通知长文本；<br>value：1<br>通知栏样式1，为长文本。|
|/message/android/notification/big_title |String |是 |无|通知长文本；<br>value：通知title内容<br>设置big_title后通知栏展示时，使用 big_title而不用title。|
|/message/android/notification/big_body |String |是 |无|通知长文本；<br>value：通知title内容<br>通知body内容。设置big_body后通知栏展示时，使用big_body而不用body。|
> 注意事项<br>1. 通知长文本：EMUI版本9.1.0（及以上），推送服务App版本9.1.1（及以上）支持。
## 【华为】消息分类
消息分类使用之前，需要先向华为侧发邮件申请权限参见[华为消息分类申请](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835)
key 说明
| **名称** | 类型 | 是否必须 | 默认值 | 描述 |
| ---------------------------------------- | ------ | -------- | ------ | ------------------------------------------------------------ |
| /message/android/notification/importance | String | 否 | 无 | 取值为“LOW”时，表示消息为资讯营销；取值为“NORMAL”时，表示消息为服务与通讯 |
**Options参数说明:**
- Options参数【ups 参数中】下进行设置示例:
```
"HW": {
"/message/android/notification/importance","LOW"
}
```
## 【华为】离线自定义铃声
离线自定义铃声设置需要Android客户端配合使用
### 服务端
key 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| ------------------------------------------- | ------- | -------- | ------ | ------------------------------------------------------------ |
| /message/android/notification/default_sound | Boolean | 是 | 无 | 设置为 false，使用sound自定义铃声 |
| /message/android/notification/channel_id | String | 是 | 无 | 自Android O版本后可以支持通知栏自定义渠道，指定消息要展示在哪个通知渠道上，详情请参见[自定义通知渠道](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/android-custom-chan-0000001050040122-V5)。 自定义通知渠道仅对发送给用户设备的重要级别消息有效，一般级别消息仍然通过华为营销通知渠道展示。 |
| /message/android/notification/sound | String | 是 | 无 | 自定义消息通知铃声，在新创建渠道时有效，此处设置的铃声文件必须存放在应用的/res/raw路径下，例如设置为“/raw/shake”，对应应用本地的“/res/raw/shake.xxx”文件，支持的文件格式包括MP3、WAV、MPEG等，如果不设置使用默认系统铃声。 |
| /message/android/notification/importance | String | 否 | 无 | 取值为“LOW”时，表示消息为资讯营销；取值为“NORMAL”时，表示消息为服务与通讯 |
注意：自定义铃声受华为自己通知消息权重影响
自定义通知渠道仅对发送给用户设备的服务与通讯级别消息有效，一般级别消息仍然通过华为营销通知渠道展示（一般级别消息是不会播放自定义铃声）。这个时候就不会播放自定义铃声了。消息类别受华为侧AI智能判断控制，或开发者自己向华为侧申请[自分类权益申请](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/message-frequency-restriction-0000001149358835-V5#ZH-CN_TOPIC_0000001149358835__section893184112272)
**Rest-v2 示例：**
> Options参数【ups 参数中】下进行设置示例:
```
"HW": {
"/message/android/notification/default_sound",false,
"/message/android/notification/channel_id","RingRing4",
"/message/android/notification/sound","/raw/ring001"
}
```
## 【小米】消息分类
小米推送的消息通道分为“普通消息”（默认）和“重要消息”两类，默认下发普通消息。普通消息单日可推送数量有限制，重要消息不限。重要消息申请具体请参考： [小米推送消息分类新规](https://dev.mi.com/console/doc/detail?pId=2422)
### Options参数说明:
* 参数示例
```json
"options": {
"XM": {
"/extra.channel_id": "Default"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/extra.channel_id |String |是 |无|value：填写小米平台申请的渠道id|
> 注意事项：<br>1. 如果使用重要消息，需要在客户端创建对应的渠道，具体请参考: [MIUI 10 通知类别 (Channel) 适配说明](https://docs.getui.com/getui/server/rest_v2/third_party/)
## 【小米】富文本消息
先调用小米接口，上传图片，获取图片url。
Java方式 <a target="_blank" href="https://dev.mi.com/console/doc/detail?pId=1278%23_3_3">参考（小米官方文档） 4.4.1 大图/大文本/Large icon</a>，或者集成<a target="_blank" href="https://github.com/GetuiLaboratory/getui-3rd-push-utils">个推多厂商推送工具集</a>。
RestAPI 方式 <a target="_blank" href="https://dev.mi.com/console/doc/detail?pId=1163">参考（小米官方文档）11.1 大图、大文本/上传大图API</a>。
### Options参数说明:
* 参数示例
```json
"options": {
"XM": {
"/extra.notification_style_type": 2,
"/extra.notification_bigPic_uri":"http://url.big.pic/xxx.png"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/extra.notification_style_type |String |是 |无|1表示多字版；2表示大图版 <br> 填1时，文本内容为body内的值|
|/extra.notification_bigPic_uri |String |是 |无|/extra.notification_style_type填2时，填写，表示大图地址(上传到小米返回的url)<br>图片要求:固定876x324px，小于1M，PNG/JPG/JPEG格式。 |
|/extra.notification_large_icon_uri |String |是 |无|通知小图；<br>value：填写接口返回的图片链接。<br>Large icon可以出现在大图版和多字版消息中，显示在右边，通知小图。图片要求:尺寸必须为 120×120px，文件小于200KB，PNG/JPG/JPEG格式。|
> 注意事项：<br>1. 富文本消息仅在MIUI10及以上版本支持，在低版本和非MIUI系统上，消息将按照普通消息的样式展示; <br>2. 国内版MIUI系统中，仅在MIUI12及以上版本支持large icon，MIUI12以下版本不会展示; <br>3. 发送大图消息时，如果因为网络原因图片下载失败后将不会展示图片， 而是按照普通消息样式 展示。
## 【小米】离线自定义铃声
离线自定义铃声设置需要Android客户端配合使用
### 服务端：
key 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------ | -------- | ------ | ------------------------------------------------------------ |
| /extra.sound_uri | String | 是 | 无 | 小米后台申请的自定义 sound_url 地址，示例：android.resource://your packagename/raw/XXX |
| /extra.channel_id | String | 是 | 无 | 小米后台申请的通知类别id |
> 注意：若服务端/extra.sound_uri和/extra.channel_id同时设置，Android 8.0及以上版本的通知效果以channel中的效果为准
1、客户端-小米厂商版本需要用com.getui:xmp:1.0.8版本或小米-3.0.1版本及以上
2、客户端铃声文件放在Android app的raw目录下；
3、针对android8以上的小米机型，离线自定义铃声只在channel通道中起作用，若需要多个不同铃声则需要多个不同channel通道
因此需要在小米平台上新建channel通道，设置自定义铃声前端路径如：android.resource://your packagename/raw/test（路径不需要带音频后缀名）如图
![](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/custom_sound.png)
**Rest-v2 示例：**
> Options参数【ups 参数中】下进行设置示例:
```
"XM": {
"/extra.sound_uri": "小米后台申请的自定义 sound_url 地址",
"/extra.channel_id": "小米后台申请的通知类别id"
}
```
## 【小米】语言范围
### Options参数说明:
* 参数示例
```json
"options": {
"XM": {
"/extra.locale": "zh_CN"
}
}
```
### 服务端
key 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| ------------------------------------------- | ------- | -------- | ------ | ------------------------------------------------------------ |
| /extra.locale | String | 否 | 无 | 可以接收消息的设备的语言范围，用逗号分隔。比如，中国大陆用zh_CN表示。 |
| /extra.locale_not_in | String | 否 | 无 | 无法收到消息的设备的语言范围，逗号分隔。 |
## 【小米】model筛选
### Options参数说明:
* 参数示例
```json
"options": {
"XM": {
"/extra.model": "MI 4LTE"
}
}
```
### 服务端
key 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| ------------------------------------------- | ------- | -------- | ------ | ------------------------------------------------------------ |
| /extra.model | String | 否 | 无 | 可以收到消息的设备的机型范围，逗号分隔。当前设备的model的获取方法：Build.MODEL。<br>比如，小米手机4移动版用”MI 4LTE”表示。 |
| /extra.model_not_in | String | 否 | 无 | 无法收到消息的设备的机型范围，逗号分隔。 |
## 【小米】app版本号筛选
### Options参数说明:
* 参数示例
```json
"options": {
而 uni-push 简化了代码，无需 “android.ups”。例如，要实现发送消息时在小米通道上对 app 版本号进行筛选，完整示例代码为：
```js
const pushManager = uniCloud.getPushManager({"appId":"__UNI__TEST123"})
return await pushManager.sendMessage({
title:"消息标题",
content:"消息内容",
// ...其他参数略，可参考：https://doc.dcloud.net.cn/uniCloud/uni-cloud-push/api.html#%E5%85%A5%E5%8F%82%E8%AF%B4%E6%98%8E
options: {
"XM": {
"/extra.app_version": "v3.3.0"
}
}
```
### 服务端
key 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| ------------------------------------------- | ------- | -------- | ------ | ------------------------------------------------------------ |
| /extra.app_version | String | 否 | 无 | 可以接收消息的app版本号，用逗号分割。安卓app版本号来源于manifest文件中的”android:versionName”的值。 |
| /extra.app_version_not_in | String | 否 | 无 | 无法接收消息的app版本号，用逗号分割。 |
## 【小米】按钮设置
### Options参数说明:
* 参数示例
```json
"options": {
"XM": {
"/extra.notification_style_button_left_name": "左侧按钮",
"/extra.notification_style_button_left_notify_effect": "3",
"/extra.notification_style_button_left_web_uri": "https://c.runoob.com/front-end/854/"
}
}
```
### 服务端
key 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| ------------------------------------------- | ------- | -------- | ------ | ------------------------------------------------------------ |
| /extra.notification_style_button_left_notify_effect | String | 否 | 无 | 左侧按钮点击后的动作，支持以下取值：<br>1：打开应用<br>2：打开应用内指定页面<br>3：打开网页<br>如果不配置或者配置为其他值都将不显示按钮。 |
| /extra.notification_style_button_left_name | String | 否 | 无 | 左侧按钮名称。<br>该参数必须配置，不配置将不展示按钮。。 |
| /extra.notification_style_button_left_intent_uri | String | 否 | 无 | 打开应用。 |
| /extra.notification_style_button_left_web_uri | String | 否 | 无 | 点击左侧按钮，打开指定web页面。 |
| /extra.notification_style_button_left_intent_class | String | 否 | 无 | 点击左侧按键，打开应用内指定页面。 |
| /extra.notification_style_button_right_notify_effect | String | 否 | 无 | 右侧按钮点击后的动作，支持以下取值：<br>1：打开应用<br>2：打开应用内指定页面<br>3：打开网页<br>如果不配置或者配置为其他值都将不显示按钮。 |
| /extra.notification_style_button_right_name | String | 否 | 无 | 右侧按钮名称。<br>该参数必须配置，不配置将不展示按钮。。 |
| /extra.notification_style_button_right_intent_uri | String | 否 | 无 | 打开应用。 |
| /extra.notification_style_button_right_web_uri | String | 否 | 无 | 点击右侧按钮，打开指定web页面。 |
| /extra.notification_style_button_right_intent_class | String | 否 | 无 | 点击右侧按键，打开应用内指定页面。 |
| /extra.notification_style_button_mid_notify_effect | String | 否 | 无 | 中间按钮点击后的动作，支持以下取值：<br>1：打开应用<br>2：打开应用内指定页面<br>3：打开网页<br>如果不配置或者配置为其他值都将不显示按钮。 |
| /extra.notification_style_button_mid_name | String | 否 | 无 | 中间按钮名称。<br>该参数必须配置，不配置将不展示按钮。。 |
| /extra.notification_style_button_mid_intent_uri | String | 否 | 无 | 打开应用。 |
| /extra.notification_style_button_mid_web_uri | String | 否 | 无 | 点击中间按钮，打开指定web页面。 |
| /extra.notification_style_button_mid_intent_class | String | 否 | 无 | 点击中间按键，打开应用内指定页面。 |
## 【OPPO】公、私信
OPush平台上所有通道分为“公信”(默认)、“私信”两类，默认下发公信消息。公信消息单日可推送数量有限制，私信消息不限(仅限单个用户)。私信消息申请请<a target="_blank" href="https://open.oppomobile.com/wiki/doc#id=11096">参见（OPPO官方文档）通道升级公测邀请</a>。
### Options参数说明:
* 参数示例
```json
"options": {
"OP": {
"/channel_id": "Default"
}
}
})
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/channel_id |String |是 |无|value：填写OPPO平台登记的渠道ID|
> 注意事项<br><a style="color:red">1.该接口需要联系个推技术人员申请开通才可以使用;</a><br>2.OPPO私信消息仅支持单推。<br/>3. 如果使用私信，需要在客户端创建对应的私信渠道，具体请参考: [通知通道（Channel）适配](https://open.oppomobile.com/wiki/doc#id=10289)
## 【OPPO】富文本消息
先调用OPPO接口，上传图片，获取图标url。
Java方式集成<a target="_blank" href="https://github.com/GetuiLaboratory/getui-3rd-push-utils">个推多厂商推送工具集</a>。
RestAPI <a target="_blank" href="https://open.oppomobile.com/wiki/doc%23id=10693">参考 “图片上传”</a> 。
### Options参数说明:
* 参数示例
```json
"options": {
"OP": {
"/small_picture_id": "xxxxxxxxxxxxxxx",
// "style": 2,
"/style": 3,
"/big_picture_id": "big_body"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 |支持单推| 描述 |
| --------- | ------------- | ---- | ---- | -------- |---|
|/style |Integer |是 |无|是|通知栏样式<br>1. 标准样式 <br> 2. 长文本样式（ColorOS版本>5.0可用，通知栏第一条消息可展示全部内容，非第一条消息只展示一行内容） <br> 3. 大图样式（ColorOS版本>5.0可用，通知栏第一条消息展示大图，非第一条消息不显示大图，推送方式仅支持广播）|
|/small_picture_id |String |是 |无|**否**|通知小图；<br>value: 填写接口返回的图标ID<br>图片要求:尺寸144*144 px，文件大小为50k以内,格式为PNG/JPG/JPEG。|
|/big_picture_id |String |是 |无|**否**|通知大图<br>value：填写接口返回的图标id，**style为3时必填**<br> 图片要求:尺寸876*324px,文件大小1M以内，格式为PNG/JPG/JPEG。|
> 注意事项：<br>通知小图标、大图不支持单推，单推请求会返回无权限错误
## 【OPPO】消息去重
App开发者自定义消息Id，OPPO推送平台根据此ID做去重处理
### Options参数说明:
* 参数示例
```json
"options": {
"OP": {
"/app_message_id": "xxxx"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 |支持单推| 描述 |
| --------- | ------------- | ---- | ---- | -------- |---|
|/app_message_id |String |是 |无|是|App开发者自定义消息Id，OPPO推送平台根据此ID做去重处理，对于tolist推送和全部用户推送相同app_message_id只会保存一次，对于单推相同app_message_id只会推送一次|
## 【OPPO】定时展示
开发者可以根据自己的业务需求设置定时展示，定时展示功能设置成功后消息即时下发，到达用户手机后并不直接展示出来，消息在设置的定时展示时间内展示出来。
### Options参数说明:
* 参数示例
```json
"options":{
"OP":{
"/show_time_type":1,
"/show_start_time":1640570400000,
"/show_end_time":1640571000000
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 |支持单推| 描述 |
| --------- | ------------- | ---- | ---- | -------- |---|
|/show_time_type |Int |否 |0|否| 展示类型 (0, “即时”),(1, “定时”) |
|/show_start_time |Long |否 |0|否| 定时展示开始时间（根据time_zone转换成当地时间），时间的毫秒数 |
|/show_end_time |Long |否 |0|否| 定时展示结束时间（根据time_zone转换成当地时间），时间的毫秒数 |
> 注意事项：消息并不是到达开始时间就会展示，是在开始时间和结束之间之内进行展示
## 【OPPO】自定义消息有效期
开发者可设置每条消息的有效期，在设置的有效期内，只要设备联网，便会收到消息。消息有效期最长10天，最短1小时。
### Options参数说明:
* 参数示例
```json
"options":{
"OP":{
"/off_line":true,
"/off_line_ttl":86400
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |支持单推|
| --------- | ------------- | ---- | ---- | -------- |---|
|/off_line |Boolean |否 |TRUE| 是否进离线消息,【非必填，默认为True】 |是|
|/off_line_ttl |Int |否 |3600| 离线消息的存活时间(time_to_live) (单位：秒), 【最长10天】 |是|
## 【OPPO】限时展示
消息在通知栏展示后开始计时，到达填写的相对应时间后自动从通知栏消失
### Options参数说明:
* 参数示例
```json
"options":{
"OP":{
"/show_ttl":86400
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 |支持单推| 描述 |
| --------- | ------------- | ---- | ---- | -------- |---|
|/show_ttl |int |否 |86400|是| 限时展示(单位：秒)，消息在通知栏展示后开始计时，到达填写的相对应时间后自动从通知栏消失，默认是1天。时间范围6 * 60 * 60 s -- 48 * 60 * 60 s|
## 【OPPO】动作参数
打开应用内页或网页时传递给应用或网页
### Options参数说明:
* 参数示例
```json
"options":{
"OP":{
"/action_parameters/key":"value",
"/action_parameters/key1":"value1"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 |支持单推| 描述 |
| --------- | ------------- | ---- | ---- | -------- |---|
|/action_parameters/XXX |String |否 |null|是|XXX表示自定义参数，动作参数，打开应用内页或网页时传递给应用或网页|
## 【vivo】消息分类
vivo消息分类功能将推送消息类型分为运营消息和系统消息，默认下发运营消息。运营消息单用户单应用单日接收条数上限为5条，系统消息不限。系统消息功能不用申请，可以直接使用，如特殊情况需额外提升系统消息量级，请<a target="_blank" href="https://dev.vivo.com.cn/documentCenter/doc/359">参见（vivo官方文档）推送消息分类功能说明</a>。
### Options参数说明:
* 参数示例
```json
"options": {
"VV": {
"/classification": 0
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
|:---------------|:--------|:-------|:------|:---------------------------------------------|
| /classification | Integer | 否 | 0 | value: 0代表运营消息，1代表系统消息 |
## 【vivo】通知类型
通知消息类型，响铃和振动设置，只对Android 8.0及以下系统有效
### Options参数说明:
* 参数示例
```json
"options": {
"VV": {
"/notifyType": 0
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
|:---------------|:--------|:-------|:------|:---------------------------------------------|
| /notifyType | int | 是 | 无 | 通知类型 1:无，2:响铃，3:振动，4:响铃和振动 注意：只对Android 8.0及以下系统有效 |
## 【vivo】网络方式
开发者可设置手机接收消息的网络方式,若设置wifi下发送，只有手机联网方式为wifi才能收到消息；设置不限，手机只要联网即可收到消息
### Options参数说明:
* 参数示例
```json
"options": {
"VV": {
"/networkType": -1
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
|:---------------|:--------|:-------|:------|:---------------------------------------------|
| /networkType | int | 否 | -1 | 网络方式 -1：不限，1：wifi下发送|
## 【vivo】消息保留时长
开发者可设置每条消息的保留时长，在设置的保留时长内，只要设备联网，便会收到消息。
### Options参数说明:
* 参数示例
```json
"options":{
"VV":{
"/timeToLive":86400
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/timeToLive |int |否 |86400| 消息保留时长 单位：秒，单推取值至少60秒，群推至少900秒，最长7天。当值为空时，默认一天|
## 【vivo】客户端自定义键值对
客户端自定义键值对,app可以按照客户端SDK接入文档获取该键值对
### Options参数说明:
* 参数示例
```json
"options":{
"VV":{
"/clientCustomMap/key":"value",
"/clientCustomMap/key1":"value1"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|/clientCustomMap/XXX |String |否 |null|客户端自定义键值对,app可以按照客户端SDK接入文档获取该键值对|
## ios厂商通道消息
具体参数含义详见<a target="_blank" href="https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/PayloadKeyReference.html">苹果APNs文档</a>
| 名称 | 类型 | 是否必需 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|type|String|否|notify默认通知消息|voip：voip语音推送，notify：apns通知消息|
|aps |Json |否|无|推送通知消息内容|
|auto_badge |String|否|无|用于计算icon上显示的数字，还可以实现显示数字的自动增减，如“+1”、 “-1”、 “1” 等，计算结果将覆盖badge|
|payload|String|否|无|增加自定义的数据|
|multimedia|Json Array|否|无|多媒体设置|
|apns-collapse-id|String|否|无|使用相同的`apns-collapse-id`可以覆盖之前的消息|
**aps**
| 名称 | 类型 | 是否必需 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|alert |Json |否|无| 通知消息|
|content-available | Number| 否 |0|0表示普通通知消息(默认为0)；<br>1表示静默推送(无通知栏消息)，静默推送时不需要填写其他参数。<br>苹果建议1小时最多推送3条静默消息|
|sound |String |否|无|通知铃声文件名，如果铃声文件未找到，响铃为系统默认铃声。<br>无声设置为“com.gexin.ios.silence”或不填|
|category | String|否|无 |在客户端通知栏触发特定的action和button显示|
|thread-id | String|否|无 |ios的远程通知通过该属性对通知进行分组，仅支持iOS 12.0以上版本|
**alert**
| 名称 | 类型 | 是否必需 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|title| String| 否|无|通知消息标题|
|body| String| 否|无|通知消息内容|
|action-loc-key| String| 否|无|（用于多语言支持）指定执行按钮所使用的Localizable.strings|
|loc-key |String| 否|无|（用于多语言支持）指定Localizable.strings文件中相应的key|
|loc-args |String Array|否|无| 如果loc-key中使用了占位符，则在loc-args中指定各参数|
|launch-image |String| 否|无|指定启动界面图片名|
|title-loc-key| String|否|无| (用于多语言支持）对于标题指定执行按钮所使用的Localizable.strings,仅支持iOS8.2以上版本|
|title-loc-args| String Array |否|无|对于标题,如果loc-key中使用的占位符，则在loc-args中指定各参数,仅支持iOS8.2以上版本|
|subtitle| String |否|无|通知子标题,仅支持iOS8.2以上版本|
|subtitle-loc-key| String |否|无|当前本地化文件中的子标题字符串的关键字,仅支持iOS8.2以上版本|
|subtitle-loc-args| String Array |否|无|当前本地化子标题内容中需要置换的变量参数 ,仅支持iOS8.2以上版本|
**multimedia说明**：
该字段为Array类型，最多可设置3个子项，每个参数定义如下所示：
| 名称 | 类型 | 是否必需 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|url| String | 是|无|多媒体资源地址|
|type |Number |是|无|资源类型（1.图片，2.音频，3.视频）|
|only_wifi| Boolean |否|false| 是否只在wifi环境下加载，如果设置成true,但未使用wifi时，会展示成普通通知|
示例：
voip语音推送：
```json
{
"ios":{
"type":"voip",
"payload":"自定义消息"
}
}
```
apns通知消息
```json
{
"IOS":{
"type":"notify",
"payload":"自定义消息",
"aps":{
"alert":{
"title":"通知标题",
"body":"通知内容"
},
"content-available":0,
"sound":"com.gexin.ios.silence",
"category":"ACTIONABLE"
},
"auto_badge":"+1",
"multimedia": [{
"url": "https://xxx",
"type": 1,
"only_wifi": false
}]
}
}
```
apn静默推送 可参考<a target="_blank" href="https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CreatingtheNotificationPayload.html#//apple_ref/doc/uid/TP40008194-CH10-SW8">苹果APNs文档</a>
```json
{
"ios":{
"aps":{
"content-available":1
},
"payload": "自定义消息"
}
}
```
## 【UPS】展开式通知
通知展示样式，文本+长文本样式和文本+大图样式，二者选其一；**该参数作用于UPS下面的所有机型，比如ST,SN等等**。
### Options参数说明:
* 参数示例
```json
"options":{
"UPS":{
"bigText":"请填写长文本内容"
//"bigImageUrl":"请填写大图的url地址"
}
}
```
* **key** 说明
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
|bigText |String |否 |无|通知展示文本+长文本样式的长文本内容|
|bigImageUrl |String |否 |无|通知展示大图样式的大图内容，填写大图的URL地址|
<div class="weixin-support">
<div class="weixin-support-focus">
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或