尊敬的小米开发者：

您好！

感谢您长期以来对小米推送服务的关注和大力支持。
为了提供更优质的服务和用户体验，小米推送计划于2024年09月30日0点起下线“自定义通知消息”功能，届时将无法正常使用自定义通知消息。如您的应用有集成“自定义通知消息”功能，请务必在2024年09月30日0点前切换成“预定义通知消息”，以免影响您使用推送服务。
切换过程有任何疑问，您可通过小米推送客服系统与我们联系。
感谢您的配合！

小米推送团队
2024年8月14日

FAQ

1、为何要下线自定义通知消息功能，集成预定义通知消息有何优势？

针对预定义通知消息，当前跳转环节已完成升级，实现了跳转速度的提升。为提升您应用的通知跳转体验，建议您尽快完成切换。

2、如何确定是否为自定义通知消息或预定义通知消息？

如果服务端调用Message.Builder类的extra(String key, String value)方法设置了Constants.EXTRA_PARAM_NOTIFY_EFFECT的值，则为预定义通知消息（具体细节请参见《服务端Java SDK文档》）；否则为自定义通知消息。

3、如何集成预定义通知消息？

3.1 Java SDK方式

i.打开当前app对应的Launcher Activity：

服务端SDK调用Message.Builder 类的extra(String key, String value) 方法，将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_LAUNCHER_ACTIVITY。

ii.打开当前app内任意一个Activity：

服务端SDK调用Message.Builder 类的extra(String key, String value) 方法，需要携带如下两对key-value：

• key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_ACTIVITY；
• key设置为Constants.EXTRA_PARAM_INTENT_URI，value设置为启动Activity的Intent uri。

iii.打开网页：

服务端SDK调用Message.Builder 类的extra(String key, String value) 方法，需要携带如下两对key-value：

• key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_WEB；
• key设置为Constants.EXTRA_PARAM_WEB_URI，value设置为启动的网页uri。

3.2 REST API方式

通过设置extra.notify_effect 值以得到不同的预定义点击行为。

• “1″：通知栏点击后打开app的Launcher Activity。
• “2″：通知栏点击后打开app的任一Activity（开发者还需要传入extra.intent_uri ）。
• “3″：通知栏点击后打开网页（开发者还需要传入extra.web_uri ）。

详细参见《服务器API地址以及参数》中的“表 1-1. Android POST参数说明“文档。

3.3 小米推送运营平台方式

在”小米推送运营平台–>推送工具->推送内容->点击后续动作”中根据业务需求分别选择“打开应用”、“打开网页”、“打开应用内指定页面”。