# options 更多参数配置 ## 简述 由于各手机厂商特定推送参数支持不统一,uniPush为了降低开发者的接入成本,提供一致的推送API。 以下两种需求,可以在`options`参数传入参数实现。 1. 如果开发者希望在不同的厂商手机端,实现不同的效果; 例子:你希望实现在**iOS**和**华为**两款手机,收到消息后的角标变化分别为:在原值上**-1**和**+1**两种效果 options 配置示例如下: ```json "options": { "IOS":{ "auto_badge":"-1", }, "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" } } ``` ## 参数详情 ## 【华为】角标 * 参数示例 ```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:应用角标累加数字,并非应用角标实际显示数字
必须是大于0小于100的整数| |/message/android/notification/badge/set_num |Integer |是 |无|value:角标设置数字
必须是大于0小于100的整数,如果set_num和add_num同时存在,以set_num为准| > 注意事项
1. 点击启动图标或通知栏系统并不会清理角标数,需应用在端侧通过角标API去清理角标;
2. add_num:EMUI版本8.0.0(及以上),推送服务App版本8.0.0(及以上)支持;
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 |是 |无|通知小图;
value:请写入对应图标https地址
URL使用的协议必须是HTTPS协议,取值样例:https://example.com/image.png。| |/message/android/notification/style |Integer |是 |无|通知长文本;
value:1
通知栏样式1,为长文本。| |/message/android/notification/big_title |String |是 |无|通知长文本;
value:通知title内容
设置big_title后通知栏展示时,使用 big_title而不用title。| |/message/android/notification/big_body |String |是 |无|通知长文本;
value:通知title内容
通知body内容。设置big_body后通知栏展示时,使用big_body而不用body。| > 注意事项
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| > 注意事项:
1. 如果使用重要消息,需要在客户端创建对应的渠道,具体请参考: [MIUI 10 通知类别 (Channel) 适配说明](https://docs.getui.com/getui/server/rest_v2/third_party/) ## 【小米】富文本消息 先调用小米接口,上传图片,获取图片url。 Java方式 参考(小米官方文档) 4.4.1 大图/大文本/Large icon,或者集成个推多厂商推送工具集。 RestAPI 方式 参考(小米官方文档)11.1 大图、大文本/上传大图API。 ### 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表示大图版
填1时,文本内容为body内的值| |/extra.notification_bigPic_uri |String |是 |无|/extra.notification_style_type填2时,填写,表示大图地址(上传到小米返回的url)
图片要求:固定876x324px,小于1M,PNG/JPG/JPEG格式。 | |/extra.notification_large_icon_uri |String |是 |无|通知小图;
value:填写接口返回的图片链接。
Large icon可以出现在大图版和多字版消息中,显示在右边,通知小图。图片要求:尺寸必须为 120×120px,文件小于200KB,PNG/JPG/JPEG格式。| > 注意事项:
1. 富文本消息仅在MIUI10及以上版本支持,在低版本和非MIUI系统上,消息将按照普通消息的样式展示;
2. 国内版MIUI系统中,仅在MIUI12及以上版本支持large icon,MIUI12以下版本不会展示;
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://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/42e8152b-f458-462e-9353-43dede93c294.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。
比如,小米手机4移动版用”MI 4LTE”表示。 | | /extra.model_not_in | String | 否 | 无 | 无法收到消息的设备的机型范围,逗号分隔。 | ## 【小米】app版本号筛选 ### Options参数说明: * 参数示例 ```json "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 | 否 | 无 | 左侧按钮点击后的动作,支持以下取值:
1:打开应用
2:打开应用内指定页面
3:打开网页
如果不配置或者配置为其他值都将不显示按钮。 | | /extra.notification_style_button_left_name | String | 否 | 无 | 左侧按钮名称。
该参数必须配置,不配置将不展示按钮。。 | | /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 | 否 | 无 | 右侧按钮点击后的动作,支持以下取值:
1:打开应用
2:打开应用内指定页面
3:打开网页
如果不配置或者配置为其他值都将不显示按钮。 | | /extra.notification_style_button_right_name | String | 否 | 无 | 右侧按钮名称。
该参数必须配置,不配置将不展示按钮。。 | | /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 | 否 | 无 | 中间按钮点击后的动作,支持以下取值:
1:打开应用
2:打开应用内指定页面
3:打开网页
如果不配置或者配置为其他值都将不显示按钮。 | | /extra.notification_style_button_mid_name | String | 否 | 无 | 中间按钮名称。
该参数必须配置,不配置将不展示按钮。。 | | /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平台上所有通道分为“公信”(默认)、“私信”两类,默认下发公信消息。公信消息单日可推送数量有限制,私信消息不限(仅限单个用户)。私信消息申请请参见(OPPO官方文档)通道升级公测邀请。 ### Options参数说明: * 参数示例 ```json "options": { "OP": { "/channel_id": "Default" } } ``` * **key** 说明 | 名称 | 类型 | 是否必须 | 默认值 | 描述 | | --------- | ------------- | ---- | ---- | -------- | |/channel_id |String |是 |无|value:填写OPPO平台登记的渠道ID| > 注意事项
1.该接口需要联系个推技术人员申请开通才可以使用;
2.OPPO私信消息仅支持单推。
3. 如果使用私信,需要在客户端创建对应的私信渠道,具体请参考: [通知通道(Channel)适配](https://open.oppomobile.com/wiki/doc#id=10289) ## 【OPPO】富文本消息 先调用OPPO接口,上传图片,获取图标url。 Java方式集成个推多厂商推送工具集。 RestAPI 参考 “图片上传” 。 ### Options参数说明: * 参数示例 ```json "options": { "OP": { "/small_picture_id": "xxxxxxxxxxxxxxx", // "style": 2, "/style": 3, "/big_picture_id": "big_body" } } ``` * **key** 说明 | 名称 | 类型 | 是否必须 | 默认值 |支持单推| 描述 | | --------- | ------------- | ---- | ---- | -------- |---| |/style |Integer |是 |无|是|通知栏样式
1. 标准样式
2. 长文本样式(ColorOS版本>5.0可用,通知栏第一条消息可展示全部内容,非第一条消息只展示一行内容)
3. 大图样式(ColorOS版本>5.0可用,通知栏第一条消息展示大图,非第一条消息不显示大图,推送方式仅支持广播)| |/small_picture_id |String |是 |无|**否**|通知小图;
value: 填写接口返回的图标ID
图片要求:尺寸144*144 px,文件大小为50k以内,格式为PNG/JPG/JPEG。| |/big_picture_id |String |是 |无|**否**|通知大图
value:填写接口返回的图标id,**style为3时必填**
图片要求:尺寸876*324px,文件大小1M以内,格式为PNG/JPG/JPEG。| > 注意事项:
通知小图标、大图不支持单推,单推请求会返回无权限错误 ## 【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条,系统消息不限。系统消息功能不用申请,可以直接使用,如特殊情况需额外提升系统消息量级,请参见(vivo官方文档)推送消息分类功能说明。 ### 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厂商通道消息 具体参数含义详见苹果APNs文档 | 名称 | 类型 | 是否必需 | 默认值 | 描述 | | --------- | ------------- | ---- | ---- | -------- | |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);
1表示静默推送(无通知栏消息),静默推送时不需要填写其他参数。
苹果建议1小时最多推送3条静默消息| |sound |String |否|无|通知铃声文件名,如果铃声文件未找到,响铃为系统默认铃声。
无声设置为“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静默推送 可参考苹果APNs文档 ```json { "ios":{ "aps":{ "content-available":1 }, "payload": "自定义消息" } } ``` ## 【UPS】展开式通知 通知展示样式,文本+长文本样式和文本+大图样式,二者选其一;**该参数作用于UPS下面的所有机型,比如ST,SN等等**。 ### Options参数说明: * 参数示例 ```json "options":{ "UPS":{ "bigText":"请填写长文本内容" //"bigImageUrl":"请填写大图的url地址" } } ``` * **key** 说明 | 名称 | 类型 | 是否必须 | 默认值 | 描述 | | --------- | ------------- | ---- | ---- | -------- | |bigText |String |否 |无|通知展示文本+长文本样式的长文本内容| |bigImageUrl |String |否 |无|通知展示大图样式的大图内容,填写大图的URL地址|
联系
个推
微信扫一扫
随时联系个推技术支持