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)

参数 :

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

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

void unbind(String evt);

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

IMessageCallback

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

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

详细说明

void handle(String msg, String event, String channel);

功能:处理收到的消息 参数: 1.msg 收到的消息 2.event 监听的事件 3.channel 监听的频道

备注:监听频道事件的时候传入IMessageCallback的实现类实例,当收到消息之后,系统会自动调用该实例的handle方法并传入 msg,event,channel参数

results matching ""

    No results matching ""