Qt+腾讯IM开发笔记（一）：腾讯IM介绍、使用和Qt集成腾讯IM-SDK的工程模板Demo

前言

  开发一个支持全国的IM聊天，可以有基本的功能，发送文本、图片、文件等等相关内容。

 

腾讯IM产品

概述

  腾讯即时通信IM是腾讯推出的即时聊天程序，当前时间为2020年3月（腾讯IM的优惠活动和售卖方案不同时期会有变化）。
  该IM提供各端接入接口、稳定必达、覆盖全球的即时通信云服务上。

应用场景

  包括但不限于以下场景：
  
  

特点

消息传输

  支持文字、图片、短语音、短视频等富媒体消息及自定义消息与自定义表情，支持保存历史漫游消息，集成消息撤回、消息转发、安全打击等扩展能力，构建稳定、便捷的消息传输通道。
  

会话管理

  集成 TUIKit 组件，轻松实现添加会话、会话置顶、会话列表展示，未读消息计数，历史漫游消息展示等功能。
  

群组管理

  支持群成员管理、群组自定义字段、群资料与群公告变更与展示、群组置顶等能力，提供私有群、公开群、聊天室、音视频聊天室等多种群组类型，满足个性化群组需要。
  

资料管理

  支持设置用户资料、更改头像，可配置好友关系，提供好友验证选项，适配您的业务场景。
  

旗舰版和专业版功能对比

  即时通信 IM 套餐包分为体验版、专业版和旗舰版，创建应用后默认为体验版（免费），您可以根据实际业务需求选择不同的套餐包。
  

构架

  即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、帐号鉴权等全方位解决方案，并提供完备的 App 接入、后台管理接口。
  

费用

  从2018年9月14日之后，注册sdkappid的客户都需要购买预付费吧，999，之前的不用，意味着，你想自己做Demo先出999吧，如下图：
  

 

使用腾讯IM准备

  产品简介： https://cloud.tencent.com/document/product/269/1498
  价格说明： https://cloud.tencent.com/document/product/269/11673
  应用场景： https://cloud.tencent.com/document/product/269/32579
  Demo 体验： https://cloud.tencent.com/document/product/269/36852
  接入SDK：https://cloud.tencent.com/document/product/269/37176

腾讯IM服务的SDKAppID和秘钥

  

腾讯开发文档

  https://cloud.tencent.com/document/product/269/37176
  下载SDK

IM SDK基本概念

会话

  会话（Conversation）分为两种：

• 一种是 C2C 会话，表示单聊情况自己与对方建立的对话，读取消息和发送消息都是通过会话完成；
• 一种是群会话，表示群聊情况下，群内成员组成的会话，群会话内发送消息群成员都可接收到。如下图所示，一个会话表示与一个好友的对话；
    

消息

  IM SDK 中消息(Message)表示要发送给对方的内容，消息包括若干属性，如是否自己已读，是否已经发送成功，发送人帐号，消息产生时间等；一条消息由若干Elem组合而成，每种Elem可以是文本、图片、表情等等，消息支持多种 Elem组合发送。
  

群组ID

  群组 ID 唯一标识一个群，由后台生成，创建群组时返回。

IM SDK使用说明

  
  

IM SDK接口

  文档地址：https://cloud.tencent.com/document/product/269/33543
  如果接口的参数字符串包含中文，请使用 UTF-8 编码。

事件回调接口

  

IM SDK 初始化相关接口

  

登录登出相关接口

  

会话相关接口

  

消息相关接口

  

群组相关接口

  

用户资料相关接口

  

关系链相关接口

  

 

模块化

  

Demo关键代码

tencentIMManager.pri

# ImSDK
INCLUDEPATH += $$PWD/ImSDK/includes
HEADERS += \
    $$PWD/ImSDK/includes/TIMCloud.h \
    $$PWD/ImSDK/includes/TIMCloudCallback.h \
    $$PWD/ImSDK/includes/TIMCloudComm.h \
    $$PWD/ImSDK/includes/TIMCloudDef.h

LIBS += -L$$PWD/ImSDK/lib/Win32/Release \
        -limsdk

 

工程模板V1.0.0

  对应该模块的的V1.0.0

 

入坑

入坑一：登录鉴权的问题

问题

  登陆时，回调错误70003
  

原因

  每次登录，需要输入userId和UserSig，UserSig为依赖userId生成的，两者和二唯一被认为是唯一可靠的认证，才可以登录。

解决方法

  本地生成userSig，做大型聊天防止破解等提高安全性，则可以让后台向腾讯生成userSig，以保证可靠。
  
  将两文件，融入到代码中。

入坑二：编译权鉴获取时缺库“bcrypt”

问题

  

解决

  
  Qt的环境自带了，库文件添加进去

入坑三：编译鉴权获取时缺库“zlib”

问题

  

原因

  缺少zlib库，需要自己编译

解决

  笔者之前曾经编译过，直接赋值拿过来即可，读者编译请参照博文：《zlib开发笔记（一）：zlib库介绍、编译和工程模板》
  添加头文件路径和库

入坑四：登陆时报错70003

问题

  

原因

  中文的userId。

解决

  只能使用英文数字id，不能使用中文。

入坑五：登陆时报错70003

问题

  

原因

  

解决

  使用std::string
  

 

若该文为原创文章，转载请注明原文出处
本文章博客地址：https://hpzwl.blog.csdn.net/article/details/119305601