首页 > 代码库 > 极光推送使用实例(二) Android客户端

极光推送使用实例(二) Android客户端

上一篇简单介绍了极光推送在Java服务端的实现,如果感兴趣的可以看一下极光推送使用实例(一)JAVA服务端。这篇文章介绍下极光推送在Android客户端的实现。 
JPush Android SDK 是作为 Android Serivice 长期运行在后台的,从而创建并保持长连接,保持永远在线的能力。JPush Android SDK 由于使用自定义协议,协议体做得极致地小,流量消耗非常地小。电量方面,JPush Android SDK 经过持续地优化,尽可能减少不必要的代码执行;并且,长期的版本升级迭代,不断地调优,在保证一定的网络连接稳定性的要求小,减少电量消耗。而 Android 设备的网络的复杂性、不稳定性,是 Android 设备开发最复杂的地方之一。 
关键点: 
1.强烈建议大家上极光官网下载Android demo,里面有所需要的jar文件以及配置文件。配置正确的包名,获取项目的appKey值 
2.极光推送通过广播来实现,所以Android客户端关键就是注册广播事件 
3.建议在项目初始化Application的时候初始化JdPush(初始化过才可以进行推送服务) 
4.这里我们实现全部用户推送和个别用户推送

下载官网demo然后部署,我们会看到如下效果

技术分享

下面看具体的代码,点击initPush就是初始化JdPush。在具体项目中建议这一步在Application初始化的时候实现。初始化代码其实很简单

// 初始化 JPush。如果已经初始化,但没有登录成功,则执行重新登录。    private void init(){         JPushInterface.init(getApplicationContext());    }

 

广播MessageReceiver ,首先根据MESSAGE_RECEIVED_ACTION判断广播是否为当前广播,然后从广播中获取推送的内容

    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());            }        }    }

 

注册广播的方法registerMessageReceiver,主要是registerReceiver(mMessageReceiver, filter)方法

public void registerMessageReceiver() {        mMessageReceiver = new MessageReceiver();        IntentFilter filter = new IntentFilter();        filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);        filter.addAction(MESSAGE_RECEIVED_ACTION);        registerReceiver(mMessageReceiver, filter);    }

1

  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

最后在onCreate方法中

public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.main);        initView();           registerMessageReceiver();  // used for receive msg    }

 

ok,只要我们点击init按钮,日志里会显示初始化成功log。然后从后台推送一条服务过来,会看到日志显示如下信息

02-07 08:35:36.235: V/JPush(693): [JPushInterface] action:getPushNotificationBuilder : 002-07 08:35:36.275: D/PhoneStatusBar(276): addNotification score=002-07 08:35:36.325: D/JPush(693): [NotificationHelper] Send push received broadcast to developer defined receiver02-07 08:35:36.335: D/JPush(693): [MyReceiver] onReceive - cn.jpush.android.intent.NOTIFICATION_RECEIVED, extras: 02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.MSG_ID, value:39958893502-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.ALERT, value:祝大家新春快乐02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.NOTIFICATION_CONTENT_TITLE, value:JPush SDK Demo02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.EXTRA, value:{}02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.PUSH_ID, value:39958893502-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.NOTIFICATION_ID, value:39958893502-07 08:35:36.335: D/JPush(693): [MyReceiver] 接收到推送下来的通知02-07 08:35:36.335: D/JPush(693): [MyReceiver] 接收到推送下来的通知的ID: 39958893502-07 08:35:36.355: D/MediaPlayer(276): Couldn‘t open file on client side, trying server side

 

技术分享

可以看到图片左上角图标就是提醒我们收到推送消息。

上面我们后台是面向全部操作平台(包括ANdorid,iOS)的所有用户推送内容,那么如何针对某一个用户推送内容呢?上一篇文章有提到过,我们需要设置别名(alias)。

ok,点击高级功能,会看到如下界面,并且我在alias里填入手机号码 
技术分享

具体设置别名(alias)的代码,可以看到是调用Handler来实现的

private void setAlias(){        EditText aliasEdit = (EditText) findViewById(R.id.et_alias);        String alias = aliasEdit.getText().toString().trim();        if (TextUtils.isEmpty(alias)) {            Toast.makeText(PushSetActivity.this,R.string.error_alias_empty, Toast.LENGTH_SHORT).show();            return;        }        if (!ExampleUtil.isValidTagAndAlias(alias)) {            Toast.makeText(PushSetActivity.this,R.string.error_tag_gs_empty, Toast.LENGTH_SHORT).show();            return;        }        //调用JPush API设置Alias        mHandler.sendMessage(mHandler.obtainMessage(MSG_SET_ALIAS, alias));    }

 

handler里是调用如下代码设置alias值

  case MSG_SET_ALIAS:                Log.d(TAG, "Set alias in handler.");                JPushInterface.setAliasAndTags(getApplicationContext(), (String) msg.obj, null, mAliasCallback);                break;

 

然后我们就可以根据设置的alias值,结合第一篇博客后台服务器的设置方法,根据确定的别名进行推送。下面是上一篇博客中后台服务器对alias的设置

public static PushPayload buildPushObject_all_alias_alert() {        return PushPayload.newBuilder()                .setPlatform(Platform.android())//设置接受的平台                .setAudience(Audience.alias("18810923631"))//Audience设置为all,说明采用广播方式推送,所有用户都可以接收到                .setNotification(Notification.alert(ALERT))                .build();    }

 

除了别名(alias)外,极光推送还提供了tag(标签),主要是针对特定的一组用户进行推送。还有设置推送时间以及设置通知栏样式,大家也可以研究。重要的还是明白其原理

最后再来看一下原理图 
技术分享

极光推送使用实例(二) Android客户端