Android 消息 sdk

概述

消息sdk是用来订阅消息的开发工具包，为开发者提供简单易用的接口，可以很方便地接收消息信息。

阅读对象

本文档面向所有使用该 SDK 的开发人员、测试人员以及对此感兴趣的用户,要求开发者对消息的基本功能有一定的解。

开发准备

设备和系统版本

android 4.0 及以上

开发步骤

首先需要在安卓应用程序中声明以下权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

然后进行服务声明

<service android:name="org.eclipse.paho.android.service.MqttService" />

然后引入tv.mudu.message.jar开发包

其次按照下面步骤使用sdk进行开发

1.获取消息代理对象 2.订阅频道 3.监听频道发生的事件并处理

DEMO示例

完整demo

public class test {
       public static void main(String args[]) throws Exception {
        //获取一个代理对象
        PusherProxy proxy = PusherPool.Get();
        //订阅频道activity
        PusherChannel channel = proxy.subscribe("activity");
        //监听频道评论事件comment-stream-20780
        channel.bind("comment-stream-20780", new IMessageCallback() {
                @Override
                public void handle(String msg, String event, String channel) {
                    showMsg(msg,100);
                }
        });

        //解绑频道事件comment-stream-20780的监听
        //channel.unbind("comment-stream-20780");
    }
}

步骤说明

1.获取一个代理对象

PusherProxy proxy = PusherPool.Get();

2.订阅频道，这里订阅的是activity

PusherChannel channel = proxy.subscribe("activity");

3.监听频道的评论事件,并准备处理接收到的评论(这里监听的是频道id为20780的频道的评论事件)

channel.bind("comment-stream-20780", new IMessageCallback() {
    @Override
    public void handle(String msg, String event, String channel) {
        //处理评论
    }
});

接口说明

SDK提供了4个类，PusherPool,PusherProxy和PusherChannel，IMessageCallback 其中PusherPool是用来获取消息对象的，PusherChannel是消息sdk的使用类,IMessageCallback是消息处理类

名称	功能描述
PusherPool	消息池，用来获取消息代理对象
PusherProxy	消息代理对象，用来订阅频道
PusherChannel	消息频道，用来监听频道事件
IMessageCallback	消息处理

PusherPool

类名:PusherPool 功能:用来获取消息代理对象成员:

成员	功能
Get	获取消息代理对象

详细说明:

static PusherProxy Get()

Get用来创建代理对象，返回PusherProxy对象

PusherProxy

类名:PusherProxy 功能:用来订阅频道成员:

成员	功能
subscribe	订阅频道

详细说明:

PusherChannel subscribe(String channel)

功能：用来订阅频道返回值：PusherChannel对象

PusherChannel

类名：PusherChannel 功能：监听频道事件成员:

成员	功能
bind	监听频道事件
unbind	解除监听频道事件

详细说明

void bind(String evt, IMessageCallback cb)

参数 :

evt 事件的名称
cb 收到消息之后的回调函数

功能：用来监听频道对应的事件，并处理

void unbind(String evt);

功能：用来解除对频道事件的监听参数：evt 事件名称

IMessageCallback

类名：IMessageCallback 功能：处理收到的消息

成员	功能
handle	处理收到的消息