Chat
开发者资源
Unity Chat SDK 文档与示例
UNITY 聊天功能
为您的产品构建消息通信基础
单聊对话
- 一对一消息
- 您自己的界面
群组消息
- 共享会话
- 成员管理 API
富消息
- 文本与媒体
- 自定义应用内容
会话状态
- 历史记录和未读数量
- 您的应用存储
用户身份
- 您自己的用户 ID
- UserSig 身份验证
应用集成
- C# 消息 API
- 平台特定的生命周期
探索 Unity Chat APIs
从连接您的应用所需的 API 开始。
初始化
连接游戏客户端
使用持久化本地路径为打包后的游戏初始化 SDK。
阅读文档ChatSession.cs
var config = new SdkConfig {
sdk_config_config_file_path =
Application.persistentDataPath + "/TIM-Config",
sdk_config_log_file_path =
Application.persistentDataPath + "/TIM-Log"
};
TencentIMSDK.Init(sdkAppID, config);登录
关联玩家身份
在打开玩家的对话之前,先验证其身份。
阅读文档ChatSession.cs
TencentIMSDK.Login(userID, userSig,
(int code, string desc, string data, string userData) => {
// Handle the login result.
});消息
让队伍保持交流
向另一位玩家发送准备好的 Message,并处理发送结果。
阅读文档ChatSession.cs
var messageId = new StringBuilder(128);
TencentIMSDK.MsgSendMessage(
recipientID, TIMConvType.kTIMConv_C2C,
message, messageId,
(int code, string desc, string data, string userData) => {
// Update your message state from the result.
});开始使用
你的第一次对话从这里开始
- 01
- 02
- 03
Unity Chat SDK
Packages/manifest.json
{
"dependencies": {
"com.tencent.imsdk.unity":
"https://github.com/TencentCloud/chat-sdk-unity.git#unity"
}
}ChatSession.cs
var config = new SdkConfig {
sdk_config_config_file_path =
Application.persistentDataPath + "/TIM-Config",
sdk_config_log_file_path =
Application.persistentDataPath + "/TIM-Log"
};
TencentIMSDK.Init(sdkAppID, config);Unity Chat SDK 常见问题
Unity SDK 是否包含游戏的聊天 UI?
SDK 提供消息 API。游戏负责控制浮层、输入焦点、玩家权限和队伍成员关系。除了在 Editor 中验证,还应验证打包后的构建;WebGL 还需满足额外的集成要求。
Unity Chat SDK 是否包含开箱即用的 UI?
SDK 提供消息 API 和事件。聊天界面由你的应用构建。插图展示了可能的应用体验。
如何对 Unity Chat SDK 的用户进行身份验证?
在后端生成生产环境 UserSig。将其传递给客户端用于身份验证,并将应用密钥保留在服务器上。
这些 Unity 代码片段能否构成一个完整的应用?
这些内容展示的是各个集成步骤。请按照完整指南完成导入、初始化、登录、错误处理和目标平台专属配置。发布前,请使用不同账户测试消息功能。
Unity Chat SDK 的使用量如何计费?
托管 Chat 服务的用量取决于您选择的套餐。请查看适用于您应用的内含功能和额度;可选插件和 Call 服务可能有单独的要求。
如何将 Unity 聊天 SDK 集成到 Unity 项目中?
使用文档中的 Unity 接入方式,连接玩家身份并在游戏界面渲染消息。测试目标构建和暂停/恢复生命周期,不能仅在编辑器内测试。
发布应用前如何测试 Unity 聊天 SDK?
检查登录、SDK 就绪、发送与接收事件,以及重连后的消息状态。
如何定制 Unity 聊天 SDK 的界面?
围绕文档中的 SDK 事件构建自己的会话列表、消息渲染和输入编辑器。

