Android（Compose）
下载
聚焦模式
字号
本文介绍如何快速跑通 Chat Demo 来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示：
登录页 | 会话列表页 | 聊天页 | 音视频通话 |
 |  |  |  |
前提条件
开通服务
1. 登录控制台。如果您已有应用，请记录其
SDKAppID 及 SDKSecretKey 并直接跳转到下一节。2. 在概览面板单击创建按钮，开始创建新应用。
3. 在创建应用弹框中填入应用名称，选择产品为 Chat。
4. 选择完产品后，会显示出部署区域，请按需选择。
5. 创建完成后，可在控制台概览面板查看新建应用的
SDKAppID、SDKSecretKey，后续运行 Demo 时需要用到这两个信息。
禁止：
请妥善保管 SDKSecretKey，谨防泄露！
环境准备
在开始之前，请确保您已满足下列要求：
Android Studio Ladybug（2024.2.1）及之后的版本。
JDK 17。
Android 6.0 及以上真机或模拟器。
一个有效的 Chat 应用。请参考上文 “开通服务” 章节获取或创建。
Demo 工程已内置 Gradle Wrapper（Gradle 8.9），并使用 Android Gradle Plugin 8.6.1 与 Kotlin 2.0.21，首次同步工程时会自动下载，无需手动安装。
版本兼容性说明：
为确保构建环境稳定，请严格遵循官方兼容性要求进行配置：
Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性，请参阅 Android 官方文档：版本说明。
Kotlin、Android Gradle Plugin 与 Gradle 的版本映射关系，请参阅 Kotlin 官方文档：Kotlin-Gradle 插件兼容性。
我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。
操作步骤
获取并配置 Demo
1. 从 GitHub 克隆 TUIKit 开源工程 TUIKit_Android_Compose。
Chat 的 Compose 版 Demo 位于仓库的
chat 目录下，并依赖仓库根目录的 atomic_x 与 call/tuicallkit-kt 组件。demo 已在 settings.gradle.kts 中按相对路径引入 chat/uikit、atomic_x 与 call/tuicallkit-kt 模块，克隆后无需额外配置依赖路径。整体结构如下：TUIKit_Android_Compose/├── atomic_x/ # 基础模块（Chat 依赖）├── call/│ └── tuicallkit-kt/ # 音视频通话组件（Chat 依赖）└── chat/├── demo/ # Chat Compose 版示例工程（在此打开并运行）└── uikit/ # Chat Compose 版 UI 组件库
2. 启动 Android Studio，打开工程中的
chat/demo 目录。3. 找到
GenerateTestUserSig.java 文件（路径：chat/demo/app/src/main/java/io/trtc/tuikit/chat/signature/GenerateTestUserSig.java），设置以下参数：SDKAPPID：请设置为前文 “开通服务” 中获取的实际应用 SDKAppID。SECRETKEY：请设置为前文获取的实际密钥信息。仓库中这两个参数默认留空，填写之前 Demo 无法编译通过。
禁止：
1. 本文的 Demo 示例中通过在客户端代码中配置
SECRETKEY 进行鉴权，但 SECRETKEY 很容易被反编译逆向破解，一旦密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。2. 在正式的生产环境中，建议在您的服务端生成 UserSig，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig 来进行鉴权。详见服务端生成 UserSig。
编译并运行 Demo
在 Android Studio 中打开
chat/demo 目录后，Android Studio 会自动执行 Gradle Sync。如果同步失败，请检查网络连接和 Gradle 配置。说明：
初次导入 Demo 工程会下载较多依赖项，请耐心等待下载和同步完成后再运行。
以运行 Android 设备为例：
1. 将 Android 设备连接至电脑，在 Android 设备上打开开发者模式，启用 USB 调试，并且在 Android 设备上选择 USB 用于传输文件（如有）。
2. 设置 Gradle JDK：
在 Android Studio 的 Settings 界面，导航到 Build, Execution, Deployment > Build Tools > Gradle，
在 Gradle JDK 下拉菜单中选择 JDK 17（如列表中没有，请先下载安装 JDK 17），然后请执行 File > Sync Project with Gradle Files 来验证配置是否正确。
3. 在顶部 Running devices 选择测试设备，点击运行按钮编译并安装运行。
4. 打开 App，输入任意 UserID 即可创建并登录用户账号。
体验基础功能
如果您已经跑通 Demo，可以按照如下步骤体验基础功能。
创建用户账号
首先，您需要创建用户账号。创建账号的方式有很多，例如通过登录 Demo 在客户端注册，或在控制台创建，您可以选择下列任意一种合适的方式。
直接在 Demo 中输入 userID 并登录即可。
步骤如下：
1. 进入 Chat > 账号管理 页面。
2. 点击新建账号，弹出创建账号信息填写框。
3. 如果只是普通成员，选择普通账号即可。我们建议设置昵称。界面上可以通过昵称展示不同用户。
注意：
发消息至少是两个用户之间进行，因此您在此环节至少要创建 2 个账号。请记录下这 2 个账号的 userID，后续步骤会使用到。
添加联系人
点击底部的通讯录切换到联系人界面后：
1. 点击该界面右上角的 +按钮，在子菜单中选择添加好友。
2. 输入有效的 UserID，搜索出用户。如果您已经在控制台上创建了账号，可以去 控制台 > Chat > 账号管理 获取有效的 UserID。
3. 添加用户为联系人。添加成功后，联系人列表会出现刚才的用户：
发送消息
在联系人列表中点击该用户，就可以在消息界面向该用户发送文字、语音、图片等消息了：
常见问题
表情包的使用
为尊重表情设计版权，Chat Demo/TUIKit 工程中不包含大表情元素切图，正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的小黄脸表情包版权归腾讯云所有，您可以通过升级至 Chat 专业版 Plus 和企业版 免费使用该表情包。
联系我们
文档反馈