首页 > 代码库 > JPush极光推送Java服务器端API

JPush极光推送Java服务器端API

2024-07-20 14:33:05   220人阅读

转自：http://www.cnblogs.com/zhanghaoh/archive/2013/02/20/2919282.html
// 对android和ios设备发送JPushClient jpush = new JPushClient(masterSecret, appKey); // 对android和ios设备发送,同时指定离线消息保存时间JPushClient jpush = new JPushClient(masterSecret, appKey, timeToLive); // 指定某种设备发送JPushClient jpush = new JPushClient(masterSecret, appKey, DeviceEnum.Android); // 指定某种设备发送，并且指定离线消息保存时间JPushClient jpush = new JPushClient(masterSecret, appKey, timeToLive, DeviceEnum.IOS);

 

参数名称参数类型选项内容说明
masterSecret
String必须Portal上注册应用时生成的 masterSecret
appKeyString必须Portal上注册应用时生成的 appKey
timeToLivelong可选

保存离线消息的时长。秒为单位。最多支持10天（864000秒）。
0 表示该消息不保存离线。即：用户在线马上发出，当前不在线用户将不会收到此消息。
此参数不设置则表示默认，默认为保存1天的离线消息（86400秒）。

DeviceEnumEnum可选指定的设备。
可选值：DeviceEnum.Android, DeviceEnum.IOS。
不填或者null值为同时支持 Android 与 iOS。

发送消息

JPushClient公共方法

 

方法名称参数列表(必须)方法说明
setEnableSSLboolean enableSSL (true为使用ssl, 默认为不使用ssl)是否启动ssl安全连接

sendNotificationWithImei

int sendNo(发送编号),
String imei (IMEI字符串) ,
String msgTitle (消息标题/通知标题) ,
String msgContent (消息内容/通知内容) 		发送带IMEI的通知
sendNotificationWithImeiint sendNo , 
String imei ,
String msgTitle ,
String msgContent ,
int builderId (自定义通知栏样式Id) ,
Map<String, Object>extra (附属信息)		自定义通知栏(没有则填写0)
以及传递附属信息 

sendCustomMessageWithImei

int sendNo , 
String imei ,
String msgTitle ,
String msgContent 		发送带IMEI的消息
sendCustomMessageWithImeiint sendNo , 
String imei ,
String msgTitle ,
String msgContent， 
String msgContentType (消息内容类型，原样返回),
Map<String, Object> extra 		用户自定义消息类型，
以及传递附属信息 

sendNotificationWithTag

int sendNo , 
String tag (Tag字符串) ,
String msgTitle ,
String msgContent		发送带Tag的通知
sendNotificationWithTagint sendNo , 
String tag ,
String msgTitle ,
String msgContent , 
int builderId ,
Map<String, Object>extra		自定义通知栏(没有则填写0)
以及传递附属信息 

sendCustomMessageWithTag

int sendNo , 
String tag ,
String msgTitle ,
String msgContent		发送带Tag的消息
sendCustomMessageWithTagint sendNo , 
String tag ,
String msgTitle ,
String msgContent ,
String msgContentType ,
Map<String, Object> extra 		用户自定义消息类型，
以及传递附属信息 

sendNotificationWithAlias

int sendNo , 
String alias (Alias字符串) ,
String msgTitle , 
String msgContent		发送带Alias的通知
sendNotificationWithAliasint sendNo , 
String alias (Alias字符串) ,
String msgTitle , 
String msgContent ,
int builderId ,
Map<String, Object>extra		自定义通知栏(没有则填写0)
以及传递附属信息 

sendCustomMessageWithAlias

int sendNo , 
String alias ,
String msgTitle , 
String msgContent		发送带Alias的消息
sendCustomMessageWithAliasint sendNo , 
String alias ,
String msgTitle , 
String msgContent , 
String msgContentType ,
Map<String, Object> extra 		用户自定义消息类型，
以及传递附属信息 

sendNotificationWithAppKey

int sendNo , 
String msgTitle , 
String msgContent		发送通知给AppKey的所有用户
sendNotificationWithAppKeyint sendNo , 
String msgTitle , 
String msgContent ,
int builderId ,
Map<String, Object>extra		自定义通知栏(没有则填写0)
以及传递附属信息 

sendCustomMessageWithAppKey

int sendNo , 
String msgTitle , 
String msgContent		发送带AppKey的消息
sendCustomMessageWithAppKeyint sendNo , 
String msgTitle , 
String msgContent ,
String msgContentType ,
Map<String, Object> extra  		用户自定义消息类型，
以及传递附属信息 

 

代码示例

代码示例－发送带IMEI的通知
JPushClient jpush = new JPushClient(masterSecret, appKey);
//jpush.setEnableSSL(true);
int sendNo = 1;
String imei = "";
String msgTitle = "";
String msgContent = "";
 
MessageResult msgResult = jpush.sendNotificationWithImei(sendNo, imei, msgTitle, msgContent);
if (null != msgResult) {
    if (msgResult.getErrcode() == ErrorCodeEnum.NOERROR.value()) {
        System.out.println("发送成功， sendNo=" + msgResult.getSendno());
    } else {
        System.out.println("发送失败， 错误代码=" + msgResult.getErrcode() + ", 错误消息=" + msgResult.getErrmsg());
    }
} else {
    System.out.println("无法获取数据");
}
代码示例－IOS设置通知铃声和badge
JPushClient jpush = new JPushClient(masterSecret, appKey);
 
Map<String, Object> extra = new HashMap<String, Object>();
IOSExtra iosExtra = new IOSExtra(1, "Windows_Logon_Sound.wav");//badge and sound
extra.put("ios", iosExtra);
 
MessageResult msgResult = jpush.sendNotificationWithAppKey(sendNo, msgTitle, msgContent, 0, extra);

MessageResult 类

公共方法方法用途

getSendno

 消息发送成功后，按客户端传输的sendNo原样返回

getErrcode

 错误代码，代码定义参考ErrorCodeEnum
getErrmsg 返回错误消息的描述

ErrorCode 类

错误代码－ErrorCodeEnum
package cn.jpush.api; public enum ErrorCodeEnum {         //没有错误，发送成功    NOERROR(0),     //系统内部错误    SystemError(10),     //不支持GET请求    NotSupportGetMethod(1001),     //缺少必须参数    MissingRequiredParameters(1002),     //参数值不合法    InvalidParameter(1003),     //验证失败    ValidateFailed(1004),     //消息体太大    DataTooBig(1005),     //IMEI不合法    InvalidIMEI(1007),     //appkey不合法    InvalidAppKey(1008),     //msg_content不合法    InvalidMsgContent(1010),     //没有满足条件的推送目标    InvalidPush(1011),     //IOS不支持自定义消息    CustomMessgaeNotSupportIOS(1012);     private final int value;    private ErrorCodeEnum(final int value) {        this.value =http://www.mamicode.com/ value;    }     public int value() {        return this.value;    }}

 

JPush极光推送Java服务器端API


联系
我们