千呼萬喚始出來!速云IM終于上線啦!
可能很多人會(huì)問什么是速云IM呢聚请?點(diǎn)擊https://zine.la/article/eb52236cfff941629cc5e50acf62ceba/即可了解
了解速云IM后馏段,快速接入指南帶你更進(jìn)一步走入速云IM;
萬變不離其宗湃望,接入速云IM第一步——獲取插件换衬;
在nuget官網(wǎng)上搜索SpeedIM,并安裝插件到您的項(xiàng)目當(dāng)中证芭,網(wǎng)址如下:https://www.nuget.org/packages/SpeedIM/
安裝完以后就可以進(jìn)行第二步——初始化速云IM的配置瞳浦,在現(xiàn)有的系統(tǒng)登錄代碼執(zhí)行成功后/或主窗體打開時(shí),執(zhí)行以下代碼
//引入命名空間,用于支持?jǐn)U展函數(shù)
using SpeedIM;
//登錄完成后废士,啟動(dòng)im服務(wù)
SpeedIM.TIM.IM im = new SpeedIM.TIM.IM(); //構(gòu)建im實(shí)例
im.AppKey = "***"; //請?zhí)钊霃尿v訊im獲取到的AppKey
im.SDKAppID = ***; //請?zhí)钊霃尿v訊im獲取到的SDKAppID
im.Administrator = "administrator"; //用于配置管理員賬號,獲取所有用戶信息時(shí),需要用到該屬性
im.Users = new List<string> { "user1", "user2", "user4", "..." }; //此處需要填入系統(tǒng)中所有的用戶,用于獲取聯(lián)系人列表
im.UserID = "kiki"; //當(dāng)前的登錄用戶,建議直接使用你系統(tǒng)的登錄賬號
im.Run(); //啟動(dòng)im服務(wù)
接下來進(jìn)行第三步——適當(dāng)公開IM的入口
1叫潦、在任務(wù)欄中放置一個(gè)通知圖標(biāo),類似微信官硝、QQ的效果矗蕊。收到消息時(shí),圖標(biāo)會(huì)閃爍氢架。
2傻咖、在你的系統(tǒng)中內(nèi)置一個(gè)通知的控件,通過控件文本岖研、顏色變化卿操、閃爍提示用戶。
3孙援、看各位自行發(fā)揮...
速云IM接入大概就是這些過程害淤,是不是很簡單呢,以下是我們?yōu)榭蛻籼峁┑年P(guān)于更多速云IM相關(guān)描述:
一拓售、如何在任務(wù)中放置一個(gè)通知圖標(biāo)筝家?
在啟動(dòng)IM時(shí)添加以下代碼
System.Drawing.Icon icon = ...; // 通知的圖標(biāo)
im.ShowNotification(icon); // 在任務(wù)欄顯示通知圖標(biāo)
//或
System.Drawing.Icon icon = ...; // 通知的圖標(biāo)
string text = "my app"; // 通知圖標(biāo)的文本描述
im.ShowNotification(icon, text); // 在任務(wù)欄顯示通知圖標(biāo)
二、模板的點(diǎn)擊事件邻辉,我要怎么接收溪王?
在啟動(dòng)IM時(shí)添加以下代碼
im.RegisterWeiXinItemClick((command) =>
{
// 此處的command參數(shù),是消息體傳過來的參數(shù)值骇,可以根據(jù)這個(gè)參數(shù)來判定用戶的行為莹菱。
});
三、如何使用代碼發(fā)送消息吱瘩?
這要看你發(fā)消息的主體道伟,
如果給用戶發(fā)消息,第二個(gè)參數(shù)填入SpeedIM.Foundation.ConversationType.C2C。
如果給群組發(fā)消息蜜徽,第二個(gè)參數(shù)填入SpeedIM.Foundation.ConversationType.Group祝懂。
以下示例只介紹給用戶發(fā)消息的例子,可根據(jù)需求自行替換拘鞋。
// 發(fā)送文本消息
SpeedIM.Host.Instance.SendMsg("user id", SpeedIM.Foundation.ConversationType.C2C, "您需要發(fā)送的文本內(nèi)容");
// 發(fā)送圖像消息
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);
}
// 發(fā)送文件消息
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);
}
// 發(fā)送圖文消息
var msg = new ImageNotificationTemplate();
msg.Uri = "http://5b0988e595225.cdn.sohucs.com/images/20190711/b0723e5990fb4cdb876562972ab54ded.jpeg"; //圖片的uri地址
msg.Text = "暑假來啦砚蓬,針對線下途徑學(xué)生招生的工作要抓緊進(jìn)行。"; // 通知消息的文本描述
msg.Command = "傳入的參數(shù)"; //點(diǎn)擊消息時(shí)盆色,用于接收的參數(shù)值灰蛙。
msg.CommandText = "了解詳情"; // 消息的命令文本
SpeedIM.Host.Instance.SendTemplate("user id", SpeedIM.Foundation.ConversationType.C2C, msg);
// 發(fā)送類微信通知消息
var msg = new SpeedIM.WinUI.WeiXinTemplate();
msg.Title = "訂單創(chuàng)建提醒"; // 模板標(biāo)題
//模板的鍵值對
msg.Data["訂單編號"] = "DD20041199";
msg.Data["客戶名稱"] = "xxx有限公司";
msg.Data["訂單金額"] = "20,000";
msg.Remark = "麻煩盡快審批呀!!!"; //備注消息
msg.Command = new Newtonsoft.Json.Linq.JObject() { ["model"] = "order", ["primaryID"] = msg.Data["訂單編號"] }; //點(diǎn)擊消息時(shí),用于接收的參數(shù)值(根據(jù)需要隔躲,自行組織參數(shù))摩梧。
msg.CommandText = "查看訂單"; // 消息的命令文本
SpeedIM.Host.Instance.SendTemplate("user id", SpeedIM.Foundation.ConversationType.C2C, msg);
四、如何通過代碼打開聊天窗口宣旱?
im.Show();
// 或
SpeedIM.Host.Show();
五仅父、如何通過代碼隱藏聊天窗口?
im.Hide();
// 或
SpeedIM.Host.Hide();
以上就是速云相關(guān)介紹啦浑吟,接入速云IM笙纤,辦公更快捷!更多速云IM相關(guān)信息可關(guān)注后續(xù)更新买置。