Jc.IM 1.0.7

IM 通讯模块

基于Redis订阅 创建的通讯服务

目前支持

1。点对点发送消息

2。群组发送消息

API

启动 中间件

app.UseJcImServer(new JcImOptions()
{
    RedisCon = "192.168.1.83:6379,poolsize=5,password=password123456",
});

JcImOptions:

/// <summary>
/// Redis连接字符串
/// </summary>
public string RedisCon { get; set; }

/// <summary>
/// websocket请求的路径:可空
/// ws://127.0.0.1/{WSPath}
/// </summary>
public string WSPath { get; set; }

/// <summary>
/// 是否启用安全模式
/// 启用：需要通过API获取连接地址
/// 禁用：任何人可以连接到服务
/// </summary>
public bool IsSecurity { get; set; }

获取在线客户端

JcImServerExt.GetClientOnline()

获取分组内成员

JcImServerExt.GetGroupClients(string groupName)

获取成员分组

JcImServerExt.GetClientGroups(string clientId)

加入分组

JcImServerExt.JoinGroup(string clientId, string groupName)

离开分组

JcImServerExt.LeaveGroup(string clientId, List<string> groupName)

事件订阅

//上线，离线 ,消息
JcImServerExt.EventBus(
    offline =>
    {
        Console.WriteLine(offline);
    },
    online =>
    {
        Console.WriteLine(online);
    }, 
    msg =>
    {
        Console.WriteLine(msg.key, msg.message);
    }
);

WebSocket指令

指令结构

{

  //当 MessageType <=3 时候 是消息内容
  //当 MessageType=4 时候 是分组ID/名称
  "Message": "文本信息",
  //接受者ID
  "ReceiverId": ["",""],
  //接收组ID|名字
  "ReceiverGroup": ["组1"],
  //消息类型
  "MessageType": 4
}

指令说明

MessageType:

public enum enmMsgType
{
    /// <summary>
    /// 文本
    /// </summary>
    text=0,
    
    /// <summary>
    /// 图片
    /// </summary>
    image=1,
    
    /// <summary>
    /// 文件地址
    /// </summary>
    fileurl=2,
    
    /// <summary>
    /// 链接分享
    /// </summary>
    shareurl=3,
    
    /// <summary>
    /// 加入群组
    /// Message=群组名称
    /// </summary>
    joingroup=4,
    
    /// <summary>
    /// 离开群组
    /// </summary>
    leavegroup=5,
    
    /// <summary>
    /// 查看我的群组
    /// </summary>
    mygroup=6,
}

websocket接入

ws://192.168.1.1/wspath?token=id