tencent cloud

文档反馈

快速集成(QT)

最后更新时间:2022-05-19 10:48:59

    本文主要介绍如何快速地将腾讯云 TRTC SDK(QT 的 Windows 和 Mac 版本)集成到您的项目中,只要按照如下步骤进行配置,就可以快速完成 SDK 的集成工作。

    Windows 端集成

    开发环境要求

    • 操作系统:Windows 7及以上版本。
    • 开发环境:Visual Studio 2015及以上版本,推荐使用 Visual Studio 2015,前提是您已经配置好 VS 相关的 QT 开发环境。
      说明:

      如果您不熟悉配置 VS 相关 QT 开发环境的步骤,请参见 README 中的操作步骤的步骤4相关内容。

    操作步骤

    本节以创建一个简单的 QTTest 项目为例,介绍如何在 Visual Studio 工程中集成 C++ 跨平台SDK。

    1. 下载 C++ 跨平台 SDK
      1. 下载 SDK,解压并打开文件。
      2. 您的 QTTest 同级目录下新建一个空的 SDK 文件夹,将 SDK 中的 TXLiteAVSDKTRTCWin_latest/SDK/CPlusPlus 拷贝到与您 QTTest 工程目录同级目录的 SDK 文件夹下。
    2. 配置 QTTest 工程依赖环境

      打开 QTTest工程目录,使用一款任意文本编辑器(推荐 Sublime Text)打开 QTTest.pro(使用 Qt Creator 创建)文件,然后添加 SDK 相关引用:

      INCLUDEPATH += $$PWD/.
      $$PWD/../SDK/CPlusPlus/Win32/include <br> $$PWD/../SDK/CPlusPlus/Win32/include/TRTC

      DEPENDPATH += $$PWD/.
      $$PWD/../SDK/CPlusPlus/Win32/include <br> $$PWD/../SDK/CPlusPlus/Win32/include/TRTC

      CONFIG += opengl
      CONFIG += debug_and_release

      debug {
      contains(QT_ARCH,i386) {
      LIBS += -L$$PWD/../SDK/CPlusPlus/Win32/lib -lliteav
      } else {
      LIBS += -L$$PWD/../SDK/CPlusPlus/Win64/lib -lliteav
      }
      }

      release {
      contains(QT_ARCH,i386) {
      LIBS += -L$$PWD/../SDK/CPlusPlus/Win32/lib -lliteav
      } else {
      LIBS += -L$$PWD/../SDK/CPlusPlus/Win64/lib -lliteav
      }
      }

    3. 拷贝文件
      • 当使用 QtCreator 打开 QTTest.pro 工程并调试程序时,会自动生成相关的 debug/release 文件夹,您需要将 SDK/CPlusPlus/Win64/lib (如果为32位,则拷贝 SDK/CPlusPlus/Win32/lib )下的所有的 .dll 文件分别拷贝到工程目录下的 debug/release 文件夹下。
      • 当使用VS进行调试时,可以手动将 SDK/CPlusPlus/Win64/lib 下的所有 .dll 文件拷贝到程序的输出运行目录下,也可以在生成事件 > 后期生成事件 > 命令行,添加拷贝命令 copy /Y $(ProjectDir)SDK\CPlusPlus\Win64\lib\*.dll $(OutDir),能够在编译完成后,自动将 SDK 的 .dll 文件拷贝到程序的运行目录下。
        说明:

        如果为32位,则添加拷贝命令为 copy /Y $(ProjectDir)SDK\CPlusPlus\Win32\lib\*.dll $(OutDir)

    4. 引用 TRTC SDK
      • 您可以通过头文件 #include "ITRTCCloud.h" 直接引用。
      • 使用命名空间:C++ 全平台接口的方法、类型等均定义在 trtc 命名空间中,为了让代码更加简洁,建议您直接使用 trtc 命名空间。
    说明:

    至此您的集成工作已经完成,可以编译运行您的项目了。关于更多跨平台 SDK 的 API 使用 Demo,请下载 QTDemo 详细参考。

    Mac 端集成

    开发环境要求

    • 操作系统:Mac10.10及以上版本。
    • 开发环境:Qt Creator 4.10.3及以上版本,推荐使用 Qt Creator 4.13.3及以上。
    • 开发框架:Based on Qt 5.10及以上。

    操作步骤

    本节以从0创建一个简单的 QTTest 项目为例,介绍如何在 Qt Creator 工程中集成 C++ 跨平台 SDK。

    1. 下载 C++ 跨平台 SDK
      1. 下载 SDK,解压并打开文件。
      2. 在您的 QTTest 同级目录下新建一个空的 SDK 文件夹,将 SDK 中的TXLiteAVSDKTRTCMacx.x.x/SDK/TXLiteAVSDKTRTC_Mac.framework 拷贝到与您 QTTest 工程目录同级目录的 SDK 文件夹下。
    2. 配置 QTTest.pro
      打开 QTTest 工程目录,使用一任意文本编辑器打开 QTTest.pro 文件,然后添加 SDK 相关引用:
      INCLUDEPATH += $$PWD/.
      DEPENDPATH += $$PWD/.
      LIBS += "-F$$PWD/base/util/mac/usersig"
      LIBS += "-F$$PWD/../SDK"
      LIBS += -framework TXLiteAVSDK_TRTC_Mac
      LIBS += -framework Accelerate
      LIBS += -framework AudioUnit
      INCLUDEPATH += $$PWD/../SDK/TXLiteAVSDK_TRTC_Mac.framework/Headers/cpp_interface
      INCLUDEPATH += $$PWD/base/util/mac/usersig/include
      DEPENDPATH += $$PWD/base/util/mac/usersig/include
      
    1. 授权摄像头和麦克风使用权限
      因为 SDK 会使用您的摄像头和麦克风,所以您需要在对应的 Info.plist 添加对应的权限申请说明:
      NSMicrophoneUsageDescription : 申请使用麦克风
      NSCameraUsageDescription : 申请使用摄像头
      

    如下图所示:

    1. 引用 TRTC SDK
      • 您可以通过头文件 #include "ITRTCCloud.h" 直接引用。
      • 使用命名空间:C++ 全平台接口的方法、类型等均定义在 trtc 命名空间中,为了让代码更加简洁,建议您直接使用 trtc 命名空间。
    说明:

    至此您的集成工作已经完成,可以编译运行您的项目了。关于更多跨平台 SDK 的 API 使用 Demo,请下载 QTDemo 参考。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持