环信即时通讯 IM 快速开始

大约 7 分钟

环信即时通讯 IM 快速开始

本文介绍如何快速集成环信即时通讯 IM Unity SDK 实现发送和接收单聊文本消息。

技术原理

下图展示在客户端发送和接收单聊文本消息的工作流程。

如上图所示，发送和接收单聊消息的步骤如下：

客户端向你的应用服务器请求 Token，你的应用服务器返回 Token。
客户端 A 和客户端 B 使用获得的 Token 登录环信即时通讯系统。
客户端 A 发送消息到环信即时通讯服务器。
环信即时通讯服务器将消息发送到客户端 B，客户端 B 接收消息。

前提条件

开始前，请确保你的开发环境满足以下条件：

Unity Editor 2019.4.28 或以上版本
Unity SDK 1.0.5 或以上
操作系统与编译器要求：

开发平台	操作系统版本	编译器版本
Android	Android 5.0 或以上	Android Studio 3.0 或以上
iOS	iOS 10 或以上	Xcode 建议最新版本
macOS	macOS 10.0 或以上	Xcode 9.0 或以上，Visual Studio for Mac 2019 或以上
Windows	Windows 10 或以上	Microsoft Visual Studio 2019 或以上

有效的环信即时通讯 IM 开发者账号和 App Key，见环信控制台open in new window。
如果你的网络环境部署了防火墙，请联系环信技术支持设置白名单。

项目设置

实现发送和接收单聊文本消息之前，参考以下步骤设置你的项目。

1. 下载并设置 Unity Demo 项目

参考以下步骤：

克隆 chat_unity_demoopen in new window 至本地。
打开 Unity Hub，选择 Projects 页签，点击 Open 右边的下拉菜单，选择 Add project from disk，然后选择步骤 1 中本地路径下的 chat_unity_quickstart。这时，Projects 列表中显示 chat_unity_quickstart 项目。
单击 chat_unity_quickstart 打开项目。
如果正常打开，该流程结束。

提示

如果 Demo 项目与本地 Unity Editor 版本不一致，你需要进行以下操作：

在弹出的 Editor version not installed 提示框下方，选择 Choose another Editor version。
在弹出的 Select Editor version and platform 窗口中，选择本地安装的 Editor 版本，并根据后续提示打开项目。

提示

如果碰到'SpriteRenderer' does not contain a definition for 'IsUsingDeformableBuffer'这类异常，需要进行重置操作。在Help菜单下，点击Reset Packages to defaults将包恢复默认设置。

2. 集成环信即时通讯 SDK

你可以参考以下步骤集成 SDK：

下载 Unity SDKopen in new window。
在 Unity Editor 中，选择 Assets > Import Package > Custom Package...，然后选择刚下载的 unitypackage 导入。
在弹出的 Import Unity Package 页面，点击右下角的 Import。

集成问题

由于 Crash 上报使用了 libaosl.dll 库，如果同时集成了 Unity Chat SDK 和 AgoraRtcEngine，会有 AOSL 库冲突的问题，在 Unity Editor 中会看到：

Multiple plugins with the same name 'libaosl' (found at 'Assets/Plugins/Agora/Agora-RTC-Plugin/Agora-Unity-RTC-SDK/Plugins/x86_64/libaosl.dll' and 'Assets/Plugins/Agora/AgoraChat/Plugins/x64/libaosl.dll'). That means one or more plugins are set to be compatible with Editor. Only one plugin at the time can be used by Editor

要修复该问题，直接移除 Assets/Plugins/Agora/AgoraChat/Plugins/x64 下的 libaosl.dll 即可。

如欲了解详情，请参见声网官网文档open in new window。

实现发送和接收单聊消息

本节介绍如何使用即时通讯 SDK 在你的 unity 项目中实现发送和接收单聊消息。

1. 打开代码文件进行编辑

在 Unity Editor 中左侧导航栏下方，选择 Project 页签，然后选择 Assets 目录下的 Scripts 目录，双击 TestCode.cs 文件打开 Visual Studio。

提示

如果双击 TestCode.cs 文件无法打开 Visual Studio 开发环境，需将 Visual Studio 配置为 Unity 的外部工具：点击左上角的 Unity 菜单（Windows 为 Edit，Mac 为 Unity），依次选择 Preference > External Tools > External Script Editor，将脚本编辑器设置为 Visual Studio。

以下代码编辑操作均在 Visual Studio 中进行。

2. 添加命名空间

在 TestCode.cs 头部添加以下命名空间：

using AgoraChat;
using AgoraChat.MessageBody;

3. 初始化 SDK

在 InitSDK 方法中添加以下代码完成 SDK 初始化：

var options = new Options("appkey"); //将该参数设置为你的 App Key
SDKClient.Instance.InitWithOptions(options);

4. 创建账号

在环信控制台open in new window 创建用户，获取用户 ID 和用户 token。详见创建用户文档。

在生产环境中，为了安全考虑，你需要在你的应用服务器集成获取 App Token API 和获取用户 Token API 实现获取 Token 的业务逻辑，使你的用户从你的应用服务器获取 Token。

5. 登录账号

在 SignInAction 方法尾部添加以下代码，使用账号登录即时通讯系统，示例代码如下：

SDKClient.Instance.Login(username: Username.text, pwdOrToken: Password.text, callback: new CallBack(
  onSuccess: () => {
    AddLogToLogText("sign in sdk succeed");
  },
  onError:(code, desc) => {
    AddLogToLogText($"sign in sdk failed, code: {code}, desc: {desc}");
  }
));

// 说明：自 1.3.0 版本之后，建议使用 LoginWithToken 替代 Login。Password.text 中的内容需要由输入密码改为输入token
SDKClient.Instance.LoginWithToken(username: Username.text, pwdOrToken: Password.text, callback: new CallBack(
    onSuccess: () =>
    {
         AddLogToLogText("sign in sdk succeed");
    },

    onError: (code, desc) =>
    {
        AddLogToLogText($"sign in sdk failed, code: {code}, desc: {desc}");
    }
));

6. 登出账号

在 SignOutAction 方法尾部添加以下代码，登出即时通讯系统，示例代码如下：

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}");
  }
));

7.发送一条文本消息

在 SendMessageAction 方法尾部添加以下代码，创建和发送一条文本消息，示例代码如下：

Message msg = Message.CreateTextSendMessage(SignChatId.text, MessageContent.text);
SDKClient.Instance.ChatManager.SendMessage(ref msg, new CallBack(
  onSuccess: () => {
    AddLogToLogText($"send message succeed, receiver: {SignChatId.text},  message: {MessageContent.text}");
  },
  onError:(code, desc) => {
    AddLogToLogText($"send message failed, code: {code}, desc: {desc}");
  }
));

8.接收消息

接收消息需要对象继承 IChatManagerDelegate 并实现相关的回调方法，同时将对象加入到监听列表中。

示例代码如下：

在类声明的头部继承 IChatManagerDelegate 对象。

public class TestCode : MonoBehaviour, IChatManagerDelegate

在 TestCode 类内部添加以下回调方法。

由于这里只测试消息接收回调，所以其他回调暂时无需实现，保留空函数即可。

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)
        {
            ImageBody imageBody = msg.Body as ImageBody;
            AddLogToLogText($"received image message, from: {msg.From}");
        }
        else if (msg.Body.Type == MessageBodyType.VIDEO) {
            VideoBody videoBody = msg.Body as VideoBody;
            AddLogToLogText($"received video message, from: {msg.From}");
        }
        else if (msg.Body.Type == MessageBodyType.VOICE)
        {
            VoiceBody voiceBody = msg.Body as VoiceBody;
            AddLogToLogText($"received voice message, from: {msg.From}");
        }
        else if (msg.Body.Type == MessageBodyType.LOCATION)
        {
            LocationBody localBody = msg.Body as LocationBody;
            AddLogToLogText($"received location message, from: {msg.From}");
        }
        else if (msg.Body.Type == MessageBodyType.FILE)
        {
            FileBody fileBody = 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<RecallMessageInfo> recallMessagesInfo)
{

}

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)
{
}

public void OnMessageContentChanged(Message msg, string operatorId, long operationTime)
{
}
// added in 1.3.0
public void OnMessagePinChanged(string messageId, string conversationId, bool isPinned, string operatorId, long operationTime)
{
}

在 AddChatDelegate 方法中添加以下代码，将 TestCode 对象实例加入监听列表。

SDKClient.Instance.ChatManager.AddChatManagerDelegate(this);

在 RemoveChatDelegate 方法中添加以下代码，在对象释放时将其在监听列表中移除。

SDKClient.Instance.ChatManager.RemoveChatManagerDelegate(this);

运行和测试项目

在 Unity Editor 的左侧导航栏下方，点击 Project 页签，选择 Assets 下的 Scenes 目录，双击右侧的 SampleScene 场景，然后点击 Unity Editor 上方的 Play 按钮运行场景。

提示

若未安装 iOS Build Support，运行项目前，将 Assets/ChatSDK/Scripts/Editor 路径下的 iOSBuildSetting.cs 文件移除项目文件夹。

注册用户：在 user id 文本框中输入用户 ID，在 password 文本框中输入密码，点击 Sign up 进行用户注册。注册结果会在下方显示。可创建两个用户，例如 quickstart_sender 和 quickstart_receiver，分别用于发送和接收消息。
用户登录：在 user id 文本框中输入用户 ID，例如 quickstart_sender，在 password 文本框中输入密码，点击 Sign in 进行登录。登录结果会在下方显示。
发送消息：在 single chat id 文本框中输入消息接收方的用户 ID，例如 quickstart_receiver，在 message content 文本框中输入要发送的文本内容，如 how are you.，点击 Send 发送消息，消息发送结果会在下方显示。
退出登录：直接点击 Sign out 退出登录，退出结果会在下方显示。
接收消息：在 user id 文本框中输入接收消息的用户 ID，例如 quickstart_receiver，在 password 文本框输入密码，点击 Sign in 进行登录。登录成功后，下方会显示收到的消息，例如步骤 3 中发送的 ''how are you.''。

环信即时通讯 IM 快速开始

# 环信即时通讯 IM 快速开始

# 技术原理

# 前提条件

# 项目设置

# 1. 下载并设置 Unity Demo 项目

# 2. 集成环信即时通讯 SDK

# 集成问题

# 实现发送和接收单聊消息

# 1. 打开代码文件进行编辑

# 2. 添加命名空间

# 3. 初始化 SDK

# 4. 创建账号

# 5. 登录账号

# 6. 登出账号

# 7.发送一条文本消息

# 8.接收消息

# 运行和测试项目

环信即时通讯 IM 快速开始

技术原理

前提条件

项目设置

1. 下载并设置 Unity Demo 项目

2. 集成环信即时通讯 SDK

集成问题

实现发送和接收单聊消息

1. 打开代码文件进行编辑

2. 添加命名空间

3. 初始化 SDK

4. 创建账号

5. 登录账号

6. 登出账号

7.发送一条文本消息

8.接收消息

运行和测试项目