【Android推送】极光推送

---

官方相关文档： http://docs.jpush.cn/pages/viewpage.action?pageId=3309821  

---

一、基本使用说明文档：

1.首先进行接口初始化

 JPushInterface.init( getApplicationContext() );      // 初始化 JPush

{

停止和恢复：

停止：

接口定义： public   static   void   stopPush(Context context);

使用：JPushInterface. stopPush (getApplicationContext()); 

调用了本 API 后，JPush 推送服务完全被停止。具体表现为：

• JPush Service 不在后台运行
• 收不到推送消息
• 不能通过 JPushInterface.init 恢复，需要调用resumePush恢复。
• 极光推送所有的其他 API 调用都无效

恢复：

接口定义： public   static   void   resumePush(Context context);

使用：JPushInterface.resumePush(getApplicationContext());

恢复推送服务。

调用了此 API 后，极光推送完全恢复正常工作。

}

---

2.注册接收广播

     registerMessageReceiver();    // used for receive msg

      public   void   registerMessageReceiver() {

              mMessageReceiver   =   new   MessageReceiver();

           IntentFilter filter =   new   IntentFilter();

           filter.setPriority(IntentFilter.   SYSTEM_HIGH_PRIORITY );

           filter.addAction(   MESSAGE_RECEIVED_ACTION );

           registerReceiver(   mMessageReceiver , filter);

     }

      public   class   MessageReceiver   extends   BroadcastReceiver {

              @Override

              public   void   onReceive(Context context, Intent intent) {

                   if   ( MESSAGE_RECEIVED_ACTION .equals(intent.getAction())) {

              String messge = intent.getStringExtra( KEY_MESSAGE   );

              String extras = intent.getStringExtra(   KEY_EXTRAS );

              StringBuilder showMsg =   new   StringBuilder();

              showMsg.append(   KEY_MESSAGE   +   " : "   + messge +   "\n" );

                if   (!ExampleUtil. isEmpty(extras)) {

                  showMsg.append(   KEY_EXTRAS   +   " : "   + extras +   "\n" );

              }

              setCostomMsg(showMsg.toString());

                }

           }

     }

---

3. 添加Sdk相关权限和功能

     <!-- Required SDK核心功能-->

          < activity

              android:name =   "cn.jpush.android.ui.PushActivity"

              android:theme = "@android:style/Theme.Translucent.NoTitleBar"

              android:configChanges =   "orientation|keyboardHidden"   >

              < intent-filter   >

                  < action   android:name =   "cn.jpush.android.ui.PushActivity"   />

                  < category   android:name =   "android.intent.category.DEFAULT"   />

                  < category   android:name   = "com.jpush.example.app"   />

              </ intent-filter   >

          </ activity   >

          <!-- Required  SDK核心功能-->

          < service

              android:name =   "cn.jpush.android.service.DownloadService"

              android:enabled =   "true"

              android:exported =   "false"   >

          </ service   >

   

       

          <!-- Required SDK 核心功能-->

          < service

              android:name =   "cn.jpush.android.service.PushService"

              android:enabled =   "true"

              android:exported =   "false" >

              < intent-filter   >

                  < action   android:name =   "cn.jpush.android.intent.REGISTER"   />

                  < action   android:name =   "cn.jpush.android.intent.REPORT"   />

                  < action   android:name =   "cn.jpush.android.intent.PushService"   />

                  < action   android:name =   "cn.jpush.android.intent.PUSH_TIME"   />

               

              </ intent-filter   >

          </ service   >

       

          <!-- Required SDK核心功能-->

          < receiver

              android:name =   "cn.jpush.android.service.PushReceiver"

              android:enabled =   "true"   >

               < intent-filter   android:priority   = "1000" >

                  < action   android:name =   "cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY"   />        <!--Required  显示通知栏 -->

                  < category   android:name   = "com.jpush.example.app"   />

              </ intent-filter   >

              < intent-filter   >

                  < action   android:name =   "android.intent.action.USER_PRESENT"   />

                  < action   android:name =   "android.net.conn.CONNECTIVITY_CHANGE"   />

              </ intent-filter   >

               <!-- Optional -->

              < intent-filter   >

                  < action   android:name =   "android.intent.action.PACKAGE_ADDED"   />

                  < action   android:name =   "android.intent.action.PACKAGE_REMOVED"   />

                  < data   android:scheme   = "package"   />

              </ intent-filter   >

  

          </ receiver   >

       

          <!-- Required SDK核心功能-->

          < receiver   android:name =   "cn.jpush.android.service.AlarmReceiver"   />

     

---

4.添加网络等相关权限

     <!-- Required  一些系统要求的权限，如访问网络等-->

      < uses-permission   android:name =   "com.jpush.example.app.permission.JPUSH_MESSAGE"   />

      < uses-permission   android:name =   "android.permission.RECEIVE_USER_PRESENT"   />

      < uses-permission   android:name   = "android.permission.INTERNET"   />

      < uses-permission   android:name   = "android.permission.WAKE_LOCK"   />

      < uses-permission   android:name =   "android.permission.READ_PHONE_STATE"   />

      < uses-permission   android:name =   "android.permission.WRITE_EXTERNAL_STORAGE"   />

      < uses-permission   android:name =   "android.permission.READ_EXTERNAL_STORAGE"   />

      < uses-permission   android:name =   "android.permission.WRITE_SETTINGS"   />

      < uses-permission   android:name   = "android.permission.VIBRATE"   />

      < uses-permission   android:name =   "android.permission.MOUNT_UNMOUNT_FILESYSTEMS"   />

      < uses-permission   android:name =   "android.permission.ACCESS_NETWORK_STATE"   />

      < uses-permission   android:name =   "android.permission.SYSTEM_ALERT_WINDOW"   />   

---

二、添加自定义消息

 极光推送包含有通知与自定义消息两种类型的推送。

主要区别：

 通知：主要用于提示用户的目的。应用加上通知功能，有利于提高应用的活跃度。

 自定义消息 ：自定义消息不是通知，所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。自定义消息用于应用的内部业务逻辑，完全与通知栏展示无关。自定义消息用于应用的内部业务逻辑。一条自定义消息推送过来，有可能没有任何界面显示。

相关资料可以参考：

http://docs.jpush.cn/pages/diffpagesbyversion.action?pageId=3309701&originalVersion=4&revisedVersion=11  

主要使用：

1.自定义广播类：

/**

 * 自定义接收器

 *

 * 如果不定义这个 Receiver，则：

 * 1) 默认用户会打开主界面

 * 2) 接收不到自定义消息

 */

public   class   MyReceiver   extends   BroadcastReceiver {

}

2.注册广播：

   <!-- User defined.  For test only  用户自定义的广播接收器-->

          < receiver

              android:name =   "com.example.jpushdemo.MyReceiver"

              android:enabled =   "true" >

              < intent-filter   >

                  < action   android:name =   "cn.jpush.android.intent.REGISTRATION"   />   <!--Required  用户注册SDK的intent-->

                  < action   android:name =   "cn.jpush.android.intent.UNREGISTRATION"   />    

                  < action   android:name =   "cn.jpush.android.intent.MESSAGE_RECEIVED"   />   <!--Required  用户接收SDK消息的intent-->

                  < action   android:name =   "cn.jpush.android.intent.NOTIFICATION_RECEIVED"   />   <!--Required  用户接收SDK通知栏信息的intent-->

                  < action   android:name =   "cn.jpush.android.intent.NOTIFICATION_OPENED"   />   <!--Required  用户打开自定义通知栏的intent-->

                  < action   android:name =   "cn.jpush.android.intent.ACTION_RICHPUSH_CALLBACK"   />   <!--Optional 用户接受Rich Push Javascript 回调函数的intent-->

                  < action   android:name =   "cn.jpush.android.intent.CONNECTION"   />   <!-- 接收网络变化 连接/断开 since 1.6.3 -->

                  < category   android:name   = "com.jpush.example.app"   />

              </ intent-filter   >

          </ receiver   >

---

---

三、相关设置

1. 设置Tag，Alias

 Alias(别名 ):为安装了应用程序的用户，取个别名来标识。以后给该用户 Push 消息时，就可以用此别名来指定。每个用户只能指定一个别名。

 Tag (标签 )：为安装了应用程序的用户，打上标签。其目的主要是方便开发者根据标签，来批量下发 Push 消息。可为每个用户打多个标签。

 相关API和说明： http://docs.jpush.cn/pages/viewpage.action?pageId=557241 

主要设置接口： public   static   void   setAliasAndTags(Context context, String alias, Set<String> tags, TagAliasCallback callback)




2.定义通知栏样式：

主要接口：

相关API和说明：http://docs.jpush.cn/pages/viewpage.action?pageId=557243 

public static void setDefaultPushNotificationBuilder(BasicPushNotificationBuilder builder)




public static void setPushNotificationBuilder(Integer notificationBuilderId, BasicPushNotificationBuilder builder)




3.设置推送时间

相关API和说明： http://docs.jpush.cn/pages/viewpage.action?pageId=1343490