帮你快速理解、总结文档立即下载

HarmonyOS

最近更新时间:2026-08-17 15:04:03
我的收藏
本文介绍如何快速跑通 TUIKit Demo(HarmonyOS)来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示:
登录页
会话列表页
聊天页




环境要求

DevEco Studio 4.0 Release 及以上。
HarmonyOS SDK API 10 及以上。

操作步骤

步骤1:创建应用

说明:
如果您已有应用,请记录其 SDKAppID 信息, 直接跳转至 步骤2:获取 SDKAppID 和密钥信息
单个腾讯云账号最多可创建 300 个应用。若已有 300 个应用,您可以先 停用并删除 不再使用的应用后,再创建新的应用。应用删除后,该 SDKAppID 对应的所有数据和服务不可恢复,请谨慎操作。
2. 应用管理页面,单击创建新应用

3. 输入应用名称、选择合适的数据中心,单击确定即可完成应用的创建。


步骤2:获取 SDKAppID 和密钥信息

1. 应用管理页面的 SDKAppID 列获取 SDKAppID 信息。

2. 在操作列单击查看密钥,随后在弹出的对话框中,单击显示密钥,复制显示后的密钥信息。

注意:
查看密钥信息需要验证身份。
密钥信息为敏感信息,为防止他人盗用,请妥善保管,谨防泄露。

步骤3:下载并配置 Demo 源码

1. CNB 或者 GitHub 下载 TUIKit 开源工程。
Chat 的 HarmonyOS 版 Demo 位于仓库的 chat/demo 目录下,并依赖仓库内的 atomic_x(基础 UI 组件库)、chat/uikit(Chat UI 组件库)以及 call(音视频通话组件)。这些模块已在 chat/demo/build-profile.json5 中按相对路径引入,克隆后无需额外配置依赖路径。整体结构如下:
TUIKit_Harmony/
├── atomic_x/ # 基础 UI 组件库(Chat 依赖)
├── call/ # 音视频通话组件(Chat 依赖)
└── chat/
├── demo/ # Chat View 版示例工程(在此打开并运行)
└── uikit/ # Chat View 版 UI 组件库
2. 打开所属终端目录的工程,找到对应的 GenerateTestUserSig.ts 文件(路径:chat/demo/entry/src/main/ets/signature/GenerateTestUserSig.ts)。
3. 设置 GenerateTestUserSig.ts 文件中的相关参数:
SDKAPPID:请设置为 步骤2 中获取的实际应用 SDKAppID。
SECRETKEY:请设置为 步骤2 中获取的实际密钥信息。

禁止:
本文提到的获取 UserSig 的方案是在客户端代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig

步骤4:编译运行

1. 启动 DevEco Studio,打开 chat/demo 目录。
配置签名:在 DevEco Studio 中打开 File > Project Structure > Signing Configs,勾选 Automatically generate signature(自动签名),使用华为账号完成签名配置。

2. 连接真机,编译运行:
将 HarmonyOS 真机连接电脑,开启开发者模式与 USB 调试。在顶部设备列表中选择已连接的测试设备,点击运行按钮编译并安装运行。

步骤5:开通云端审核功能

在消息发送、资料修改等场景中,很有可能会扩散不合适的内容,特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容,不仅严重损害了用户们的身心健康,更很有可能违法并导致业务被监管部门查封。
即时通信 IM 支持 云端审核(反垃圾信息)功能,可针对不安全、不适宜的内容进行自动识别、处理,为您的产品体验和业务安全保驾护航。您可直接前往 云端审核控制台 开通免费试用,规则详见 免费试用说明

常见问题

表情包的使用

为了尊重版权,IM Demo/TUIKit 工程中默认不包含大表情元素切图。在正式上线商用前,请您替换为自己设计或拥有版权的其他表情包。请注意,下图所示的默认小黄脸表情包版权属于腾讯云,您可以通过升级至 IM 企业版套餐 免费使用该表情包。