APNS ( Android Push Notification Service) 是一种在Android 系统上实现推送的一套服务.通过http接口,向APNS服务器发送一个URL请求后,消息即会推送给指定的设备.
使用
1)到官方主页申请免费API, 下载 apns_beta_20110831.jar
官方主页: www.push-notification.mobi
2) 将apns_beta_20110831.jar添加到工程.
在工程上右键打开“属性”,选择 “Java Build Path”, 在 Libraries 中选择 “Add External JARs”, 选择下载的 apns_beta_20110831.jar.
3) 接收 push notification.
设备在接收到通知的时候会发送一个广播,通过使用BroadcastReceiver 接收并处理收到的通知.
4) 启动服务复制代码
- package com.apns.demo;
- import android.app.Notification;
- import android.app.NotificationManager;
- import android.app.PendingIntent;
- import android.content.BroadcastReceiver;
- import android.content.Context;
- import android.content.Intent;
- import com.apns.APNService;
- public class MyBroadcastReceiver extends BroadcastReceiver {
- @Override
- public void onReceive(Context context, Intent intent) {
- if(intent.getAction().equals(APNService.ON_NOTIFICATION)) {
- String str = intent.getStringExtra("data");
- //todo, 处理收到的消息
- }
- }
- }
发送Intent 启动服务,将 chanel 名字以及 此设备的标识 (chanel中唯一表示此设备的字符串) 传递过去:
notes: devId,标示此channel 中设备的唯一id, 可以是唯一用户名, uid, IMEI 等等.复制代码
- Intent intent = new Intent(APNService.START);
- intent.putExtra("ch", chanel);
- intent.putExtra("devId", devId);
- startService(intent);
5) 配置AndroidManifest.xml配置 Service/BroadcastReceiver,添加权限。
推送API:复制代码
- <application android:icon="@drawable/icon"
- ...
- <service android:name="com.apns.APNService" android:label="APNS">
- <intent-filter>
- <action android:name="com.apns.APNService.START" />
- <action android:name="com.apns.APNService.STOP" />
- <category android:name="android.intent.category.DEFAULT"/>
- </intent-filter>
- </service>
- <receiver android:name="MyBroadcastReceiver">
- <intent-filter>
- <action android:name="com.apnsd.APNService.NOTIFICATION" />
- </intent-filter>
- </receiver>
- ...
- </application>
- <uses-permission android:name="android.permission.INTERNET" />
- <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
通过Rect 接口发送通知到设备(登录 www.push-notification.mobi 会有一个测试平台):
- http://www.push-notification.mobi/handlers/apns_v1.php?ch=YourChannelId&devId=YourDevId&msg=”hello
- world”&random=0123&hash=HashCode
ch: api 的 channel Id.
devId: 接收设备的Id.
msg:要发送的消息.
random:一个随机数hash.
ch + g + msg + random + privateKey的MD5 校验码.
返回值:
服务器返回一 xml 格式字符串:
result 值:复制代码
- <response result="0" msg="sended"/>
-1: 服务器连接失败
0: 发送成功
1: 无权发送
2: 权限被阻止
3: 设备不在线
12: chanel 过期
13: hash code 不一致
14: 参数不合法
15: 意外错误
example.zip