// 对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 |
appKey | String | 必须 | Portal上注册应用时生成的 appKey |
timeToLive | long | 可选 | 保存离线消息的时长。秒为单位。最多支持10天(864000秒)。 |
DeviceEnum | Enum | 可选 | 指定的设备。 可选值:DeviceEnum.Android, DeviceEnum.IOS。 不填或者null值为同时支持 Android 与 iOS。 |
发送消息
JPushClient公共方法
方法名称 | 参数列表(必须) | 方法说明 |
---|---|---|
setEnableSSL | boolean enableSSL (true为使用ssl, 默认为不使用ssl) | 是否启动ssl安全连接 |
sendNotificationWithImei | int sendNo(发送编号), String imei (IMEI字符串) , String msgTitle (消息标题/通知标题) , String msgContent (消息内容/通知内容) | 发送带IMEI的通知 |
sendNotificationWithImei | int 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的消息 |
sendCustomMessageWithImei | int sendNo , String imei , String msgTitle , String msgContent, String msgContentType (消息内容类型,原样返回), Map<String, Object> extra | 用户自定义消息类型, 以及传递附属信息 |
sendNotificationWithTag | int sendNo , String tag (Tag字符串) , String msgTitle , String msgContent | 发送带Tag的通知 |
sendNotificationWithTag | int sendNo , String tag , String msgTitle , String msgContent , int builderId , Map<String, Object>extra | 自定义通知栏(没有则填写0) 以及传递附属信息 |
sendCustomMessageWithTag | int sendNo , String tag , String msgTitle , String msgContent | 发送带Tag的消息 |
sendCustomMessageWithTag | int sendNo , String tag , String msgTitle , String msgContent , String msgContentType , Map<String, Object> extra | 用户自定义消息类型, 以及传递附属信息 |
sendNotificationWithAlias | int sendNo , String alias (Alias字符串) , String msgTitle , String msgContent | 发送带Alias的通知 |
sendNotificationWithAlias | int 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的消息 |
sendCustomMessageWithAlias | int sendNo , String alias , String msgTitle , String msgContent , String msgContentType , Map<String, Object> extra | 用户自定义消息类型, 以及传递附属信息 |
sendNotificationWithAppKey | int sendNo , String msgTitle , String msgContent | 发送通知给AppKey的所有用户 |
sendNotificationWithAppKey | int sendNo , String msgTitle , String msgContent , int builderId , Map<String, Object>extra | 自定义通知栏(没有则填写0) 以及传递附属信息 |
sendCustomMessageWithAppKey | int sendNo , String msgTitle , String msgContent | 发送带AppKey的消息 |
sendCustomMessageWithAppKey | int 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 = value; } public int value() { return this .value; } } |