| 登录页 | 会话列表页 | 聊天页 | 音视频通话 |
| | | | |
一、环境要求
·DevEco Studio 4.0 Release 及以上。
·HarmonyOS SDK API 10 及以上。
二、步骤1：创建应用
1. 登录 即时通信 IM 控制台。
注意：说明：
注意：如果你已有应用，请记录其 SDKAppID 信息， 直接跳转至 步骤2：获取 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 企业版套餐 免费使用该表情包。