1. 从GoEasy获取appkey
appkey是验证用户的有效性的唯一标识。
- 注册账号。 GoEasy官网:http://goeasy.io
- 用注册好的账号登录到GoEasy的后台管理系统,创建您自己应用(application).
- Application创建好之后系统会自动为您生成appkey
系统会生成两个keys,一个Super key和一个Subscribe key;它们的区别在于前者既可以订阅又可以推送,但后者只能用于订阅。
2. GoEasy实现向特定用户群推送的原理
知道了他们的推送原理,可以更加方便我们了解他们的服务,以及理解我们写的代码。其实原理很简单,只需要确定哪些用户需要接收信息,然后让这些用户都订阅一个相同的channel(频道)。 然后再往这个平台上推送消息即可!所有关键在于channel,channel一致,则可以接收到信息,否则收不到!
对于订阅必须要的信息有:Appkey, channel
对于推送必须要的信息有:Appkey, channel, content
3. 用GoEasy实现订阅(接收)的实例
1 <script type="text/javascript" src="https://cdn.goeasy.io/goeasy.js"></script> 2 3 <script type="text/javascript"> 4 var goEasy = new GoEasy({appkey: ‘your appkey‘}); 5 goEasy.subscribe({ 6 channel: ‘your_channel‘, 7 onMessage: function(message){ 8 alert(‘接收到消息:‘+message.content);//拿到了信息之后,你可以做你任何想做的事 9 } 10 }); 11 </script>
有了这几行代码后,只要保证网络畅通的情况下,页面会自动弹出你从任何平台上推送的信息。
4. 用GoEasy实现推送及接收的实例
目前GoEasy支持三种推送方式: Java后台推送(它们有提供JAVA SDK和 maven远程仓库), JS推送,RestAPI推送(有了RestAPI,我们就可以用PHP, .NET, Ruby…来推送信息了,很方便)
说了这么多,来我们看一下怎么用GoEasy的三种方式分别实现推送吧。
4.1. 用GoEasy SDK推送
1. Java SDK的获取方式,方式一,直接在goeasy的官网上进行下载;方式二,用maven远程库直接导入到项目中。尽管官网上已经做了相同的说明了,我这里还是把关键点帖出来,方便大家查看。
GoEasy SDK下载链接:http://maven.goeasy.io/service/local/artifact/maven/redirect?r=releases&g=io.goeasy&a=goeasy-sdk&v=0.3.3&e=jar
GoEasy远程maven库的配置:
1 <repository> 2 <id>goeasy</id> 3 <name>goeasy</name> 4 <url>http://maven.goeasy.io/content/repositories/releases/</url> 5 </repository> 6 … 7 <dependency> 8 <groupId>io.goeasy</groupId> 9 <artifactId>goeasy-sdk</artifactId> 10 <version>0.3.3</version> 11 </dependency>
需要注意的是:GoEasy需要依赖两个额外的jar 包:
gson.jar : http://repo.maven.apache.org/maven2/com/google/code/gson/gson/2.3.1/gson-2.3.1.jar
slf4j-api.jar : http://repo.maven.apache.org/maven2/org/slf4j/slf4j-api/1.7.2/slf4j-api-1.7.2.jar
2. 实例化GoEasy对象
1 GoEasy goEasy = new GoEasy("your appkey");
c. 推送消息
1 goEasy.publish(‘your_channel‘, ‘First message‘);
4.2. JS推送
a. 引入goeasy.js
1 <script type="text/javascript" src="https://cdn.goeasy.io/goeasy.js"></script>
b. 实例化Goeasy对象,并用publish函数进行推送
1 <script type="text/javascript"> 2 var goEasy = new GoEasy({appkey: ‘your appkey‘}); 3 goEasy. publish ({ 4 channel: ‘your_channel‘, 5 message: ‘Second message!‘ 6 }); 7 </script>
4.3. 用RestAPI进行推送
URL: https://goeasy.io/goeasy/publish
Method: Post
参数:appkey, channel, content
例如:https://goeasy.io/goeasy/publish?appkey={your_appkey}&channel={your_channel}&content={your_message}
GoEasy官网:http://goeasy.io
快速入门:http://goeasy.io/www/started
文档下载:http://goeasy.io/www/documents