个推,手机推送api的使用

个推的作用：可以为手机端的app使用者推送消息，而不是通过手机上的app对用户发送消息。所以用户是被动的接收信息。当然不只是只有对用户弹出窗口的这种方式，也可以把信息推送给app，让app决定对用户实行怎么样的操作，例如在app的栏目中显示出有新信息的图标，以便提高用户体验。

个推的官网http://www.igetui.com/

该api支持Android和iso的推送。

下载个推的sdk，里面有各种不同文档，其中有android的apk的安装文件，可以进行推送的测试。

1. /**
2. * 推送的基类
3. * @author hj
4. */
5. public abstract class PushBase {
6. protected static final String APPID = "b03c5cfef65ed30108f0a3fd82c3f6b4";
7. protected static final String APPKEY = "110000";
8. protected static final String MASTERSECRET = "a02a76119b20d4e31620d7597a3b4f35";
9. protected static final String CLIENTID = "f8b14fc288a21bc3d675190e9a4db0a4";
10. protected static final String API = "http://sdk.open.api.igexin.com/apiex.htm";     //OpenService接口地址
11. protected static String getDate(){
12. Date date = new Date();
13. return date.toLocaleString();
14. }
15. }

对多个app进行推送：

1. import java.util.ArrayList;
2. import java.util.List;
3. import com.gexin.rp.sdk.base.IIGtPush;
4. import com.gexin.rp.sdk.base.IPushResult;
5. import com.gexin.rp.sdk.base.impl.AppMessage;
6. import com.gexin.rp.sdk.http.IGtPush;
7. import com.gexin.rp.sdk.template.LinkTemplate;
8. public class PushMessageToAppTest extends PushBase{
9. public static void main(String[] args) {
10. // 推送主类
11. IIGtPush push = new IGtPush(API, APPKEY, MASTERSECRET);
12. try {
13. AppMessage message = new AppMessage();
14. //通知模版：支持TransmissionTemplate、LinkTemplate、NotificationTemplate，此处以LinkTemplate为例
15. //在通知栏显示一条含图标、标题等的通知，用户点击可打开您指定的网页
16. LinkTemplate template = new LinkTemplate();
17. template.setAppId(APPID);                               //应用APPID
18. template.setAppkey(APPKEY);                         //应用APPKEY
19. //通知属性设置：如通知的标题，内容
20. template.setTitle("填写通知标题");                        // 通知标题
21. template.setText("填写通知内容");                 // 通知内容
22. template.setLogo("hello.png");
23. //          template.setIsRing(true);                   // 收到通知是否响铃，可选，默认响铃
24. //          template.setIsVibrate(true);                    // 收到通知是否震动，可选，默认振动
25. //          template.setIsClearable(true);              // 通知是否可清除，可选，默认可清除
26. template.setUrl("http://baidu.com");        //点击通知后打开的网页地址，你可以设定你希望跳转的网页地址如http://www.igetui.com
27. message.setData(template);
28. //          message.setOffline(true);       //用户当前不在线时，是否离线存储，可选，默认不存储
29. //          message.setOfflineExpireTime(72 * 3600 * 1000);     //离线有效时间，单位为毫秒，可选
30. List<String> appIdList = new ArrayList<String>();
31. appIdList.add(APPID);
32. List<String> phoneTypeList = new ArrayList<String>();//通知接收者的手机操作系统类型，可选
33. phoneTypeList.add("ANDROID");
34. List<String> provinceList = new ArrayList<String>();        //通知接收者所在省份，可选
35. provinceList.add("浙江");
36. provinceList.add("上海");
37. provinceList.add("北京");
38. List<String> tagList = new ArrayList<String>();         //通知接收者的标签用户，可选
39. tagList.add("填写tags名称");
40. message.setAppIdList(appIdList);
41. message.setPhoneTypeList(phoneTypeList);
42. message.setProvinceList(null);
43. message.setTagList(null);
44. IPushResult ret = push.pushMessageToApp(message);
45. System.out.println(ret.getResponse().toString());
46. } catch (Exception e) {
47. e.printStackTrace();
48. }
49. }
50. }

对单个app的多个用户进行推送：

1. import java.util.ArrayList;
2. import java.util.List;
3. import com.gexin.rp.sdk.base.IIGtPush;
4. import com.gexin.rp.sdk.base.IPushResult;
5. import com.gexin.rp.sdk.base.impl.ListMessage;
6. import com.gexin.rp.sdk.base.impl.Target;
7. import com.gexin.rp.sdk.http.IGtPush;
8. import com.gexin.rp.sdk.template.NotificationTemplate;
9. //可接收多个用户，最多为50个
10. public class PushMessageToListTest extends PushBase{
11. public static void main(String[] args) {
12. //显示每个用户的用户状态，false:不显示，true：显示
13. System.setProperty("gexin.rp.sdk.pushlist.needDetails", "true");
14. // 推送主类
15. IIGtPush push = new IGtPush(API, APPKEY, MASTERSECRET);
16. try {
17. ListMessage message = new ListMessage();
18. //通知模版：支持TransmissionTemplate、LinkTemplate、NotificationTemplate，此处以NotificationTemplate为例
19. //在通知栏显示一条含图标、标题等的通知，用户点击后激活您的应用
20. NotificationTemplate template = new NotificationTemplate();
21. template.setAppId(APPID);                           //应用APPID
22. template.setAppkey(APPKEY);                         //应用APPKEY
23. //通知属性设置：如通知的标题，内容
24. template.setTitle("此处填写通知标题"+getDate());                    // 通知标题
25. template.setText("此处填写通知内容"+getDate());                 // 通知内容
26. template.setLogo("push.png");               // 通知图标，需要客户端开发时嵌入
27. template.setIsRing(false);                  // 收到通知是否响铃，可选，默认响铃
28. //          template.setIsVibrate(true);                    // 收到通知是否震动，可选，默认振动
29. template.setIsClearable(true);              // 通知是否可清除，可选，默认可清除
30. template.setTransmissionType(2);                // 收到消息是否立即启动应用，1为立即启动，2则广播等待客户端自启动
31. template.setTransmissionContent("你需要透传的内容"+getDate());  // 透传内容（点击通知后SDK将透传内容传给你的客户端，需要客户端做相应开发）
32. message.setData(template);
33. //          message.setOffline(true);       //用户当前不在线时，是否离线存储，可选，默认不存储
34. //          message.setOfflineExpireTime(72 * 3600 * 1000);     //离线有效时间，单位为毫秒，可选
35. // 接收者
36. List<Target> targets = new ArrayList<Target>();
37. Target target1 = new Target();
38. //          Target target2 = new Target();                      //如果需要可设置多个接收者
39. target1.setAppId(APPID);                            //接收者安装的应用的APPID
40. target1.setClientId(CLIENTID);                      //接收者的ClientID
41. //如需，可设置多个接收者
42. //          target2.setAppId(APPID2);                           //接收者2安装应用的APPID
43. //          target2.setClientId(CLIENTID2);                     //接收者2的ClientID
44. targets.add(target1);
45. //          targets.add(target2);
46. //推送前通过该接口申请“ContentID”
47. String contentId = push.getContentId(message);
48. IPushResult ret = push.pushMessageToList(contentId, targets);
49. System.out.println(ret.getResponse().toString());
50. } catch (Exception e) {
51. e.printStackTrace();
52. }
53. }
54. }

对单个app的单个用户进行推送：

1. import com.gexin.rp.sdk.base.IIGtPush;
2. import com.gexin.rp.sdk.base.IPushResult;
3. import com.gexin.rp.sdk.base.impl.SingleMessage;
4. import com.gexin.rp.sdk.base.impl.Target;
5. import com.gexin.rp.sdk.http.IGtPush;
6. import com.gexin.rp.sdk.template.TransmissionTemplate;
7. //对单个用户推送
8. public class PushMessageToSingleTest extends PushBase{
9. public static void main(String[] args) {
10. // 推送主类
11. IIGtPush push = new IGtPush(API, APPKEY, MASTERSECRET);
12. try {
13. //单推消息类型
14. SingleMessage message = new SingleMessage();
15. //通知模版：支持TransmissionTemplate、LinkTemplate、NotificationTemplate，此处以TransmissionTemplate为例
16. //数据经SDK传给您的客户端，由您写代码决定如何处理展现给用户
17. TransmissionTemplate template = new TransmissionTemplate();//透传方式
18. template.setAppId(APPID);
19. template.setAppkey(APPKEY);
20. template.setTransmissionContent("您需要透传的内容:"+getDate());
21. //收到消息是否立即启动应用，1为立即启动，2则广播等待客户端自启动
22. template.setTransmissionType(1);
23. message.setData(template);
24. //          message.setOffline(true);                   //用户当前不在线时，是否离线存储,可选
25. //          message.setOfflineExpireTime(72 * 3600 * 1000); //离线有效时间，单位为毫秒，可选
26. Target target1 = new Target();
27. target1.setAppId(APPID);
28. target1.setClientId(CLIENTID);
29. //单推
30. IPushResult ret = push.pushMessageToSingle(message, target1);
31. System.out.println(ret.getResponse().toString());
32. } catch (Exception e) {
33. e.printStackTrace();
34. }
35. }
36. }

1. import com.gexin.rp.sdk.base.IIGtPush;
2. import com.gexin.rp.sdk.base.IPushResult;
3. import com.gexin.rp.sdk.base.impl.SingleMessage;
4. import com.gexin.rp.sdk.base.impl.Target;
5. import com.gexin.rp.sdk.http.IGtPush;
6. import com.gexin.rp.sdk.template.NotyPopLoadTemplate;
7. public class PushMessageToSingleTest1 extends PushBase{
8. public static void main(String[] args) {
9. // 推送主类
10. IIGtPush push = new IGtPush(API, APPKEY, MASTERSECRET);
11. try {
12. // 单推消息类型
13. SingleMessage message = new SingleMessage();
14. //通知栏弹框下载模版
15. //在通知栏显示一条含图标、标题等的通知，用户点击后弹出框，用户可以选择直接下载应用或者取消下载应用。
16. NotyPopLoadTemplate template = new NotyPopLoadTemplate();
17. // 是否激活
18. template.setActived(true);
19. // 安卓标识
20. template.setAndroidMark("android_mark");
21. template.setAppId(APPID);
22. template.setAppkey(APPKEY);
23. // 是否自动安装
24. template.setAutoInstall(true);
25. // 是否响铃
26. template.setBelled(true);
27. // 通知是否可清除
28. template.setCleared(true);
29. // 苹果标识
30. template.setIphoneMark("iphone_mark");
31. // 下载图标
32. template.setLoadIcon("");
33. // 下载标题
34. template.setLoadTitle("LoadTitle");
35. // 下载地址
36. template.setLoadUrl("http://dizhensubao.igexin.com/dl/com.ceic.apk");
37. // 通知栏内容
38. template.setNotyContent("NotyContent");
39. // 通知栏图标
40. template.setNotyIcon("");
41. // 通知栏标题
42. template.setNotyTitle("NotyTitle");
43. // 左侧按钮名称
44. template.setPopButton1("下载");
45. // 右侧按钮名称
46. template.setPopButton2("取消");
47. // 弹框内容
48. template.setPopContent("popContent");
49. // 弹框图标
50. template.setPopImage("");
51. // 弹框标题
52. template.setPopTitle("PopTitle");
53. // 塞班标识
54. template.setSymbianMark("symbian_mark");
55. // 是否震动
56. template.setVibrationed(true);
57. message.setData(template);
58. message.setOffline(true);
59. message.setOfflineExpireTime(72 * 3600 * 1000);
60. // 设置优先级
61. message.setPriority(1);
62. Target target1 = new Target();
63. target1.setAppId(APPID);
64. target1.setClientId(CLIENTID);
65. // 单推
66. IPushResult ret = push.pushMessageToSingle(message, target1);
67. System.out.println(ret.getResponse().toString());
68. } catch (Exception e) {
69. // TODO Auto-generated catch block
70. e.printStackTrace();
71. }
72. }
73. }