专为以下场景打造:UNITY

Unity
Chat SDK

使用 Tencent RTC Unity Chat SDK 连接玩家。在自有游戏界面中构建组队消息和公会对话。

开发者资源

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

个性化定制

您的体验,由您定义。

围绕已连接的会话构建您自己的界面。

打造您自己的体验

将消息事件连接到产品所需的界面和交互。

阅读文档

开始使用

你的第一次对话从这里开始

  1. 01

    创建您的应用

    设置 Chat 应用和测试用户。

    打开 Chat 控制台
  2. 02

    添加 Unity Chat SDK

    按照平台指南连接您的项目。

    按照集成指南操作
  3. 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 事件构建自己的会话列表、消息渲染和输入编辑器。

获取后续步骤所需的支持

构建你的下一次对话体验

使用 Unity Chat SDK 构建你的 game。