本文介绍如何快速集成环信 IM Windows SDK 实现发送和接收单聊文本消息。
下图展示在客户端发送和接收单聊文本消息的工作流程。
如上图所示,发送和接收单聊消息的步骤如下:
开始前,请确保你的开发环境满足以下条件:
实现发送和接收单聊文本消息之前,参考以下步骤设置你的项目。
参考以下步骤:
windows-example.sln
打开 Visual Studio 开发工具;Debug
;解决方案平台为: x64;你可以参考以下步骤集成 SDK:
NuGet
包一般存放在 C:\Users\XXX\Downloads
(XXX
为本机用户名);NuGet
包拷贝到自己的工作目录,比如 D:\workspace\WinSDK
下,以下说明以此目录举例;windows-example
项目,选择 管理 NuGet 程序包 (N)...;NuGet:windows-example
tab 页面里,点击右上角的小齿轮会弹出 NuGet 程序包源的设置窗体,点击窗体右上角的 + 按钮,在 包源 的文本框内会出现 Package source 这一栏,点击选中,并修改文本框下的 名称 和 源。例如 名称 可以设置为 Local Package source
,源 则设置为第 2 步中的目录, D:\workspace\WinSDK
,点击确定;NuGet:windows-example
tab 页面,在右上角的 “程序包源” 处点击下拉菜单,选中刚刚配置的包源名称 Local Package source
;NuGet:windows-example
tab 页面上部,选中 浏览,在下面搜索框的右边,勾选 包括预发行版,此时下面的区域会出现 agora_chat_sdk
(如果没有出现,点击搜索框右侧的刷新按),选中这一栏,右边会出现一个向下的小箭头,点击进行安装,或者点击右侧栏最右边的 安装 按钮;NuGet
包集成完毕。本节介绍如何使用即时通讯 SDK 在你的 Windows .Net
项目中实现发送和接收单聊消息。
在 Visual Studio 的 windows-example
项目下,点击 MainWindow.xaml
左边的小三角,然后双击 MainWindow.xaml.cs
文件开始编辑。
在 MainWindow.xaml.cs
头部添加以下命名空间:
using AgoraChat;
using AgoraChat.MessageBody;
在 InitSDK
函数中添加以下代码完成 SDK 初始化:
var options = new Options("appkey"); //此处填入你的appkey
options.UsingHttpsOnly = true;
SDKClient.Instance.InitWithOptions(options);
在 SignUp_Click
函数尾部添加以下代码,用于创建 AppServer 上的登录账户,示例代码如下:
SDKClient.Instance.CreateAccount(username, password, callback: new CallBack(
onSuccess: () =>
{
AddLogToLogText("sign up succeed");
},
onError: (code, desc) =>
{
AddLogToLogText("sign up failed");
}
));
注意
该注册模式为在客户端注册,主要用于测试,简单方便,但不推荐在正式环境中使用;正式环境中应使用服务器端调用 Restful API 注册,具体见:注册单个用户 (opens new window)。
在 SignIn_Click
函数尾部添加以下代码,用于使用账号登录即时通讯系统,示例代码如下:
SDKClient.Instance.Login(UserIdTextBox.Text, PasswordTextBox.Text, false, callback: new CallBack(
onSuccess: () =>
{
AddLogToLogText("sign in sdk succeed");
},
onError: (code, desc) =>
{
AddLogToLogText($"sign in sdk failed, code: {code}, desc: {desc}");
}
));
在 SignOut_Click
函数尾部添加以下代码,用于登出即时通讯系统,示例代码如下:
SDKClient.Instance.Logout(true, callback: new CallBack(
onSuccess: () =>
{
AddLogToLogText("sign out sdk succeed");
},
onError: (code, desc) =>
{
AddLogToLogText($"sign out sdk failed, code: {code}, desc: {desc}");
}
));
在 SendBtn_Click
函数尾部添加以下代码,可以用于创建一条文本消息,然后发送该消息:
Message msg = Message.CreateTextSendMessage(SingleChatIdTextBox.Text, MessageContentTextBox.Text);
SDKClient.Instance.ChatManager.SendMessage(ref msg, new CallBack(
onSuccess: () =>
{
Dip.Invoke(() =>
{
AddLogToLogText($"send message succeed, receiver: {SingleChatIdTextBox.Text}, message: {MessageContentTextBox.Text}");
});
},
onError: (code, desc) =>
{
AddLogToLogText($"send message failed, code: {code}, desc: {desc}");
}
));
提示
发送一条文本消息示例代码中的,在成功回调函数中,为了使用界面元素,例如:SingleChatIdTextBox.Text;MessageContentTextBox.Text
,需要使用 System.Windows.Threading.Dispatcher
(参见代码中的 Dip
变量)的 Invoke
进行操作。
接收消息需要对象继承 IChatManagerDelegate
并实现相关的回调函数,同时将对象加入到监听列表中。
示例代码如下:
在类声明的头部继承 IChatManagerDelegate
对象。
public partial class MainWindow : Window, IChatManagerDelegate
在 MainWindow
类内部添加以下回调函数。
提示
由于这里只测试消息接收回调,所以其他回调暂时无需实现,保留空函数即可。
public void OnMessagesReceived(List<Message> messages)
{
foreach (Message msg in messages)
{
if (msg.Body.Type == MessageBodyType.TXT)
{
TextBody txtBody = msg.Body as TextBody;
AddLogToLogText($"received text message: {txtBody.Text}, from: {msg.From}");
}
else if (msg.Body.Type == MessageBodyType.IMAGE)
{
_ = msg.Body as ImageBody;
AddLogToLogText($"received image message, from: {msg.From}");
}
else if (msg.Body.Type == MessageBodyType.VIDEO)
{
_ = msg.Body as VideoBody;
AddLogToLogText($"received video message, from: {msg.From}");
}
else if (msg.Body.Type == MessageBodyType.VOICE)
{
_ = msg.Body as VoiceBody;
AddLogToLogText($"received voice message, from: {msg.From}");
}
else if (msg.Body.Type == MessageBodyType.LOCATION)
{
_ = msg.Body as LocationBody;
AddLogToLogText($"received location message, from: {msg.From}");
}
else if (msg.Body.Type == MessageBodyType.FILE)
{
_ = msg.Body as FileBody;
AddLogToLogText($"received file message, from: {msg.From}");
}
}
}
public void OnCmdMessagesReceived(List<Message> messages)
{
}
public void OnMessagesRead(List<Message> messages)
{
}
public void OnMessagesDelivered(List<Message> messages)
{
}
public void OnMessagesRecalled(List<Message> messages)
{
}
public void OnReadAckForGroupMessageUpdated()
{
}
public void OnGroupMessageRead(List<GroupReadAck> list)
{
}
public void OnConversationsUpdate()
{
}
public void OnConversationRead(string from, string to)
{
}
public void MessageReactionDidChange(List<MessageReactionChange> list)
{
}
在 AddChatDelegate
函数中添加以下代码,以将 MainWindow
对象实例加入到监听列表中
SDKClient.Instance.ChatManager.AddChatManagerDelegate(this);
在 RemoveChatDelegate
函数中添加以下代码,以便在关闭窗体时将 MainWindow
对象实例从监听列表中移除
SDKClient.Instance.ChatManager.RemoveChatManagerDelegate(this);
在 Visual Studio 窗体上部,点击 启动 按钮。
user id
文本框中输入用户名,在 password
文本框中输入密码,点击 Sign up
进行用户注册。注册的结果会在下方的方形区域进行显示。这里可以创建两个用户,例如 quickstart_sender
、quickstart_receiver
,一个用来发送消息,一个用来接收消息。user id
文本框中输入用户名,例如输入 quickstart_sender
,在 password
文本框中输入密码,点击 Sign in 进行登录。登录结果会在下方的方形区域进行显示。single chat id
文本框中输入消息接收方,例如输入 quickstart_receiver
,在 message content
文本框中输入想要发送的文本内容,如 how are you.
,点击 Send 进行消息发送,消息发送结果会在下方的方形区域进行显示。user id
文本框中输入接收消息的用户名,例如 quickstart_receiver
, 在 password
文本框输入密码,点击 Sign in
进行登录。登录成功后,下方的方形区域将会显示接收到的消息,例如第 3 步发送的 how are you.
。