Chat
专为以下场景打造:UNREAL ENGINE
Unreal Engine
Chat SDK
使用 Tencent RTC Unreal Chat SDK 添加团队消息功能。将 C++ 消息 API 接入 Unreal Engine 游戏中的小队和公会界面。
开发者资源
Unreal Engine Chat SDK 文档与示例
UNREAL ENGINE 聊天功能
为您的产品构建消息通信基础
单聊对话
- 一对一消息
- 您自己的界面
群组消息
- 共享会话
- 成员管理 API
富消息
- 文本与媒体
- 自定义应用内容
会话状态
- 历史记录和未读数量
- 您的应用存储
用户身份
- 您自己的用户 ID
- UserSig 身份验证
应用集成
- Unreal Engine APIs
- 平台特定的生命周期
探索 Unreal Engine Chat APIs
从连接您的应用所需的 API 开始。
初始化
连接您的 C++ 项目
完成模块和库设置后,初始化原生 SDK。
阅读文档ChatSession.cpp
#include "V2TIMManager.h"
V2TIMSDKConfig config;
auto* chat = V2TIMManager::GetInstance();
chat->InitSDK(sdkAppID, config);消息
连接两名玩家
登录后发送一条单聊消息。在发送完成之前,请保持发送回调有效。
阅读文档ChatSession.cpp
auto* chat = V2TIMManager::GetInstance();
// sendCallback implements V2TIMSendCallback.
V2TIMString messageID = chat->SendC2CTextMessage(
"Ready at the checkpoint.",
recipientID,
&sendCallback
);生命周期
清晰显示连接状态
只要 SDK 监听器仍处于注册状态,就必须保留它。
阅读文档ChatSession.cpp
auto* chat = V2TIMManager::GetInstance();
chat->AddSDKListener(&sdkListener);
// Before releasing the listener:
chat->RemoveSDKListener(&sdkListener);开始使用
你的第一次对话从这里开始
- 01
- 02
- 03
Unreal Engine Chat SDK
Build.cs
// Build.cs — after adding TIMSDK to your module
PublicIncludePaths.Add(
Path.Combine(ModuleDirectory, "TIMSDK", "include")
);ChatSession.cpp
#include "V2TIMManager.h"
V2TIMSDKConfig config;
auto* chat = V2TIMManager::GetInstance();
chat->InitSDK(sdkAppID, config);Unreal Engine Chat SDK 常见问题
仅凭 Build.cs 代码片段足以集成 Unreal Chat 吗?
不是。它仅展示了 include-path 步骤。请按照完整指南添加 SDK 源文件、链接每个目标的原生库并配置打包。使用不同的玩家账号测试打包后的游戏。
Unreal Engine Chat SDK 是否包含开箱即用的 UI?
SDK 提供消息 API 和事件。聊天界面由你的应用构建。插图展示了可能的应用体验。
如何对 Unreal Engine Chat SDK 的用户进行身份验证?
在后端生成生产环境 UserSig。将其传递给客户端用于身份验证,并将应用密钥保留在服务器上。
这些 Unreal Engine 代码片段能否构成一个完整的应用?
这些内容展示的是各个集成步骤。请按照完整指南完成导入、初始化、登录、错误处理和目标平台专属配置。发布前,请使用不同账户测试消息功能。
Unreal Engine Chat SDK 的使用量如何计费?
托管 Chat 服务的用量取决于您选择的套餐。请查看适用于您应用的内含功能和额度;可选插件和 Call 服务可能有单独的要求。
如何将 Unreal Engine 聊天 SDK 集成到 Unreal Engine 项目中?
接入文档指定的 Unreal 包和 C++ API。连接玩家身份,在游戏生命周期中处理回调和清理;测试打包后的目标程序。
发布应用前如何测试 Unreal Engine 聊天 SDK?
检查登录、SDK 就绪、发送与接收事件,以及重连后的消息状态。
如何定制 Unreal Engine 聊天 SDK 的界面?
围绕文档中的 SDK 事件构建自己的会话列表、消息渲染和输入编辑器。

