|
|
@@ -1,11 +1,26 @@
|
|
|
# 野火IM 推送服务
|
|
|
-作为野火IM的推送服务的演示，支持小米、华为、魅族和苹果apns。
|
|
|
+作为野火IM的推送服务的演示，支持小米、华为、魅族和苹果apns。并且可以添加更多的推送厂商和自定义推送模式。
|
|
|
+
|
|
|
+#### 工作原理
|
|
|
+推送功能对于所有IM来说都是非常重要的功能，然而android系统又没有统一的推送服务，对接起来难度很大。另外一方面客户有不同对接需求，有的要求使用第三方，有的要求使用厂商推送，有的需要在海外添加谷歌推送，有的对推送的格式有不同的要求。
|
|
|
+
|
|
|
+为了满足各种各样的需求，提供足够好的灵活性，野火IM把推送子系统独立出来，客户只要理解了推送子系统运行的原理，就能做好各种自定义处理。
|
|
|
+
|
|
|
+
|
|
|
+图中紫色部分为推送子系统，推送子系统的所有源码都是开源的，且可以随意修改。推送子系统的工作流程如下：
|
|
|
+1. 应用启动后，推送SDK初始化，判断采用那种推送服务，比如华为手机就用华为推送，小米手机就用小米推送，或者全部或部分使用第三方推送。如果客户要加谷歌推送也是在这里添加。选定好推送厂商后，就初始化对应推送厂商的SDK，注册成功后会得到推送token，调用IM SDK的setDeviceToken，传入推送token和类型。注意类型是可以扩展的，而且对IM系统没有任何影响的。
|
|
|
+2. SDK被调用setDeviceToken后，会把推送token和类型传入到IM服务，IM服务为对应手机保存下来以备后用。事实上IM服务不需要理解token和type的含义，只需要透传给推送服务即可。
|
|
|
+3. IM服务处理消息时发现用户不在线或者下发消息失败，则会启动是否要推送的决策，比如消息是否需要推送（预制消息已经支持，自定义消息需要传入push content），用户是否全局静音，会话是否被静音，客户有多少天没有登录（超过7天没登录就不推送）。达到推送条件后，跟把所有推送需要的内容打包发给推送服务。
|
|
|
+4. 推送服务接收到IM服务的请求，把推送数据放到消费队列中并立即返回（IM服务不能被阻塞），然后逐步处理推送事件。每个推送事件中都包含了所有需要处理的数据，其中包括1步骤中的推送SDK和类型，然后根据类型来调用对用推送厂商的服务，比如华为/小米/苹果/第三方厂商/谷歌。
|
|
|
|
|
|
#### 编译
|
|
|
```
|
|
|
mvn package
|
|
|
```
|
|
|
|
|
|
+#### 申请推送服务
|
|
|
+客户需要自行去厂商申请推送服务并替换配置文件中的各项参数。我们提供的默认参数是服务工作的，需要替换。不排除推送厂商sdk接口有变化，需要自行调试，如果发现我们demo有问题，欢迎给我们提PR。
|
|
|
+
|
|
|
#### 修改配置
|
|
|
本演示服务有5个配置文件在工程的```config```目录下，分别是```application.properties```, ```apns.properties```, ```meizu.properties```, ```hms.properties```和```xiaomi.properties``` 。
|
|
|
分别配置服务的端口和相关推送的配置。
|
heavyrain.lee