j-im/README.md
2018-01-24 14:12:41 +08:00

3.3 KiB
Raw Blame History

tio-im简介

tio-im是基于t-io写的IM,主要目标降低即时通讯门槛,通过极简洁的消息格式就可以实现多端不同协议间的消息发送如(http、websocket、tcp自定义im协议)等并可以通过http协议的api接口进行消息发送无需关心接收端属于什么协议一个消息格式搞定一切

消息格式

1.聊天请求消息结构

{
   "from": "来源ID",
   "to": "目标ID",
   "cmd":命令码(11),
   "createTime": 消息创建时间Long类型,
   "msgType": "消息类型(0:text、1:image、2:voice、3:vedio、4:music、5:news)",
   "chatType":"聊天类型(0:未知,1:公聊,2:私聊)",
   "group_id":"群组id仅在chatType为(1)时需要",
   "content": "内容"
}

请求:COMMAND_CHAT_REQ(11) 响应:COMMAND_CHAT_RESP(12)

2.鉴权请求消息结构

{
    "cmd":命令码(3),
    "token": "校验码"
}

请求:COMMAND_AUTH_REQ(3) 响应:COMMAND_AUTH_RESP(4)

3.握手请求消息结构

{
    "cmd":命令码(1),
    "hbyte":"握手1个字节"
}

说明:请求:COMMAND_HANDSHAKE_REQ(1) 响应:COMMAND_HANDSHAKE_RESP(2)

4.登录请求消息结构

{
    "cmd":命令码(5),
    "loginname": "用户名",
    "password": "密码",
    "token": "校验码(此字段可与logingname、password共存,也可只选一种方式)"
}

请求:COMMAND_LOGIN_REQ(5) 响应:COMMAND_LOGIN_RESP(6)

5.心跳请求消息结构

{
    "cmd":命令码(13),
    "hbbyte":"心跳1个字节"
}

请求:COMMAND_HEARTBEAT_REQ(13) 响应:无

6.关闭、退出请求消息结构

{
    "cmd":命令码(14)
}

请求:COMMAND_CLOSE_REQ(14) 响应:无

7.获取用户信息请求消息结构

{
     "cmd":命令码(17),
     "userid":"用户id(只在type为0或是无的时候需要)",
     "type":"获取类型(0:指定用户,1:所有在线用户,2:所有用户[在线+离线])
}

请求:COMMAND_GET_USER_REQ(17) 响应:COMMAND_GET_USER_RESP(18)

性能

性能不用说,去参考t-io性能指标相关版本第一时间与tio保持同步更新

更多

更多相关信息持续关注这家伙:t-io不仅仅百万并发框架

tio-im一些截图

Web访问地址:http://localhost:8888

输入图片说明

Http协议api调用地址:http://localhost:8888/api/message/send

输入图片说明

输入图片说明

说明

tio-im会有一个成长过程一如t-io的发展历程会从丑小鸭变成天鹅的希望大家多提意见

鸣谢

t-io不仅仅百万并发框架

联系方式

个人QQ:1241503759

QQ群号245513673

输入图片说明