Android 消息服务库

概述

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

开发准备

环境要求

• android 4.0.3 （SDK API 15）及以上
• Android Studio 3.5+

集成 SDK

1. 将 tv.mudu.commentlib.aar 放入 app/libs

2. 在 app/build.gradle 加入

implementation fileTree(include: ['*.aar'], dir: 'libs')

配置 App 权限

在 app/AndroidManifest.xml 中声明以下权限

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

快速开发

1.设置 key，若没有account key，请联系客服咨询

MDConfig.setAccountKey("");

2.设置全局频道HashId(可通过频道详情接口actid字段获取)

MDConfig.setActivityId(String activityHashId);

3.创建评论管理对象

Commenter commenter = new Commenter(Context context);

4.登陆

//设置登录的评论者昵称和头像，此接口会创建一个匿名角色
commenter.login("评论者昵称", "http://mudu.tv/assets/img/icon.png", new Commenter.LoginCallback() {
    @Override
    public void onLoginSuccess(String s) {
        //s：OK
        //登录成功
    }

    @Override
    public void onLoginFailed(Exception e) {
        //登录失败
    }
});

5.订阅消息

// 进行频道订阅，在发送评论之前必须先注册成功该订阅消息，否则消息将无法收取。
commenter.subscribe(new Commenter.MessageCallback() {
    @Override
    public void onCommentMessage(MessageEntity entity, String msgData) {
        //评论消息
    }

    @Override
    public void onOtherMessage(String msg, String subject) {
        //其他消息
    }

    @Override
    public void onError(int errorCode, String message) {
        //错误
    }
});

6.发送评论消息

// 发送频道消息
commenter.publish("消息内容", new Commenter.Callback(){

    @Override
    public void onSuccess(String result) {
        //发送成功 result: {"id":xxxxx}
    }

    @Override
    public void onError(Exception e) {
        //发送失败
    }

});

7.获取历史评论

int page = 0;
commenter.getCommentList(page, new MDCallback() {

    @Override
    public void onSuccess(Object o) {
        CommentListEntity result = (CommentListEntity) o;
        List<CommentEntity> comments = result.getComments();
        for (CommentEntity entity: comments) {
            showMsg(entity.getUsername() + ": " + entity.getMessage());
        }  
    }

    @Override
    public void onError(Exception e) {
        Log.e(TAG, e.getMessage());
    }
});

8.获取拉流地址

MDActivityManager.getInstance().getLiveAddress(new LiveAddressCallback() {

    @Override
    public void onListLiveAddress(String liveAddress) {
        //列表直播地址
    }

    @Override
    public void onLiveAddress(List<LiveEntity> liveEntityList) {
        //直播地址
    }

    @Override
    public void onError(Exception e) {
        Log.d(TAG, "liveAddress failed: " + e.getMessage());
    }

});

9.取消订阅

commenter.unsubscribe();

10.断开连接

commenter.close();

11.销毁

MDConfig.destroy();
commenter.destroy();

接口说明

MDConfig

Commenter

MDActivityManager

消息对象说明

MessageEntity

评论消息管理对象

ContentDTO

评论对象

LiveEntity

直播流地址对象

ResolutionEntity

不同分辨率地址

错误码说明

MessageCallback.onError

添加混淆文件

在 proguard-rules.pro 文件下添加如下代码：

-keep class org.mdwebsocket.**{*;}
-dontwarn org.mdwebsocket.**

-keep class tv.mudu.commentlib.**{*;}
-dontwarn tv.mudu.commentlib.**