Files
TIMSDK/HarmonyOS
2025-01-17 14:02:46 +08:00
..
2025-01-17 14:02:46 +08:00
2025-01-16 16:43:37 +08:00
2024-11-26 20:07:39 +08:00

IM Demo(HarmonyOS)

本文主要介绍如何快速运行腾讯云即时通信 IM Demo(HarmonyOS)。

如果您需要更详细的运行指南,请 查看完整的运行文档。

环境要求

  • DevEco Studio 5.0.0 及以上

  • HarmonyOS SDK API 12 及以上

操作步骤

步骤 1:创建应用

  1. 登录 即时通信 IM 控制台。

    说明

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

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

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

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

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

    注意

    密钥信息为敏感信息,为防止他人盗用,请妥善保管,谨防泄露。

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

  1. 下载即时通信 IM Demo 工程,具体下载地址请参见 SDK 下载。

    说明

    为尊重表情设计版权,下载的 Demo 工程中不包含大表情元素切图,您可以使用自己本地表情包来配置代码。未授权使用 IM Demo 中的表情包可能会构成设计侵权。

  2. 打开所属终端目录的工程,找到对应的 GenerateTestUserSig.ts 文件(路径:TIMSDK/HarmonyOS/Demo/entry/src/main/ets/tools/GenerateTestUserSig.ts)。

  3. 设置 GenerateTestUserSig.ts 文件中的相关参数:

  • SDKAPPID:请设置为 步骤 1 中获取的实际应用 SDKAppID。

  • SECRETKEY:请设置为 步骤 2 中获取的实际密钥信息。

    注意

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

步骤 4:编译运行

  1. 打开 imdemo(路径:TIMSDK/HarmonyOS/Demo),配置签名:

  2. 连接真机,编译运行:

步骤 5(可选):开通内容审核功能

在消息发送、资料修改场景中,很有可能会扩散不合适的内容,特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容,不仅严重损害了用户们的身心健康,更很有可能违法并导致业务被监管部门查封。

即时通信 IM 支持内容审核(反垃圾信息)功能,可针对不安全、不适宜的内容进行自动识别、处理,为您的产品体验和业务安全保驾护航。可以通过以下两种内容审核方式来实现:

  • 本地审核功能:在客户端本地检测在单聊、群聊、资料场景中由即时通信 SDK 发送的文本内容,支持对已配置的敏感词进行拦截或者替换处理。此功能通过在 IM 控制台开启服务并配置词库的方式实现。

  • 云端审核功能:在服务端检测由单聊、群聊、资料场景中产生的文本、图片、音频、视频内容,支持针对不同场景的不同内容分别配置审核策略,并对识别出的不安全内容进行拦截。此功能已提供默认预设拦截词库和审核场景,只需在 IM 控制台打开功能开关,即可直接使用。

交流与反馈

点此进入 IM 社群,享有专业工程师的支持,解决您的难题。

相关链接