tim实践系列——如何使用TimMessage自定义各种消息

前言：tim是去中心化分布式即时通讯引擎。不依赖于任何中心服务器，采用去中心化分布式架构，解决传统中心化通讯方式的问题，去中心化分布式架构的通讯引擎的各个节点之间相互连接，形成一个庞大的分布式网络。可以轻松地扩展服务规模，支持更多的用户和业务需求，提供更加安全、可靠、高效的通讯服务。
Github系列开源文章《tim实践系列文章》

tim 定义了TimMessage，TimPresence，TimStream三种数据对象传递数据。其中支持持久化的对象为TimMessage，所以，一般用于用户之间的通信信息，系统信息，此外，TimMessage还支持部分tim的业务信息，如，加好友，入群的信息通知，与部分流数据传递。

TimMessage的字段：

开发者使用TimMessage时，需要对timMessage进行赋值，一些字段不需要客户端赋值的，包括

id，fromTid，isOffline，timestamp  这些字段是由服务器赋值发送到客户端，所以客户端对这些字段赋值是无效的。

以下是赋值字段的说明：

msType是TimMessage必须确定值的字段

msType类型只有3个值，客户端只能使用msType=2，msType=3 两个值，msType=1表示系统信息，客户端如果设置msType=1，服务会返回参数错误。

msType=2表示 信息是发送到用户，msType=2表示 信息是发送到群。

msType=2时，如果同时设置ToTid与RoomTid，即该信息是一条群私信，表示信息发送到同一个群中的群成员。

odType 是TimMessage必须确定值的字段

odType 是8位整型，可以设置256个值，其中负数及小于等于30正数是tim保留值，开发者可以自定义>30的其他整型

odType 表示消息指令，timMessage传递tim的通信消息及指令

odType=5时，timMessage为流数据，流数据只能发送到在线用户，如果用户离线，消息会被抛弃。流数据也不会持久化。流数据适合用于音视频等实时数据。

odType=2时，表示将撤回指定的Mid消息，客户端收到该数据的TimMessage时应该相应删除客户端中存储的消息。

odType=3时，由消息接收者发起的timMessage消息，为消息阅后即焚。

odType=4时，为tim内置的用户系统接口，如果不使用tim内置用户系统接口，该值无用。如果调用了tim内置用户系统接口，tim会在TimMessage中，会指定odType=4，并指定bnType  值告知客户端消息类型，如：加好友，成为好友，申请入群等

bnType 表示tim内置的用户系统业务接口。

toTid 是Tid对象，为发送目标账号

roomTid 是Tid对象，为发送目标群账号

udtype 为开发者自定义值字段

udshow  为开发者自定义值字段

extend 为开发者自定义值字段 为字典类型字段

extra为开发者自定义值字段 为字典类型字段

客户端如何处理TimMessage信息

tim客户端为消息异步触发机制，执行客户端方法后，无需等待服务器返回数据，由服务推送结果到客户端，触发客户端监听程序执行既定流程。

tim的各个客户端都定义了MessageHandler方法或接口，通过实现MessageHandler(TimMessage)来处理服务传递过来的TimMessage对象。

以下是java 客户端实现处理TimMessage的demo程序片段：

tc.MessageHandler((TimMessage tm) -> {
            if (tm.msType == 1) { //系统信息
                Log.debug("this is system message >>", "body>>>", new String(tm.getBody()));
            } else if (tm.msType == 2) {  //用户到用户信息
                Log.debug("this is user to user message");
            } else if (tm.msType == 3) {  //用户到群信息
                Log.debug("this is room to user message");
            }
            switch (tm.odType) {
                case 1: //常规消息
                    Log.debug("chat message >> from>>", tm.fromTid.node, " ,to>>", tm.toTid, ",body>>>", new String(tm.getBody()));
                    break;
                case 2: //撤回消息
                    Log.debug("RevokeMessage>>>", tm.mid);
                    break;
                case 3: //阅后即焚
                    Log.debug("BurnMessage>>>", tm.mid);
                    break;
                case 4: //业务消息
                    Log.debug("business message>>>", tm);
                    break;
                case 5: //流数据
                    Log.debug("stream message>>>", tm);
                    break;
                default: //开发者自定义的消息
                    Log.debug("other message>>>", tm);
            }
        });

有任何问题或建议请Email：[email protected]或 https://tlnet.top/contact  发信给我，谢谢！