彩云企业消息推送平台编程指南.pdf

《彩云企业消息推送平台编程指南.pdf》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、北京彩云荣光软件有限公司彩云企业消息推送平台编程指南（Ver1.0）北京彩云荣光软件有限公司1北京彩云荣光软件有限公司1.彩云企业消息推送平台介绍彩云企业消息推送平台是由彩云荣光软件公司开发提供的企业级的消息推送平台。该平台的特点是使用简单，工作可靠。用户只要在自己的移动App内加入对平台API的调用，就具备了24小时在线的消息接收能力。无论移动设备重启，网络切换，都能保证可靠的接收消息。API调用只需要一个函数调用即可。消息发送工作同样简单，无论是网络服务，还是桌面应用，都可以调用API向移动设备推送消息。1.1平台结构

2、对开发者而言，了解系统的结构和工作原理，对开发是非常有帮助的。下图是彩云消息推送平台的工作过程和原理：UserPushAnroidMessageServerApp1.PushRequestSender2.SendMessage3.GetMessage开始工作时，首先由移动客户端向推送服务器发送一个请求，然后等待推送服务器的返回。此请求包含了客户端的标识信息,以识别不同的客户端。推送服务器不会立刻返回数据给客户端，此时客户端和服务器之间的连接处于保持状态。当用户的应用服务器有消息要发给某个用户时，就向推送服务器发送请求，推送

3、服务器根据客户端的标识，找到该客户端的连接，将消息发给移动客户端。移动客户端得到消息后，可以进行合适的通知（振铃，闪光等）或者处理，以通知用户。然后客户端再次开始一个推送周期。1.2使用要求用户标识包括两部分，公司ID和用户ID。公司ID就是消息发送方的公司标识。访问https://www.glorycloud.com.cn/PushServer/register.jsp进行注册2北京彩云荣光软件有限公司就可以获得推送服务帐号。用户ID是您分配给您的用户的ID，比如用户的名字，ID号，邮件地址等。2.API使用2.1客户端

4、开发1）将glorypush.jar文件，复制到您的Android工程下面的libs目录（注意，这个目录名是Android固定库目录，不能使用其他名字），在Eclipse里面刷新工程。2）在您的Activity里面，加入代码，代码中的companyId，要替换成您注册时输入的公司标识。密码为注册时使用的密码。3北京彩云荣光软件有限公司PushClientmyPushClient;privatefinalstaticStringcompanyId="MyCompany";@OverridepublicvoidonCreate

5、(BundlesavedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);myPushClient=newPushClient(this,companyId);startPush();}privatevoidstartPush(){StringclientId="support@glorycloud.com.cn";//youruserIDStringpkgName="com.pushclient";//youpa

6、ckagenameStringaction="com.pushclient.NewMessage";//yourreceiveractionmyPushClient.startPush(clientId,CallbackInfo.INTENT_BROADCAST,pkgName,action,0);//myPushClient.startPush(clientId,CallbackInfo.INTENT_ACTIVITY,pkgName,"com.pushclient.PushClientActivity",Intent.

7、FLAG_ACTIVITY_NEW_TASK

8、Intent.FLAG_ACTIVITY_SINGLE_TOP);}3）定义一个Reciever类，以在收到推送消息时，得到通知。推送消息保存在BroadcastReceiver收到的Intent对象中。可以用下面的调用获得intent.getStringExtra(CallbackInfo.KEY_REPLY_MSG);4北京彩云荣光软件有限公司publicclassNewMessageReceiverextendsBroadcastReceiver{publicNewMes

9、sageReceiver(){}@OverridepublicvoidonReceive(Contextcontext,Intentintent){Stringmessage=intent.getStringExtra(CallbackInfo.KEY_REPLY_MSG);showNotificati