美文网首页
速云IM 接入指南

速云IM 接入指南

作者: peyne | 来源:发表于2020-04-11 13:45 被阅读0次

    千呼万唤始出来!速云IM终于上线啦!
    可能很多人会问什么是速云IM呢?点击https://zine.la/article/eb52236cfff941629cc5e50acf62ceba/即可了解
    了解速云IM后,快速接入指南带你更进一步走入速云IM;
    万变不离其宗,接入速云IM第一步——获取插件;
    在nuget官网上搜索SpeedIM,并安装插件到您的项目当中,网址如下:https://www.nuget.org/packages/SpeedIM/
    安装完以后就可以进行第二步——初始化速云IM的配置,在现有的系统登录代码执行成功后/或主窗体打开时,执行以下代码

    //引入命名空间,用于支持扩展函数
    using SpeedIM;
    
    //登录完成后,启动im服务
    SpeedIM.TIM.IM im = new SpeedIM.TIM.IM(); //构建im实例
    im.AppKey = "***";  //请填入从腾讯im获取到的AppKey
    im.SDKAppID = ***; //请填入从腾讯im获取到的SDKAppID
    im.Administrator = "administrator"; //用于配置管理员账号,获取所有用户信息时,需要用到该属性
    im.Users = new List<string> { "user1", "user2", "user4", "..." }; //此处需要填入系统中所有的用户,用于获取联系人列表
    im.UserID = "kiki"; //当前的登录用户,建议直接使用你系统的登录账号
    im.Run(); //启动im服务
    

    接下来进行第三步——适当公开IM的入口
    1、在任务栏中放置一个通知图标,类似微信、QQ的效果。收到消息时,图标会闪烁。
    2、在你的系统中内置一个通知的控件,通过控件文本、颜色变化、闪烁提示用户。
    3、看各位自行发挥...

    速云IM接入大概就是这些过程,是不是很简单呢,以下是我们为客户提供的关于更多速云IM相关描述:

    一、如何在任务中放置一个通知图标?

    在启动IM时添加以下代码

    System.Drawing.Icon icon = ...; // 通知的图标
    im.ShowNotification(icon);  // 在任务栏显示通知图标
    
    //或
    
    System.Drawing.Icon icon = ...; // 通知的图标
    string text = "my app"; // 通知图标的文本描述
    im.ShowNotification(icon, text);  // 在任务栏显示通知图标
    

    二、模板的点击事件,我要怎么接收?

    在启动IM时添加以下代码

     im.RegisterWeiXinItemClick((command) =>
    {
        // 此处的command参数,是消息体传过来的参数,可以根据这个参数来判定用户的行为。
    });
    

    三、如何使用代码发送消息?
    这要看你发消息的主体,
    如果给用户发消息,第二个参数填入SpeedIM.Foundation.ConversationType.C2C。
    如果给群组发消息,第二个参数填入SpeedIM.Foundation.ConversationType.Group。
    以下示例只介绍给用户发消息的例子,可根据需求自行替换。

    // 发送文本消息
    SpeedIM.Host.Instance.SendMsg("user id", SpeedIM.Foundation.ConversationType.C2C, "您需要发送的文本内容"); 
    
    
    
    
    
    
    // 发送图像消息
    OpenFileDialog dialog = new OpenFileDialog();
    dialog.Filter = "图像文件|*.bmp;*.jpg;*.jpeg;*.gif;*.png";
    if (dialog.ShowDialog() == DialogResult.OK)
    {
      System.IO.FileInfo info = new System.IO.FileInfo(dialog.FileName);
      if (info.Length == 0)
        MessageBox.Show("不支持0kb大小的图片", "提示", MessageBoxButtons.OK, MessageBoxIcon.Warning);
      SpeedIM.Host.Instance.SendPic("user id", SpeedIM.Foundation.ConversationType.C2C, dialog.FileName);
    }
    
    
    
    
    
    
    
    // 发送文件消息
    OpenFileDialog dialog = new OpenFileDialog();
    dialog.Filter = "文件|*.*";
    if (dialog.ShowDialog() == DialogResult.OK)
    {
      System.IO.FileInfo info = new System.IO.FileInfo(dialog.FileName);
      if (info.Length == 0)
        MessageBox.Show("不支持0kb大小的文件", "提示", MessageBoxButtons.OK, MessageBoxIcon.Warning);
      SpeedIM.Host.Instance.SendFile("user id", SpeedIM.Foundation.ConversationType.C2C, dialog.FileName);
    }
    
    
    
    
    
    
    
    // 发送图文消息
    var msg = new ImageNotificationTemplate();
    msg.Uri = "http://5b0988e595225.cdn.sohucs.com/images/20190711/b0723e5990fb4cdb876562972ab54ded.jpeg"; //图片的uri地址
    msg.Text = "暑假来啦,针对线下途径学生招生的工作要抓紧进行。";  // 通知消息的文本描述
    msg.Command = "传入的参数"; //点击消息时,用于接收的参数值。
    msg.CommandText = "了解详情"; // 消息的命令文本
    SpeedIM.Host.Instance.SendTemplate("user id", SpeedIM.Foundation.ConversationType.C2C, msg);
    
    
    
    
    
    
    
    
    // 发送类微信通知消息
    var msg = new SpeedIM.WinUI.WeiXinTemplate();
    msg.Title = "订单创建提醒";  // 模板标题
    //模板的键值对
    msg.Data["订单编号"] = "DD20041199";
    msg.Data["客户名称"] = "xxx有限公司";
    msg.Data["订单金额"] = "20,000";
    msg.Remark = "麻烦尽快审批呀!!!"; //备注消息
    msg.Command = new Newtonsoft.Json.Linq.JObject() { ["model"] = "order", ["primaryID"] = msg.Data["订单编号"] }; //点击消息时,用于接收的参数值(根据需要,自行组织参数)。
    msg.CommandText = "查看订单"; // 消息的命令文本
    SpeedIM.Host.Instance.SendTemplate("user id", SpeedIM.Foundation.ConversationType.C2C, msg);
    

    四、如何通过代码打开聊天窗口?

    im.Show();
    // 或
    SpeedIM.Host.Show();
    

    五、如何通过代码隐藏聊天窗口?

    im.Hide();
    // 或
    SpeedIM.Host.Hide();
    

    以上就是速云相关介绍啦,接入速云IM,办公更快捷!更多速云IM相关信息可关注后续更新。

    相关文章

      网友评论

          本文标题:速云IM 接入指南

          本文链接:https://www.haomeiwen.com/subject/nwkymhtx.html