自定义点击消息动作

场景介绍

关于通知栏消息，您可以自定义点击消息的动作，包括：打开应用首页、打开网页、打开应用自定义页面。

打开应用自定义页面

打开应用自定义页面可以通过服务端API指定intent或action参数实现，如果同时指定了两个参数，会优先使用intent参数。

指定intent参数

跨应用启动Activity必须使用指定intent方式，通过intent可以携带额外的数据给客户端应用。主要通过如下几步来完成。

指定action参数

指定的action参数需要与客户端应用“AndroidManifest.xml”文件中注册启动的Activity类中intent-filter标签中设置的action名一致。通过如下步骤实现打开应用自定义页面并携带数据给应用。

打开应用首页

打开应用首页并携带数据给应用，开发步骤如下：

1. 服务端发送通知栏消息。

   在Push Kit服务端提供的REST API的Message结构体中，data字段用于携带数据，click_action字段指定点击行为。如果存在message.android.data字段，会覆盖message.data字段值。服务端发送消息详情请参见发送下行消息。

   消息体样例：

   {
       "message": {
           "data": "{ 'score': '7', 'time': '16:42' }",
           "notification": {
               "title": "message title",
               "body": "message body"
           },
           "android": {
               "data": "{ 'androidData': '7', 'time': '16:42' }",
               "notification": {
                   "click_action": {
                       "type": 3
                   }
               }
           },
           "token": [
               "pushtoken1"
           ]
       }
   }

2. 客户端应用“AndroidManifest.xml”文件注册主Activity。“AndroidManifest.xml”文件中主Activity声明参考如下，使得用户点击消息后能拉起应用首页。

   <activity android:name=".MainActivity">
       <intent-filter>
           <!-- 'name'值不可改变 -->
           <action android:name="android.intent.action.MAIN"/>
           <category android:name="android.intent.category.LAUNCHER"/>
       </intent-filter>
   </activity>

3. 客户端应用通过MainActivity中的onCreate方法接收数据。
   Java

   Kotlin

   public class MainActivity extends Activity {
       @Override
       public void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           getIntentData(getIntent());
       }
    
       @Override
       public void onNewIntent(Intent intent) {
           super.onNewIntent(intent);
           setIntent(intent);
           getIntentData(intent);
       }
   
       private void getIntentData(Intent intent) {
           if (null != intent) {           
               // 获取data里的值
               Bundle bundle = intent.getExtras();
               if (bundle != null) {
                   for (String key : bundle.keySet()) {
                       String content = bundle.getString(key);
                       Log.i(TAG, "receive data from push, key = " + key + ", content = " + content);
                   }
               }
           } else {
               Log.i(TAG, "intent is null");
           }
       }
   }

   class MainActivity : AppCompatActivity() {
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)        
           setContentView(R.layout.activity_main)        
           getIntentData(intent)    
       }
       
       override fun onNewIntent(intent: Intent?) {
           super.onNewIntent(intent)          
           setIntent(intent)
           getIntentData(intent)            
       }
   
       private fun getIntentData(intent: Intent?) {
           if (null != intent) {
               // 获取data里的值
               val bundle = intent.extras            
               bundle?.keySet()?.forEach { key ->
                   val content = bundle.getString(key)                
                   Log.i(TAG, "receive data from push, key = $key, content = $content")
               }       
           } else {            
               Log.i(TAG, "intent = null")        
           }    
       }
   }

   说明

   为了确保在跳转的页面获取到传输的数据，请在“onNewIntent”方法中调用“setIntent”方法更新intent为跳转页面时传入的intent，并在“onCreate”和“onNewIntent”方法中调用同一个处理数据的方法（本文中以getIntentData方法为例）。