Unity

最近更新时间:2025-11-24 09:41:12

我的收藏
本文主要介绍如何快速地将腾讯云即时通信 IM SDK 集成到您的项目中。

环境要求

环境
版本
Unity
2019.4.15f1 及以上版本。
Android
Android Studio 3.5及以上版本,App 要求 Android 4.1及以上版本设备。
iOS
Xcode 11.0及以上版本,请确保您的项目已设置有效的开发者签名。
支持的平台:
平台
IM SDK
iOS
支持
Android
支持
macOS
支持
Windows
支持
Web
支持,1.8.1+版本起
说明:
Web 平台需要简单的几步额外引入,详情请查看本文 WebGL 支持

集成步骤

1. 通过 Unity,创建一个 Unity 项目,并记住项目所在的位置。

您也可以打开一个已有 Unity 项目。
2. 通过 IDE(例如:Visual Studio Code)打开项目:

3. 根据目录,找到 Packages/manifest.json,并修改依赖如下:
{
"dependencies":{
"com.tencent.imsdk.unity":"https://github.com/TencentCloud/chat-sdk-unity.git#unity"
}
}
4. 加载依赖,在 Unity Editor 中打开项目,等待依赖加载完毕,确认Tencent Cloud IM 已经加载完成。

为帮助您更好的理解 IM SDK 的各 API,我们还提供了 API Example,演示各 API 的调用及监听的触发。

WebGL 支持

Tencent Cloud IM SDK (Unity 版本) 自 1.8.1 版本起支持构建 WebGL。相比 Android 和 iOS 端,需要一些额外步骤:
1. 在 WebGL 项目构建产物的文件夹下,执行如下几条命令:
// 快速初始化 npm
npm init -y

// 通过 npm 下载 @tencentcloud/chat SDK
npm install @tencentcloud/chat --save

// 通过 npm 下载 tim-upload-plugin Plugin
npm install tim-upload-plugin --save
2. 打开 index.html ,引入下面四个 JS 文件。如下:
<script src="./node_modules/@tencentcloud/chat/index.js"></script>
<script src="./node_modules/@tencentcloud/chat/modules/group-module.js"></script>
<script src="./node_modules/@tencentcloud/chat/modules/relationship-module.js"></script>
<script src="./node_modules/@tencentcloud/chat/modules/signaling-module.js"></script>
<script src="./node_modules/tim-upload-plugin/index.js"></script>

可选操作:开通内容审核功能

在消息发送、资料修改场景中,很有可能会传播不合适的内容,特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容,不仅严重损害了用户的身心健康,更很有可能违法并导致业务被监管部门查封。
即时通信 IM 支持内容审核(反垃圾信息)功能,可针对不安全、不适宜的内容进行自动识别、处理,为您的产品体验和业务安全保驾护航。可以通过 云端审核 方式来实现。